Перейти к основному содержанию
Рутины находятся в исследовательском предпросмотре. Поведение, ограничения и поверхность API могут измениться.
Рутина — это сохраненная конфигурация Claude Code: подсказка, один или несколько репозиториев и набор коннекторов, упакованные один раз и запускаемые автоматически. Рутины выполняются на облачной инфраструктуре, управляемой Anthropic, поэтому они продолжают работать, когда ваш ноутбук закрыт. Каждая рутина может иметь один или несколько присоединенных триггеров:
  • Scheduled: запуск по повторяющемуся расписанию, например ежечасно, ежедневно или еженедельно
  • API: срабатывание по требованию путем отправки HTTP POST на выделенную конечную точку рутины с токеном-носителем
  • GitHub: автоматический запуск в ответ на события репозитория, такие как pull request или релизы
Одна рутина может объединять триггеры. Например, рутина проверки PR может запускаться ежедневно, срабатывать из скрипта развертывания и также реагировать на каждый новый PR. Рутины доступны в планах Pro, Max, Team и Enterprise с включенным Claude Code в веб-версии. Создавайте и управляйте ими на claude.ai/code/routines или из CLI с помощью /schedule. На этой странице рассматривается создание рутины, настройка каждого типа триггера, управление запусками и применение ограничений использования.

Примеры использования

Каждый пример сочетает тип триггера с типом работы, для которой подходят рутины: без присмотра, повторяемая и связанная с четким результатом. Обслуживание очереди задач. Триггер расписания запускается каждый вечер в рабочие дни для вашего трекера проблем через коннектор. Рутина читает проблемы, открытые с момента последнего запуска, применяет метки, назначает владельцев на основе области кода, на которую ссылаются, и публикует сводку в Slack, чтобы команда начала день с упорядоченной очередью. Сортировка оповещений. Ваш инструмент мониторинга вызывает конечную точку API рутины при превышении порога ошибок, передавая тело оповещения как text. Рутина извлекает трассировку стека, коррелирует ее с недавними коммитами в репозитории и открывает черновой pull request с предложенным исправлением и ссылкой обратно на оповещение. Дежурный инженер проверяет PR вместо того, чтобы начинать с пустого терминала. Пользовательская проверка кода. Триггер GitHub запускается на pull_request.opened. Рутина применяет собственный контрольный список проверки вашей команды, оставляет встроенные комментарии по проблемам безопасности, производительности и стиля, а также добавляет сводный комментарий, чтобы человеческие рецензенты могли сосредоточиться на дизайне вместо механических проверок. Проверка развертывания. Ваш конвейер CD вызывает конечную точку API рутины после каждого развертывания в production. Рутина запускает дымовые тесты для новой сборки, сканирует журналы ошибок на предмет регрессий и публикует решение (go или no-go) в канал релизов до закрытия окна развертывания. Дрейф документации. Триггер расписания запускается еженедельно. Рутина сканирует объединенные PR с момента последнего запуска, отмечает документацию, которая ссылается на измененные API, и открывает PR обновления для репозитория документации, чтобы редактор мог его проверить. Портирование библиотеки. Триггер GitHub запускается на pull_request.closed, отфильтрованный по объединенным PR в одном репозитории SDK. Рутина переносит изменение в параллельный SDK на другом языке и открывает соответствующий PR, сохраняя две библиотеки в синхронизации без необходимости человека переимплементировать каждое изменение. Разделы ниже описывают создание рутины и настройку каждого из этих типов триггеров.

Создание рутины

