Запуск рутины через API

Claude Code — это агентный инструмент для программирования от Anthropic. Claude Code в веб-версии запускает сеансы Claude Code на облачной инфраструктуре под управлением Anthropic по адресу claude.ai/code, а «routine» (рутина) — это сохранённая там конфигурация: подсказка, один или несколько репозиториев и коннекторы, упакованные так, чтобы запускаться без участия пользователя по расписанию, в ответ на события GitHub или при вызове по HTTP.

Эта конечная точка является точкой входа по HTTP. Отправка POST-запроса на неё запускает новое выполнение существующей рутины и возвращает идентификатор и URL созданного сеанса. Типичные вызывающие стороны — системы оповещения, CI-конвейеры и внутренние инструменты, которым нужно программно запустить сеанс Claude Code.

Для вызова этой конечной точки требуется учётная запись claude.ai на тарифном плане Pro, Max, Team или Enterprise с включённой функцией Claude Code в веб-версии. Аутентификация выполняется с помощью «bearer token» (токена-носителя), создаваемого для конкретной рутины в веб-интерфейсе Claude Code, а не с помощью ключа API Claude.



Отличия от Claude Platform

Конечная точка запуска рутины относится к продуктовой поверхности Claude Code, которая отличается от API и SDK Claude Platform по ряду параметров:



Перед началом работы

Для вызова этой конечной точки вам потребуется:

1. Рутина, созданная на claude.ai/code/routines
2. Токен-носитель, сгенерированный для этой рутины: откройте рутину для редактирования, нажмите Add another trigger в разделе Select a trigger, выберите API, затем нажмите Generate token в модальном окне. Токен показывается один раз и не может быть получен повторно.

Полное пошаговое руководство по настройке см. в разделе Добавление API-триггера документации Claude Code.



Запуск рутины

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

Каждый запрос должен включать заголовок anthropic-beta: experimental-cc-routine-2026-04-01. Запросы без него возвращают 400 invalid_request_error.

Веб-интерфейс Claude Code предоставляет полный URL вместе с токеном при добавлении API-триггера, поэтому большинство интеграций сохраняют оба значения как секреты и вызывают конечную точку напрямую. Примеры ниже показывают вызов из командной оболочки и шаг GitHub Actions, который запускает рутину при сбое 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\"}"

Запрос возвращает ответ сразу после создания сеанса. Он не передаёт вывод сеанса в потоковом режиме и не ожидает завершения сеанса.



Заголовки



Параметры пути



Тело запроса

Тело запроса необязательно. Неизвестные поля в теле игнорируются.



Ответ

Успешный запрос возвращает 200 OK с данными нового сеанса:

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



Ошибки

Ошибки используют стандартную оболочку ошибок Anthropic:

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



Аутентификация

Токен-носитель ограничен областью действия одной рутины. Скомпрометированный токен может только запускать эту рутину; он не даёт доступа на чтение, доступа к другим рутинам или доступа к данным учётной записи.

Генерируйте и отзывайте токены в настройках API-триггера рутины на claude.ai/code/routines. Публичного API для управления токенами нет. Генерация нового токена отзывает предыдущий.



Идемпотентность

Каждый успешный запрос создаёт новый сеанс. Ключа идемпотентности нет. Если вызывающая сторона вебхука повторяет запрос, конечная точка создаёт несколько сеансов.



Ограничения скорости

Запуски рутин учитываются в ежедневном лимите на учётную запись, который зависит от тарифного плана, а создаваемые сеансы расходуют тот же объём использования подписки Claude Code, что и интерактивные сеансы. При достижении любого из лимитов конечная точка возвращает 429 rate_limit_error с заголовком Retry-After. Организации с включённым дополнительным использованием продолжают работу сверх включённого лимита с тарификацией по факту превышения.

Оставшееся количество ежедневных запусков отображается на claude.ai/code/routines. О том, как использование рутин взаимодействует с лимитами подписки и тарификацией дополнительного использования, см. в разделе Использование и лимиты документации Claude Code.



Поддержка SDK

Эта конечная точка не включена в SDK Anthropic. Её модель токенов отличается от аутентификации по ключу API, а типичные вызывающие стороны, такие как CI-задания и вебхуки систем оповещения, отправляют запрос напрямую.



См. также

• Автоматизация работы с помощью рутин в документации Claude Code
• Бета-заголовки
• Ошибки