Activar una rutina mediante la API

Claude Code es la herramienta de codificación agéntica de Anthropic. Claude Code en la web ejecuta sesiones de Claude Code en infraestructura en la nube gestionada por Anthropic en claude.ai/code, y una rutina es una configuración guardada allí: un prompt, uno o más repositorios y conectores, empaquetados para que pueda ejecutarse sin supervisión según un cronograma, en respuesta a eventos de GitHub o cuando se invoca por HTTP.

Este endpoint es el punto de entrada HTTP. Enviar una solicitud POST a él inicia una nueva ejecución de una rutina existente y devuelve el ID y la URL de la sesión resultante. Los llamadores típicos son sistemas de alertas, pipelines de CI y herramientas internas que necesitan iniciar una sesión de Claude Code de forma programática.

Llamar a este endpoint requiere una cuenta de claude.ai en un plan Pro, Max, Team o Enterprise con Claude Code en la web habilitado. Autentícate con un "bearer token" (token de portador) específico de la rutina creado en la interfaz web de Claude Code, en lugar de una clave de API de Claude.



Diferencias con Claude Platform

El endpoint de activación de rutinas pertenece a la superficie del producto Claude Code, que difiere de las API y SDK de Claude Platform en varios aspectos:



Antes de comenzar

Para llamar a este endpoint, necesitas:

1. Una rutina creada en claude.ai/code/routines
2. Un bearer token generado para esa rutina: abre la rutina para editarla, haz clic en Add another trigger debajo de Select a trigger, elige API y luego haz clic en Generate token en el modal. El token se muestra una sola vez y no se puede recuperar después.

Consulta Add an API trigger en la documentación de Claude Code para ver el recorrido completo de configuración.



Activar una rutina

POST https://api.anthropic.com/v1/claude_code/routines/{routine_id}/fire

Cada solicitud debe incluir el encabezado anthropic-beta: experimental-cc-routine-2026-04-01. Las solicitudes sin él devuelven 400 invalid_request_error.

La interfaz web de Claude Code proporciona la URL completa junto con el token cuando agregas un activador de API, por lo que la mayoría de las integraciones almacenan ambos como secretos y llaman al endpoint directamente. Los ejemplos a continuación muestran una llamada desde la shell y un paso de GitHub Actions que activa la rutina ante un fallo de CI.

curl -X POST https://api.anthropic.com/v1/claude_code/routines/$ROUTINE_ID/fire \
  -H "Authorization: Bearer $ROUTINE_TOKEN" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
  -H "Content-Type: application/json" \
  -d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'

- if: failure()
  env:
    ROUTINE_FIRE_URL: ${{ secrets.ROUTINE_FIRE_URL }}
    ROUTINE_FIRE_TOKEN: ${{ secrets.ROUTINE_FIRE_TOKEN }}
  run: |
    curl -X POST "$ROUTINE_FIRE_URL" \
      -H "Authorization: Bearer $ROUTINE_FIRE_TOKEN" \
      -H "anthropic-version: 2023-06-01" \
      -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
      -H "Content-Type: application/json" \
      -d "{\"text\": \"CI failed: $GITHUB_WORKFLOW run $GITHUB_RUN_ID on $GITHUB_REF\"}"

La solicitud retorna una vez que se crea la sesión. No transmite la salida de la sesión mediante streaming ni espera a que la sesión se complete.



Encabezados



Parámetros de ruta



Cuerpo de la solicitud

El cuerpo es opcional. Los campos desconocidos en el cuerpo se ignoran.



Respuesta

Una solicitud exitosa devuelve 200 OK con los detalles de la nueva sesión:

{
  "type": "routine_fire",
  "claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
  "claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}



Errores

Los errores usan el formato de error estándar de Anthropic:

{
  "type": "error",
  "error": {
    "type": "not_found_error",
    "message": "<string>"
  }
}



Autenticación

El bearer token está limitado a una sola rutina. Un token comprometido solo puede activar esa rutina; no otorga acceso de lectura, ni acceso a otras rutinas, ni acceso a los datos de la cuenta.

Genera y revoca tokens desde la configuración del activador de API de la rutina en claude.ai/code/routines. No existe una API pública para la gestión de tokens. Generar un nuevo token revoca el anterior.



Idempotencia

Cada solicitud exitosa crea una nueva sesión. No hay clave de idempotencia. Si un llamador de webhook reintenta, el endpoint crea múltiples sesiones.



Límites de velocidad

Las ejecuciones de rutinas cuentan contra una asignación diaria por cuenta que varía según el plan, y las sesiones resultantes consumen el mismo uso de suscripción de Claude Code que las sesiones interactivas. Cuando se alcanza cualquiera de los límites, el endpoint devuelve 429 rate_limit_error con un encabezado Retry-After. Las organizaciones con uso adicional habilitado continúan más allá de la asignación incluida con excedente medido.

Tus ejecuciones diarias restantes se muestran en claude.ai/code/routines. Para saber cómo interactúa el uso de rutinas con los límites de suscripción y la facturación de uso adicional, consulta Usage and limits en la documentación de Claude Code.



Compatibilidad con SDK

Este endpoint no está en los SDK de Anthropic. Su modelo de token difiere de la autenticación con clave de API, y los llamadores típicos, como jobs de CI y webhooks de alertas, envían la solicitud directamente.



Consulta también

• Automate work with routines en la documentación de Claude Code
• Encabezados beta
• Errores