Создайте рутину из веб-версии, приложения Desktop или CLI. Все три интерфейса записывают в один облачный аккаунт, поэтому рутина, которую вы создаете в CLI, сразу же появляется на claude.ai/code/routines. В приложении Desktop нажмите New task и выберите New remote task; выбор New local task вместо этого создает локальную запланированную задачу Desktop, которая запускается на вашей машине и не является рутиной. Форма создания настраивает подсказку рутины, репозитории, окружение, коннекторы и триггеры. Рутины работают автономно как полные облачные сеансы Claude Code: нет выбора режима разрешений и нет запросов на одобрение во время запуска. Сеанс может запускать команды shell, использовать skills, зафиксированные в клонированном репозитории, и вызывать любые коннекторы, которые вы включите. То, что может достичь рутина, определяется выбранными вами репозиториями и их параметром push ветви, окружением сетевого доступа и переменных, а также включенными коннекторами. Ограничьте каждый из них тем, что рутине действительно нужно. Рутины принадлежат вашему индивидуальному аккаунту claude.ai. Они не совместно используются с товарищами по команде и учитываются в дневном лимите запусков вашего аккаунта. Все, что рутина делает через вашу подключенную идентификацию GitHub или коннекторы, отображается как вы: коммиты и pull request несут вашего пользователя GitHub, а сообщения Slack, задачи Linear или другие действия коннектора используют ваши связанные аккаунты для этих сервисов.

Создание из веб-версии

1

Откройте форму создания

Посетите claude.ai/code/routines и нажмите New routine.
2

Назовите рутину и напишите подсказку

Дайте рутине описательное имя и напишите подсказку, которую Claude запускает каждый раз. Подсказка — это самая важная часть: рутина работает автономно, поэтому подсказка должна быть самодостаточной и явно указывать, что делать и как выглядит успех.Ввод подсказки включает селектор модели. Claude использует выбранную модель при каждом запуске.
3

Выберите репозитории

Добавьте один или несколько репозиториев GitHub для работы Claude. Каждый репозиторий клонируется в начале запуска, начиная с ветви по умолчанию. Claude создает ветви с префиксом claude/ для своих изменений. Чтобы разрешить push в любую ветвь, включите Allow unrestricted branch pushes для этого репозитория.
4

Выберите окружение

Выберите облачное окружение для рутины. Окружения контролируют, к чему имеет доступ облачный сеанс:
  • Network access: установите уровень доступа в Интернет, доступный во время каждого запуска
  • Environment variables: предоставьте ключи API, токены или другие секреты, которые может использовать Claude
  • Setup script: установите зависимости и инструменты, которые нужны рутине. Результат кэшируется, поэтому скрипт не переустанавливается при каждом сеансе
Предоставляется окружение Default. Чтобы использовать пользовательское окружение, создайте его перед созданием рутины.
5

Выберите триггер

В разделе Select a trigger выберите, как запускается рутина. Вы можете выбрать один тип триггера или объединить несколько.
Выберите предустановленную частоту: ежечасно, ежедневно, по рабочим дням или еженедельно. Смотрите Add a schedule trigger для обработки часовых поясов, разброса и пользовательских интервалов cron.
6

Проверьте коннекторы

Все ваши подключенные MCP коннекторы включены по умолчанию. Удалите все, которые рутине не нужны. Коннекторы дают Claude доступ к внешним сервисам, таким как Slack, Linear или Google Drive, во время каждого запуска.
7

Создайте рутину

Нажмите Create. Рутина появляется в списке и запускается в следующий раз, когда один из ее триггеров совпадает. Чтобы начать запуск немедленно, нажмите Run now на странице деталей рутины.Каждый запуск создает новый сеанс рядом с вашими другими сеансами, где вы можете увидеть, что сделал Claude, проверить изменения и создать pull request.

Создание из CLI

Запустите /schedule в любом сеансе, чтобы создать запланированную рутину в диалоговом режиме. Вы также можете передать описание напрямую, как в /schedule daily PR review at 9am. Claude проходит через ту же информацию, которую собирает веб-форма, затем сохраняет рутину в ваш аккаунт. /schedule в CLI создает только запланированные рутины. Чтобы добавить триггер API или GitHub, отредактируйте рутину в веб-версии на claude.ai/code/routines. CLI также поддерживает управление существующими рутинами. Запустите /schedule list, чтобы увидеть все рутины, /schedule update, чтобы изменить одну, или /schedule run, чтобы запустить ее немедленно.

Создание из приложения Desktop

Откройте страницу Schedule в приложении Desktop, нажмите New task и выберите New remote task. Приложение Desktop показывает как локальные запланированные задачи, так и рутины в одной сетке. Смотрите Desktop scheduled tasks для деталей локального варианта.

Настройка триггеров

