Documentation Index
Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
Use this file to discover all available pages before exploring further.
- Scheduled: запуск по повторяющемуся расписанию, например ежечасно, ежедневно или еженедельно, или один раз в определенное будущее время
- API: срабатывание по требованию путем отправки HTTP POST на выделенную конечную точку рутины с токеном-носителем
- GitHub: автоматический запуск в ответ на события репозитория, такие как pull request или релизы
/schedule.
Администраторы Team и Enterprise могут отключить рутины для всех членов с помощью переключателя Routines на claude.ai/admin-settings/claude-code. При отключении существующие рутины перестают работать, и члены не могут создавать новые.
На этой странице рассматривается создание рутины, настройка каждого типа триггера, управление запусками и применение ограничений использования.
Примеры использования
Каждый пример сочетает тип триггера с типом работы, для которой подходят рутины: без присмотра, повторяемая и связанная с четким результатом. Обслуживание очереди задач. Триггер расписания запускается каждый вечер в рабочие дни для вашего трекера проблем через коннектор. Рутина читает проблемы, открытые с момента последнего запуска, применяет метки, назначает владельцев на основе области кода, на которую ссылаются, и публикует сводку в 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, сохраняя две библиотеки в синхронизации без необходимости человека переимплементировать каждое изменение.
Разделы ниже описывают создание рутины и настройку каждого из этих типов триггеров.
Создание рутины
Создайте рутину из веб-версии на claude.ai/code/routines, из приложения Desktop или из CLI. Все три интерфейса записывают в один облачный аккаунт, поэтому рутина, которую вы создаете в одном, сразу же появляется в других. В приложении Desktop нажмите Routines на боковой панели, затем New routine, и выберите Remote; выбор Local вместо этого создает локальную запланированную задачу Desktop, которая запускается на вашей машине, а не в облаке. Форма создания настраивает подсказку рутины, репозитории, окружение, коннекторы и триггеры. Рутины работают автономно как полные облачные сеансы Claude Code: нет выбора режима разрешений и нет запросов на одобрение во время запуска. Сеанс может запускать команды shell, использовать skills, зафиксированные в клонированном репозитории, и вызывать любые коннекторы, которые вы включите. То, что может достичь рутина, определяется выбранными вами репозиториями и их параметром push ветви, окружением сетевого доступа и переменных, а также включенными коннекторами. Ограничьте каждый из них тем, что рутине действительно нужно. Рутины принадлежат вашему индивидуальному аккаунту claude.ai. Они не совместно используются с товарищами по команде и учитываются в дневном лимите запусков вашего аккаунта. Все, что рутина делает через вашу подключенную идентификацию GitHub или коннекторы, отображается как вы: коммиты и pull request несут вашего пользователя GitHub, а сообщения Slack, задачи Linear или другие действия коннектора используют ваши связанные аккаунты для этих сервисов.Создание из веб-версии
Откройте форму создания
Назовите рутину и напишите подсказку
Выберите репозитории
claude/ для своих изменений.Выберите окружение
- Network access: установите уровень доступа в Интернет, доступный во время каждого запуска
- Environment variables: предоставьте ключи API, токены или другие секреты, которые может использовать Claude
- Setup script: установите зависимости и инструменты, которые нужны рутине. Результат кэшируется, поэтому скрипт не переустанавливается при каждом сеансе
Выберите триггер
- Schedule
- GitHub event
- API
Проверьте коннекторы и разрешения
claude/.Создайте рутину
Создание из CLI
Запустите/schedule в любом сеансе, чтобы создать запланированную рутину в диалоговом режиме. Вы также можете передать описание напрямую, например для повторяющейся рутины как /schedule daily PR review at 9am или одноразовой как /schedule clean up feature flag in one week. Claude проходит через ту же информацию, которую собирает веб-форма, затем сохраняет рутину в ваш аккаунт.
/schedule в CLI создает только запланированные рутины. Чтобы добавить триггер API или GitHub, отредактируйте рутину в веб-версии на claude.ai/code/routines.
CLI также поддерживает управление существующими рутинами. Запустите /schedule list, чтобы увидеть все рутины, /schedule update, чтобы изменить одну, или /schedule run, чтобы запустить ее немедленно.
Настройка триггеров
Рутина запускается, когда один из ее триггеров совпадает. Вы можете присоединить любую комбинацию триггеров расписания, API и GitHub к одной рутине и добавлять или удалять их в любое время из раздела Select a trigger формы редактирования рутины.Добавление триггера расписания
Триггер расписания запускает рутину по повторяющемуся расписанию или один раз в определенное будущее время. Выберите предустановленную частоту в разделе Select a trigger: ежечасно, ежедневно, по рабочим дням или еженедельно. Времена вводятся в вашем локальном часовом поясе и преобразуются автоматически, поэтому рутина запускается в это время независимо от того, где находится облачная инфраструктура. Запуски могут начаться на несколько минут позже запланированного времени из-за разброса. Смещение согласовано для каждой рутины. Для пользовательского интервала, такого как каждые два часа или первое число каждого месяца, выберите ближайшую предустановку в форме, затем запустите/schedule update в CLI, чтобы установить конкретное выражение cron. Минимальный интервал — один час; выражения, которые запускаются чаще, отклоняются.
Планирование одноразового запуска
Одноразовое расписание запускает рутину один раз в определенный момент времени. Используйте его, чтобы напомнить себе позже на неделе, открыть PR очистки после завершения развертывания или запустить последующую задачу, когда приходит изменение вышестоящего уровня. После запуска рутины она автоматически отключается, и веб-интерфейс отмечает ее как Ran. Чтобы запустить ее снова, отредактируйте рутину и установите новое одноразовое время. Создайте одноразовый запуск из CLI, описав время на естественном языке. Claude разрешает фразу относительно текущего времени и подтверждает абсолютный момент времени перед сохранением.Добавление триггера API
Триггер API дает рутине выделенную конечную точку HTTP. POST на конечную точку с токеном-носителем рутины запускает новый сеанс и возвращает URL сеанса. Используйте это для подключения Claude Code к системам оповещений, конвейерам развертывания, внутренним инструментам или везде, где вы можете сделать аутентифицированный HTTP запрос. Триггеры API добавляются к существующей рутине из веб-версии. CLI в настоящее время не может создавать или отзывать токены.Откройте рутину для редактирования
Добавьте триггер API
Скопируйте URL и сгенерируйте токен
Вызовите конечную точку
Authorization: Bearer при POST на URL. Раздел Trigger a routine ниже показывает полный пример.Запуск рутины
Отправьте POST запрос на конечную точку/fire с токеном-носителем в заголовке Authorization. Тело запроса принимает дополнительное поле text для контекста, специфичного для запуска, такого как тело оповещения или неудачный журнал, переданное рутине вместе с ее сохраненной подсказкой. Значение — это свободный текст и не анализируется: если вы отправляете JSON или другую структурированную полезную нагрузку, рутина получает ее как буквальную строку.
Пример ниже запускает рутину из shell:
Справочник API
Для полного справочника API, включая все ответы об ошибках, правила валидации и ограничения полей, смотрите Trigger a routine via API в документации Claude Platform. Конечная точка/fire доступна только пользователям claude.ai и не является частью поверхности Claude Platform API.
Добавление триггера GitHub
Триггер GitHub запускает новый сеанс автоматически, когда совпадающее событие происходит в подключенном репозитории. Каждое совпадающее событие запускает свой собственный сеанс.Откройте рутину для редактирования
Добавьте триггер события GitHub
Установите приложение Claude GitHub
/web-setup в CLI предоставляет доступ к репозиторию для клонирования, но не устанавливает приложение Claude GitHub и не включает доставку вебхука. Триггеры GitHub требуют установки приложения Claude GitHub, которое настройка триггера предложит вам сделать.Настройте триггер
Поддерживаемые события
Триггеры GitHub могут подписаться на одну из следующих категорий событий. В каждой категории вы можете выбрать конкретное действие, такое какpull_request.opened, или реагировать на все действия в категории.
| Событие | Срабатывает когда |
|---|---|
| Pull request | PR открыт, закрыт, назначен, помечен, синхронизирован или иным образом обновлен |
| 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 объединен |
matches regex проверяет все значение поля, а не подстроку в нем. Чтобы совпадать с любым заголовком, содержащим hotfix, напишите .*hotfix.*. Без окружающих .*, фильтр совпадает только с заголовком, который точно hotfix без ничего до или после. Для буквального совпадения подстроки без синтаксиса regex используйте оператор contains вместо этого.
Несколько примеров комбинаций фильтров:
- Auth module review: base branch
main, head branch containsauth-provider. Отправляет любой 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.ai на вашем аккаунте. MCP серверы, которые вы добавили локально в CLI с помощьюclaude mcp add, хранятся на вашей машине, а не на вашем аккаунте claude.ai, поэтому они не отображаются в списке коннекторов. Чтобы использовать один из этих серверов в рутине, добавьте его как коннектор на claude.ai/customize/connectors или объявите его в committed .mcp.json, чтобы он был частью клонированного репозитория.
Когда вы создаете рутину, все ваши текущие подключенные коннекторы включены по умолчанию. Удалите все, которые не нужны, чтобы ограничить, к каким инструментам Claude имеет доступ во время запуска. Вы также можете добавлять коннекторы непосредственно из формы рутины.
Чтобы управлять или добавлять коннекторы вне формы рутины, посетите Settings > Connectors на claude.ai или используйте /schedule update в CLI.
Окружения и сетевой доступ
Каждая рутина запускается в облачном окружении, которое контролирует сетевой доступ, переменные окружения и скрипты настройки. Рутина наследует политику сетевого доступа окружения при каждом запуске. Окружение Default использует Trusted сетевой доступ: список разрешений по умолчанию реестров пакетов, API облачных провайдеров, реестров контейнеров и распространенных доменов разработки доступен, но произвольные домены недоступны. Исходящие запросы к другим хостам завершаются с ошибкой403 и x-deny-reason: host_not_allowed. Трафик MCP коннектора маршрутизируется через серверы Anthropic, поэтому коннекторы, которые вы добавляете в рутину, работают без добавления их хостов в Allowed domains. Удалите все коннекторы, которые вам не нужны, в разделе Коннекторы.
Чтобы разрешить дополнительные домены:
Откройте рутину для редактирования
Откройте селектор окружения
Откройте параметры окружения
Измените уровень сетевого доступа
Использование и ограничения
Рутины снижают использование подписки так же, как интерактивные сеансы. В дополнение к стандартным ограничениям подписки, рутины имеют дневной лимит на количество запусков, которые могут начаться на аккаунт. Смотрите ваше текущее потребление и оставшиеся дневные запуски рутин на claude.ai/code/routines или claude.ai/settings/usage. Когда рутина достигает дневного лимита или лимита использования вашей подписки, организации с включенным дополнительным использованием могут продолжать запускать рутины на измеренный перерасход. Без дополнительного использования дополнительные запуски отклоняются до сброса окна. Включите дополнительное использование из Settings > Billing на claude.ai. Разовые запуски не учитываются в дневном лимите рутин. Они снижают ваше обычное использование подписки как любой другой сеанс, но они освобождены от допуска на дневные запуски рутин на аккаунт.Troubleshooting
/schedule возвращает “Unknown command”
CLI скрывает /schedule, когда одно из его требований не выполнено. Причина обычно одна из следующих:
- Вы аутентифицированы с помощью Console API key или облачного провайдера, такого как Bedrock, Vertex или Foundry.
/scheduleтребует входа по подписке claude.ai. ЕслиANTHROPIC_API_KEYилиANTHROPIC_AUTH_TOKENустановлены в вашей оболочке, илиapiKeyHelperустановлен вsettings.json, удалите их сначала, так как они имеют приоритет над входом claude.ai DISABLE_TELEMETRY,DO_NOT_TRACK,CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICилиDISABLE_GROWTHBOOKустановлены в переменных окружения вашей оболочки или в блокеenvфайлаsettings.json. Они отключают получение флагов функций, от которого зависит/schedule- Вы находитесь в сеансе Claude Code в веб-версии. Управляйте рутинами из веб-интерфейса вместо этого
- Ваш CLI старше версии v2.1.81. Запустите
claude update
”Routines are disabled by your organization’s policy”
Ваш администратор Team или Enterprise, вероятно, отключил переключатель Routines на claude.ai/admin-settings/claude-code. Это параметр организации на стороне сервера, поэтому его нельзя переопределить из вашей локальной конфигурации. Свяжитесь с вашим администратором, чтобы запросить включение рутин для вашей организации.Связанные ресурсы
/loopand in-session scheduling: запланируйте локальные задачи в открытом сеансе CLI- Desktop scheduled tasks: локальные запланированные задачи, которые запускаются на вашей машине с доступом к локальным файлам
- Cloud environment: настройте среду выполнения для облачных сеансов
- MCP connectors: подключите внешние сервисы, такие как Slack, Linear и Google Drive
- GitHub Actions: запустите Claude в вашем конвейере CI при событиях репозитория