Рутина запускается, когда один из ее триггеров совпадает. Вы можете присоединить любую комбинацию триггеров расписания, API и GitHub к одной рутине и добавлять или удалять их в любое время из раздела Select a trigger формы редактирования рутины.

Добавление триггера расписания

Триггер расписания запускает рутину по повторяющемуся расписанию. Выберите предустановленную частоту в разделе Select a trigger: ежечасно, ежедневно, по рабочим дням или еженедельно. Времена вводятся в вашем локальном часовом поясе и преобразуются автоматически, поэтому рутина запускается в это время независимо от того, где находится облачная инфраструктура. Запуски могут начаться на несколько минут позже запланированного времени из-за разброса. Смещение согласовано для каждой рутины. Для пользовательского интервала, такого как каждые два часа или первое число каждого месяца, выберите ближайшую предустановку в форме, затем запустите /schedule update в CLI, чтобы установить конкретное выражение cron. Минимальный интервал — один час; выражения, которые запускаются чаще, отклоняются.

Добавление триггера API

Триггер API дает рутине выделенную конечную точку HTTP. POST на конечную точку с токеном-носителем рутины запускает новый сеанс и возвращает URL сеанса. Используйте это для подключения Claude Code к системам оповещений, конвейерам развертывания, внутренним инструментам или везде, где вы можете сделать аутентифицированный HTTP запрос. Триггеры API добавляются к существующей рутине из веб-версии. CLI в настоящее время не может создавать или отзывать токены.
1

Откройте рутину для редактирования

Перейдите на claude.ai/code/routines, нажмите рутину, которую вы хотите запустить через API, затем нажмите значок карандаша, чтобы открыть Edit routine.
2

Добавьте триггер API

Прокрутите до раздела Select a trigger ниже подсказки, нажмите Add another trigger и выберите API.
3

Скопируйте URL и сгенерируйте токен

Модальное окно показывает URL для этой рутины вместе с примером команды curl. Скопируйте URL, затем нажмите Generate token и сразу же скопируйте токен. Токен показывается один раз и не может быть получен позже, поэтому сохраните его в безопасном месте, таком как хранилище секретов вашего инструмента оповещений.
4

Вызовите конечную точку

Отправьте токен в заголовке Authorization: Bearer при POST на URL. Раздел Trigger a routine ниже показывает полный пример.
Каждая рутина имеет свой токен, ограниченный только запуском этой рутины. Чтобы повернуть или отозвать его, вернитесь в то же модальное окно и нажмите Regenerate или Revoke.

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

Отправьте POST запрос на конечную точку /fire с токеном-носителем в заголовке Authorization. Тело запроса принимает дополнительное поле text для контекста, специфичного для запуска, такого как тело оповещения или неудачный журнал, переданное рутине вместе с ее сохраненной подсказкой. Значение — это свободный текст и не анализируется: если вы отправляете JSON или другую структурированную полезную нагрузку, рутина получает ее как буквальную строку. Пример ниже запускает рутину из shell:
curl -X POST https://api.anthropic.com/v1/claude_code/routines/trig_01ABCDEFGHJKLMNOPQRSTUVW/fire \
  -H "Authorization: Bearer sk-ant-oat01-xxxxx" \
  -H "anthropic-beta: experimental-cc-routine-2026-04-01" \
  -H "anthropic-version: 2023-06-01" \
  -H "Content-Type: application/json" \
  -d '{"text": "Sentry alert SEN-4521 fired in prod. Stack trace attached."}'
Успешный запрос возвращает тело JSON с новым ID сеанса и URL:
{
  "type": "routine_fire",
  "claude_code_session_id": "session_01HJKLMNOPQRSTUVWXYZ",
  "claude_code_session_url": "https://claude.ai/code/session_01HJKLMNOPQRSTUVWXYZ"
}
Откройте URL сеанса в браузере, чтобы наблюдать запуск в реальном времени, проверить изменения или продолжить разговор вручную.
Конечная точка /fire поставляется под заголовком бета-версии experimental-cc-routine-2026-04-01. Формы запроса и ответа, ограничения скорости и семантика токенов могут измениться, пока функция находится в исследовательском предпросмотре. Критические изменения поставляются за новыми версиями заголовка бета-версии с датой, и две самые последние предыдущие версии заголовка продолжают работать, чтобы у вызывающих было время для миграции.

Справочник API

Для полного справочника API, включая все ответы об ошибках, правила валидации и ограничения полей, смотрите Trigger a routine via API в документации Claude Platform. Конечная точка /fire доступна только пользователям claude.ai и не является частью поверхности Claude Platform API.

Добавление триггера GitHub

Триггер GitHub запускает новый сеанс автоматически, когда совпадающее событие происходит в подключенном репозитории. Каждое совпадающее событие запускает свой собственный сеанс.
Во время исследовательского предпросмотра события вебхука GitHub подлежат ограничениям в час для каждой рутины и для каждого аккаунта. События сверх лимита отбрасываются до сброса окна. Смотрите ваши текущие ограничения на claude.ai/code/routines.
Триггеры GitHub настраиваются только из веб-интерфейса.
1

Откройте рутину для редактирования

Перейдите на claude.ai/code/routines, нажмите рутину, затем нажмите значок карандаша, чтобы открыть Edit routine.
2

Добавьте триггер события GitHub

Прокрутите до раздела Select a trigger, нажмите Add another trigger и выберите GitHub event.
3

Установите приложение Claude GitHub

Приложение Claude GitHub должно быть установлено в репозитории, на который вы хотите подписаться. Настройка триггера предложит вам установить его, если он еще не установлен.
Запуск /web-setup в CLI предоставляет доступ к репозиторию для клонирования, но не устанавливает приложение Claude GitHub и не включает доставку вебхука. Триггеры GitHub требуют установки приложения Claude GitHub, которое настройка триггера предложит вам сделать.
4

Настройте триггер

Выберите репозиторий, выберите событие из списка supported events и дополнительно добавьте фильтры. Сохраните триггер.

Поддерживаемые события

Триггеры GitHub могут подписаться на одну из следующих категорий событий. В каждой категории вы можете выбрать конкретное действие, такое как pull_request.opened, или реагировать на все действия в категории.
СобытиеСрабатывает когда
Pull requestPR открыт, закрыт, назначен, помечен, синхронизирован или иным образом обновлен
ReleaseРелиз создан, опубликован, отредактирован или удален

Фильтрация pull request

Используйте фильтры, чтобы сузить, какие pull request запускают новый сеанс. Все условия фильтра должны совпадать, чтобы рутина сработала. Доступные поля фильтра:
ФильтрСовпадает
AuthorИмя пользователя GitHub автора PR
TitleТекст заголовка PR
BodyТекст описания PR
Base branchВетвь, на которую нацелен PR
Head branchВетвь, из которой исходит PR
LabelsМетки, применяемые к PR
Is draftНаходится ли PR в черновом состоянии
Is mergedБыл ли PR объединен
From forkИсходит ли PR из форка
Каждый фильтр сочетает поле с оператором: equals, contains, starts with, is one of, is not one of или matches regex. Оператор matches regex проверяет все значение поля, а не подстроку в нем. Чтобы совпадать с любым заголовком, содержащим hotfix, напишите .*hotfix.*. Без окружающих .*, фильтр совпадает только с заголовком, который точно hotfix без ничего до или после. Для буквального совпадения подстроки без синтаксиса regex используйте оператор contains вместо этого. Несколько примеров комбинаций фильтров:
  • Auth module review: base branch main, head branch contains auth-provider. Отправляет любой PR, который касается аутентификации, сосредоточенному рецензенту.
  • External contributor triage: from fork is true. Маршрутизирует каждый PR на основе форка через дополнительную проверку безопасности и стиля перед тем, как человек посмотрит на него.
  • Ready-for-review only: is draft is false. Пропускает черновики, поэтому рутина запускается только, когда PR готов к проверке.
  • Label-gated backport: labels include needs-backport. Запускает рутину портирования в другую ветвь только, когда мейнтейнер помечает PR.

Как сеансы соответствуют событиям

Каждое совпадающее событие GitHub запускает новый сеанс. Повторное использование сеанса между событиями недоступно для рутин, запускаемых GitHub, поэтому два обновления PR создают два независимых сеанса.

Управление рутинами

Нажмите рутину в списке, чтобы открыть ее страницу деталей. Страница деталей показывает репозитории рутины, коннекторы, подсказку, расписание, токены API, триггеры GitHub и список прошлых запусков.

Просмотр и взаимодействие с запусками

Нажмите любой запуск, чтобы открыть его как полный сеанс. Оттуда вы можете увидеть, что сделал Claude, проверить изменения, создать pull request или продолжить разговор. Каждый сеанс запуска работает как любой другой сеанс: используйте меню раскрывающегося списка рядом с заголовком сеанса, чтобы переименовать, архивировать или удалить его.

Редактирование и управление рутинами

Со страницы деталей рутины вы можете:
  • Нажать Run now, чтобы начать запуск немедленно без ожидания следующего запланированного времени.
  • Использовать переключатель в разделе Repeats, чтобы приостановить или возобновить расписание. Приостановленные рутины сохраняют свою конфигурацию, но не запускаются, пока вы их не переактивируете.
  • Нажать значок карандаша, чтобы открыть Edit routine и изменить имя, подсказку, репозитории, окружение, коннекторы или любые триггеры рутины. Раздел Select a trigger — это место, где вы добавляете или удаляете расписания, токены API и триггеры событий GitHub.
  • Нажать значок удаления, чтобы удалить рутину. Прошлые сеансы, созданные рутиной, остаются в вашем списке сеансов.

Репозитории и разрешения ветвей

Рутинам нужен доступ GitHub для клонирования репозиториев. Когда вы создаете рутину из CLI с /schedule, Claude проверяет, подключен ли ваш аккаунт к GitHub, и предлагает вам запустить /web-setup, если это не так. Смотрите GitHub authentication options для двух способов предоставления доступа. Каждый репозиторий, который вы добавляете, клонируется при каждом запуске. Claude начинает с ветви по умолчанию репозитория, если ваша подсказка не указывает иное. По умолчанию Claude может только push в ветви с префиксом claude/. Это предотвращает случайное изменение рутинами защищенных или долгоживущих ветвей. Чтобы удалить это ограничение для конкретного репозитория, включите Allow unrestricted branch pushes для этого репозитория при создании или редактировании рутины.

Коннекторы

Рутины могут использовать ваши подключенные MCP коннекторы для чтения и записи во внешние сервисы во время каждого запуска. Например, рутина, которая сортирует запросы поддержки, может читать из канала Slack и создавать проблемы в Linear. Когда вы создаете рутину, все ваши текущие подключенные коннекторы включены по умолчанию. Удалите все, которые не нужны, чтобы ограничить, к каким инструментам Claude имеет доступ во время запуска. Вы также можете добавлять коннекторы непосредственно из формы рутины. Чтобы управлять или добавлять коннекторы вне формы рутины, посетите Settings > Connectors на claude.ai или используйте /schedule update в CLI.

Окружения

Каждая рутина запускается в облачном окружении, которое контролирует сетевой доступ, переменные окружения и скрипты настройки. Настройте окружения перед созданием рутины, чтобы дать Claude доступ к API, установить зависимости или ограничить область сети. Смотрите cloud environment для полного руководства настройки.

Использование и ограничения

Рутины снижают использование подписки так же, как интерактивные сеансы. В дополнение к стандартным ограничениям подписки, рутины имеют дневной лимит на количество запусков, которые могут начаться на аккаунт. Смотрите ваше текущее потребление и оставшиеся дневные запуски рутин на claude.ai/code/routines или claude.ai/settings/usage. Когда рутина достигает дневного лимита или лимита использования вашей подписки, организации с включенным дополнительным использованием могут продолжать запускать рутины на измеренный перерасход. Без дополнительного использования дополнительные запуски отклоняются до сброса окна. Включите дополнительное использование из Settings > Billing на claude.ai.

Связанные ресурсы

  • /loop and in-session scheduling: запланируйте локальные задачи в открытом сеансе CLI
  • Desktop scheduled tasks: локальные запланированные задачи, которые запускаются на вашей машине с доступом к локальным файлам
  • Cloud environment: настройте среду выполнения для облачных сеансов
  • MCP connectors: подключите внешние сервисы, такие как Slack, Linear и Google Drive
  • GitHub Actions: запустите Claude в вашем конвейере CI при событиях репозитория