SpyBara
Go Premium

routines.md 2026-10-19 23:58 UTC to 2026-10-20 23:00 UTC

This page contains 268 additions and 285 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Wed 7 23:59 Thu 8 22:58 Sat 10 23:01 Wed 14 22:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Sat 24 22:59 Sun 25 23:58 Tue 27 22:59 Fri 30 23:01

使用定时任务自动化工作

让 Claude Code 自动运行。创建定时任务（原名 Routine），使其在云端按计划、通过 API 调用或响应 GitHub 事件运行。

[!NOTE]

定时任务目前为研究预览版。其行为、限制和 API 接口可能会发生变化。

云端定时任务（原名 Routine）是一个已保存的 Claude Code 配置：包含一个提示词、一个或多个仓库以及一组连接器，一次打包后即可自动运行。定时任务在 Anthropic 管理的云基础设施上执行，或在路由到您组织的自托管环境时在该环境中执行，因此即使您的笔记本电脑已合上，它们也能继续工作。

每个定时任务可以附加一个或多个触发器：

  • Schedule：按照每小时、每晚或每周等定期节奏运行，或在未来某个特定时间运行一次
  • API：通过向该任务专属的端点发送带有 Bearer 令牌的 HTTP POST 请求来按需触发
  • GitHub：自动响应 Pull Request 或发布等仓库事件而运行

单个定时任务可以组合多个触发器。例如，一个 PR 审查任务可以每晚运行、从部署脚本触发，同时还对每个新 PR 做出响应。

定时任务不一定需要计划：

  • 仅有 API 触发器的任务会在您调用其端点时运行。
  • 仅有 GitHub 触发器的任务会在发生匹配的仓库事件时运行。

定时任务适用于 Pro、Max、Team 和 Enterprise 套餐。您可以在 claude.ai/code/routines 创建和管理它们，也可以在 CLI 中使用 /schedule。旧名称 Routine 仍会出现在网址、CLI 和 API 中。

[!NOTE]

另有两项功能会在您的计算机上而非云端安排工作：Desktop 定时任务和 /loop。要在这三者之间进行选择，请参阅比较调度选项。

Team 和 Enterprise 的 Owner 可以通过 Organization settings > Capabilities > Remote sessions 中的 Scheduled tasks (Was Routines) 开关为所有成员关闭定时任务。关闭该开关后，现有定时任务将停止运行，成员也无法创建新的定时任务。

示例用例

每个示例都将一种触发器类型与适合定时任务的工作类型相匹配：无人值守、可重复且有明确结果。

  • 积压工作维护：一个计划触发器每个工作日晚上在您的仓库中运行，并将您的问题跟踪器添加为连接器。定时任务读取自上次运行以来新开的问题，添加标签，并根据所引用的代码区域分配负责人。然后它会将摘要发布到 Slack，让团队以整理好的队列开始新的一天。
  • 警报分诊：当错误超过阈值时，您的监控工具会调用定时任务的 API 端点，并将警报正文作为 text 传入。任务的提示词指示 Claude 调查触发负载中的警报，因此它会提取堆栈跟踪，并将其与仓库中的最近提交相关联。然后它会打开一个草稿 Pull Request，其中包含建议的修复方案和指回该警报的链接。值班人员只需审查该 PR，而不必从空白终端开始。
  • 定制代码审查：一个 GitHub 触发器在 pull_request.opened 时运行。定时任务应用您团队自己的审查清单，并针对安全、性能和风格问题留下行内评论。它还会添加一条摘要评论，让人工审查者可以专注于设计，而不是机械性检查。
  • 部署验证：您的 CD 流水线在每次生产部署后调用定时任务的 API 端点。任务针对新构建运行冒烟检查，扫描错误日志以查找回归问题，并在部署窗口关闭前向发布频道发布可行或不可行的结论。
  • 文档偏差检查：一个计划触发器每周运行。定时任务扫描自上次运行以来合并的 PR，标记引用了已更改 API 的文档，并针对文档仓库打开更新 PR 供编辑审查。
  • 库移植：一个 GitHub 触发器在 pull_request.closed 时运行，并筛选为某个 SDK 仓库中已合并的 PR。定时任务将该更改移植到另一种语言的对应 SDK 中并打开一个相应的 PR，使两个库保持同步，而无需人工重新实现每项更改。

创建定时任务

您可以在 Web 端的 claude.ai/code/routines、Desktop 应用或 CLI 中创建定时任务。这三个使用入口都写入同一个云端账户，因此您在其中一处创建的定时任务会立即显示在其他位置。在 Desktop 应用的 Code 标签页中，点击侧边栏中或侧边栏 More 菜单中的 Scheduled，然后点击 New task，并继续按照从 Web 创建进行操作。

定时任务作为完整的 Claude Code 云端会话自主运行。您无需选择权限模式。会话会运行 shell 命令、使用提交到所克隆仓库中的 skill，并调用您包含的任何连接器，所有这些都无需停下来等待批准，某些 Artifact 操作除外。

定时任务可以访问的内容由以下各项决定：

  • 您选择的仓库
  • 环境的网络访问和变量
  • 您包含的连接器

请将每一项的范围限定在任务所需的内容之内。

定时任务属于您的个人 claude.ai 账户。它们不会与队友共享，其运行计入您账户的用量和限制。定时任务通过您已连接的 GitHub 身份或连接器执行的任何操作都会显示为由您执行。提交和 Pull Request 会带有您的 GitHub 用户，Slack 消息、Linear 工单或其他连接器操作会使用您为这些服务关联的账户。

从 Web 创建

1. 打开创建对话框

访问 claude.ai/code/routines 并点击 New task。如果先打开了一个菜单，请选择 Set up manually。随后会打开 New scheduled task 对话框。该菜单中的另一个选项 Create with Claude 允许您在聊天中描述任务，由 Claude 为您创建。

如果对话框打开时已显示 Repositories 和 Environment，请参阅该对话框有何不同。否则，此对话框也可用于创建 claude.ai 聊天的定时任务。要将您的任务设为对话框中所称的 Claude Code 任务，请在后续步骤中选择一个仓库，或添加 GitHub 事件触发器或 API 触发器。此类任务会在云端会话中运行 Claude Code。

2. 命名任务并编写提示词

为定时任务取一个描述性名称，并编写 Claude 每次运行的提示词。提示词是最重要的部分：任务是自主运行的，因此提示词必须是自包含的，并明确说明要做什么以及怎样算成功。在提示词输入框的模型选择器中选择一个模型。Claude 在每次运行时都会使用该模型。

当触发器触发时，会话会将已保存的提示词作为其分配的任务接收并执行，而不是将其视为在对话中途到达的不受信任内容。触发器仅证明该提示词是由您账户上的授权会话预先存储的。因此，触发的提示词不是实时用户输入，不能充当运行期间操作的批准或同意。会话在运行期间获取的内容仍按正常方式处理。

3. 选择触发器

在 Trigger 行中，选择任务的启动方式。要组合多个触发器，请点击该行末尾的 +。

Schedule

为定期运行选择一个预设频率。有关时区处理、延迟启动、自定义 cron 间隔和一次性运行，请参阅添加计划触发器。

GitHub event

选择仓库、要响应的事件以及可选的筛选条件。有关支持的事件和筛选字段的完整列表，请参阅添加 GitHub 触发器。

API

在此处选择 API。当您点击 Create 时，API token 对话框会显示一次令牌，因此请在关闭对话框之前复制它。要复制 URL 或生成新令牌，请参阅添加 API 触发器。

4. 选择仓库

展开 Advanced settings。在 General 标签页的 Repository 下，选择一个或多个供 Claude 在其中工作的 GitHub 仓库。

每个仓库都会在运行开始时被克隆。Claude 会为其更改创建带有 claude/ 前缀的分支。

5. 选择环境

选择仓库后，其下方会出现 Cloud environment。为任务选择一个云环境。环境控制云端会话可以访问的内容：

  • Network access：设置每次运行期间可用的互联网访问级别
  • Environment variables：提供 Claude 在每次运行期间可以使用的值。它们对使用该环境的任何人都可见，因此在 Anthropic 托管的环境中，请改为将 Claude 在运行期间调用的 API 的密钥存储为网络密钥。该部分还列出了永远不会获得密钥的请求
  • Setup script：安装任务所需的依赖和工具。结果会被缓存，因此脚本不会在每个会话中重新运行

系统提供了一个 Default 环境，具有 Trusted 网络访问，仅允许默认允许列表中的包注册表、云提供商 API、容器注册表和常见开发域名通过会话的网络。您添加到任务中的连接器通过 Anthropic 的服务器访问其服务，因此无需更改允许列表。

如果您的任务需要直接访问您自己的服务或该列表之外的域名，请在运行前编辑环境的网络访问。要使用单独的环境，请先创建一个。

6. 检查连接器

切换到 Advanced settings 的 Connectors 标签页。默认包含您所有已连接的 MCP 连接器。请移除任务不需要的连接器：Claude 可以使用所包含连接器中的每个工具（包括写入操作），且在运行期间不会请求权限。

7. 创建任务

点击 Create。对话框关闭后，新任务的详情页将打开。任务会在其某个触发器下次匹配时运行。要立即启动一次运行，请在详情页上点击 Run now。

每次运行都会在您的其他会话旁边创建一个新会话，您可以在其中查看 Claude 执行了哪些操作、审查更改并创建 Pull Request。

主视图中包含 Repositories 和 Environment 的对话框

按照从 Web 创建的步骤操作，并在对话框的主视图中（而不是在 Advanced settings 下）填写各个字段。此对话框仅创建 Claude Code 任务。

请在添加 GitHub 事件触发器之前选择仓库，因为在选择仓库之前该触发器不可用。

从 CLI 创建

在任意会话中运行 /schedule，即可通过对话方式创建定时任务。您也可以直接传入描述，例如定期任务 /schedule daily PR review at 9am 或一次性任务 /schedule clean up feature flag in one week。Claude 会逐步收集与 Web 对话框相同的信息，然后将任务保存到您的账户。该命令也可以通过别名 /routines 使用。

成功启动时看起来像一次对话：Claude 会在保存前询问有关计划、仓库和提示词的后续问题。如果 Claude 反而回复说您需要进行身份验证，或者无法连接到您的远程 claude.ai 账户，则表示未创建定时任务；请参阅故障排除。

使用 /schedule 创建的任务带有计划触发器。您还可以添加其他类型的触发器：

  • API 触发器：在 Web 端的 claude.ai/code/routines 编辑任务
  • GitHub 触发器：在 Web 端编辑任务，或在 CLI 中询问 Claude。从 CLI 添加需要 Claude Code v2.1.225 或更高版本

没有计划触发器的定时任务（例如仅由 API 调用或 GitHub 事件启动的任务）没有下次运行时间。当 Claude 保存或更新此类任务时，CLI 不会显示下次运行时间。在 v2.1.211 之前，CLI 会为这些任务报告一个位于公元 1 年的下次运行时间。

配置触发器

当定时任务的某个触发器匹配时，任务即会启动。您可以随时在任务编辑对话框的 Trigger 行中添加或移除任务的触发器。

当一个任务有两个或更多触发器时，每个触发器在该对话框中都有一个垃圾桶图标。要移除计划触发器或 GitHub 事件触发器，请点击其垃圾桶图标，然后点击 Save changes。要移除 API 触发器，请改为删除其令牌。

添加计划触发器

计划触发器按定期节奏运行任务，或在未来某个特定时间运行一次。在 Web 端任务的创建或编辑对话框中，选择一个预设频率，例如每小时、每天或每周：

  • 时区：时间以您的本地时区输入并自动转换，因此无论云基础设施位于何处，任务都会在该当地时间运行。
  • 整点运行：如果您将运行安排在整点（例如 9:00），它可能会晚几分钟才开始。要在接近计划时间时开始，请选择整点后几分钟，例如 9:07。
  • 自定义间隔：对于每两小时这样的自定义间隔，请在对话框中选择最接近的预设，然后在 CLI 中运行 /schedule update 以设置特定的 cron 表达式。最小间隔为一小时；运行频率更高的表达式会被拒绝。

安排一次性运行

一次性计划会在特定时间戳运行任务一次。例如，您可以用它来：

  • 在本周晚些时候提醒自己
  • 在发布完成后打开一个清理 PR
  • 在上游更改发布后启动后续工作

任务运行后，它会自行关闭，Web UI 会将其标记为 Completed。要再次运行它，请在 Web 端打开任务的编辑对话框（对于一次性任务，该对话框提供 One-time 选项），并设置新的时间。

在 CLI 中用自然语言描述时间即可创建一次性运行。Claude 会根据当前时间解析该短语，并在保存前确认绝对时间戳。

/schedule tomorrow at 9am, summarize yesterday's merged PRs

/schedule in 2 weeks, open a cleanup PR that removes the feature flag

与定期计划相同的本地时间到 UTC 的转换同样适用于一次性时间戳。

一次性运行与其他计划运行计入相同的每小时限制。详情请参阅用量和限制。

添加 API 触发器

API 触发器为定时任务提供一个专用的 HTTP 端点。使用任务的 Bearer 令牌向该端点发送 POST 请求，会启动一个新会话并返回会话 URL。您可以借此将 Claude Code 接入警报系统、部署流水线、内部工具，或任何可以发出经过身份验证的 HTTP 请求的地方。

您可以在 Web 端添加 API 触发器，既可以在创建任务时添加，也可以稍后按照以下步骤添加。您无法在 CLI 中添加 API 触发器或管理其令牌。

1. 打开任务进行编辑

访问 claude.ai/code/routines，点击您要通过 API 触发的定时任务，然后打开其名称旁边的菜单并选择 Edit。随后会打开 Edit scheduled task 对话框。

2. 添加 API 触发器

在 Trigger 行中，点击 +，然后从打开的菜单中选择 API。随后会出现一个面板，显示此任务的 Fire URL 和 Token。

3. 复制 URL 并生成令牌

复制 Fire URL。点击 Generate token，然后立即从 Token generated 对话框中复制令牌。令牌仅显示一次，之后无法再次获取，因此请将其存储在安全的位置，例如您警报工具的密钥存储中。

生成令牌后，API 触发器即刻生效。您无需点击 Save changes，完成后直接关闭对话框即可。

4. 调用端点

向该 URL 发送 POST 请求时，请在 Authorization: Bearer 标头中发送令牌。触发定时任务展示了一个完整示例。

每个定时任务都有自己的令牌，仅限于触发该任务。要关闭 API 访问或轮换令牌，请再次打开任务的 Edit scheduled task 对话框。这两个控件都位于 API 触发器面板中令牌的旁边，并会立即生效：

  • 关闭 API 访问：点击 Delete token，即 Regenerate 旁边的垃圾桶图标。这会移除 API 触发器
  • 轮换令牌：点击 Regenerate。之前的令牌会失效，Token generated 对话框会显示一次新令牌

触发定时任务

向 /fire 端点发送 POST 请求，并在 Authorization 标头中包含 Bearer 令牌。请求体接受一个可选的 text 字段，用于提供特定于本次运行的上下文（例如警报正文或失败日志），它会与任务已保存的提示词一起传递给任务。该值是自由格式文本，不会被解析：如果您发送 JSON 或其他结构化数据，任务会将其作为字面字符串接收。

text 值不会以裸消息的形式传递给 Routine。它会被包装在一个 <routine-fire-payload> 块中，该块将其标记为不受信任的数据，并告诉 Claude 不要遵循其中的指令，除非 Routine 自身的提示词要求这样做。在 Web UI 中通过 Run now 提供的文本也适用相同的包装。

这意味着 Routine 的已保存提示词必须明确选择对触发文本采取行动：编写提示词时要显式引用该负载，例如"Investigate the alert described in the routine-fire-payload block"，否则 Routine 会将该文本视为惰性上下文。任何持有 Bearer 令牌的人都可以发送 text，因此该包装可确保来自泄露令牌的触发文本被标记为不受信任的数据，而不是作为对您 Routine 的直接指令。

以下示例从 shell 触发定时任务。其中显示的任务 ID 和令牌均为占位符：请将它们替换为您在添加 API 触发器时复制的 URL 和令牌，否则请求会失败并返回 401 身份验证错误：

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."}'

成功的请求会返回一个包含新会话 ID 和 URL 的 JSON 响应体：

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

在浏览器中打开会话 URL，即可实时观看运行、审查更改或手动继续对话。

[!WARNING]

/fire 端点在 experimental-cc-routine-2026-04-01 beta 标头下发布。在该功能处于研究预览阶段期间，请求和响应的结构、速率限制以及令牌语义都可能发生变化。破坏性更改会在新的带日期 beta 标头版本下发布，并且最近的两个旧标头版本会继续可用，以便调用方有时间迁移。

API 参考

有关完整的 API 参考，包括所有错误响应、验证规则和字段限制，请参阅 Claude Platform 文档中的 Trigger a routine through the API。

/fire 端点仅供 claude.ai 用户使用，不属于 Claude Platform API 接口的一部分。

添加 GitHub 触发器

当已连接的仓库上发生匹配事件时，GitHub 触发器会自动启动一个新会话。Claude Code 不会在不同事件之间复用会话，因此两次 PR 更新会产生两个独立的会话。

[!NOTE]

GitHub webhook 事件受每个任务和每个账户的每小时上限约束。超出限制的事件会被丢弃，直到时间窗口重置。

无论您从哪个使用入口配置触发器，都必须在要订阅的仓库上安装 Claude GitHub App。

  • 在 Web UI 中配置 GitHub 触发器时，如果缺少该应用，系统会提示您安装。按照以下步骤在 Web 端进行配置。
  • 在 CLI 中，请先从 GitHub App 页面安装该应用，然后让 Claude 将 GitHub 触发器附加到现有的定时任务，例如 /schedule add a GitHub trigger to my nightly review for pull requests opened in acme/webapp。CLI 方式需要 Claude Code v2.1.225 或更高版本。Claude 添加触发器后，会回复一个指向该触发器所触发任务的链接。

1. 打开任务进行编辑

访问 claude.ai/code/routines，点击该定时任务，然后打开其名称旁边的菜单并选择 Edit。随后会打开 Edit scheduled task 对话框。

2. 添加 GitHub 事件触发器

在 Trigger 行中，点击 +，然后从打开的菜单中选择 GitHub event。

[!NOTE]

在 CLI 中运行 /web-setup 会授予克隆仓库所需的访问权限，但它不会安装 Claude GitHub App，也不会启用 webhook 投递。

3. 配置触发器

如有需要，更改仓库，从支持的事件列表中选择一个事件，并可选择添加筛选条件。然后点击对话框底部的 Save changes 以应用该触发器。

支持的事件

GitHub 触发器可以订阅以下任一事件类别。在每个类别中，您可以选择特定操作（例如 pull_request.opened），也可以响应该类别中的所有操作。

事件 触发时机
Pull request PR 被打开、关闭、分配、添加标签、同步或以其他方式更新
Release 发布被创建、发布、编辑或删除

筛选 Pull Request

使用筛选条件来限定哪些 Pull Request 会启动新会话。所有筛选条件都必须匹配，定时任务才会触发。可用的筛选字段如下：

筛选条件 匹配内容
Author PR 作者的 GitHub 用户名
Title PR 标题文本
Body PR 描述文本
Base branch PR 的目标分支
Head branch PR 的来源分支
Labels 应用于 PR 的标签
Is draft PR 是否处于草稿状态
Is merged PR 是否已合并

每个筛选条件都将一个字段与一个运算符配对：equals、contains、starts with、is one of、is not one of 或 matches regex。

matches regex 运算符会测试整个字段值，而不是其中的子字符串。要匹配任何包含 hotfix 的标题，请写成 .*hotfix.*。如果没有前后的 .*，该筛选条件只会匹配恰好为 hotfix、前后没有任何内容的标题。如需不使用正则表达式语法的字面子字符串匹配，请改用 contains 运算符。

一些筛选条件组合示例：

  • Auth module review：base branch 为 main，head branch contains auth-provider。将任何涉及身份验证的 PR 发送给专门的审查者。
  • Ready-for-review only：is draft 为 false。跳过草稿，使任务仅在 PR 准备好审查时运行。
  • Label-gated backport：labels 包含 needs-backport。仅当维护者为 PR 添加该标签时，才触发移植到另一个分支的任务。

管理定时任务

在列表中点击某个定时任务即可打开其详情页。详情页会显示该任务的仓库、连接器、提示词、计划、API 令牌、GitHub 触发器以及过往运行的列表。

查看运行并与之交互

点击任意运行即可将其作为完整会话打开。在那里，您可以查看 Claude 执行了哪些操作、审查更改、创建 Pull Request 或继续对话。每个运行会话的用法与其他会话相同：使用会话标题旁边的下拉菜单对其进行重命名、归档或删除。

[!NOTE]

运行列表中的绿色状态表示会话已启动并退出，且没有出现基础设施错误。这并不表示提示词中描述的工作已成功完成。请打开该运行阅读会话记录，确认 Claude 实际执行了哪些操作。被阻止的网络请求、缺失的连接器工具以及工作本身的失败都会显示在会话记录中，而不会体现在状态指示器中。

编辑和控制定时任务

在详情页中，您可以：

  • 点击 Run now 立即启动一次运行，而无需等待下一个计划时间。
  • 使用页面顶部的开关暂停或恢复计划。已暂停的任务会保留其配置，但在您重新打开之前不会运行。
  • 打开任务名称旁边的菜单并选择 Edit，以更改名称、提示词、仓库、环境、连接器或任务的任何触发器。随后会打开 Edit scheduled task 对话框，其布局与创建对话框相同。要添加触发器，请点击 Trigger 行中的 +。点击 Save changes 以应用您的编辑。API 令牌操作会立即生效，无需点击 Save changes。
  • 打开同一菜单并选择 Delete 以删除该任务。

从 CLI 管理定时任务

运行 /schedule list 可查看您的定时任务，运行 /schedule update 可更改某个任务，运行 /schedule run 可立即启动某个任务。

您还可以询问某个定时任务的运行历史，例如 /schedule why did my nightly review do nothing this morning?。Claude 会列出该任务最近的运行及其状态，并附上在 Web 端打开每次运行的链接。它还会读取运行日志来解释发生了什么，包括工具错误、权限拒绝和最终结果。需要 Claude Code v2.1.227 或更高版本。

仓库和分支权限

定时任务需要 GitHub 访问权限才能克隆仓库。当您在 CLI 中使用 /schedule 创建定时任务时，Claude 会检查您的账户是否拥有对您运行该命令所在仓库的 GitHub 访问权限。如果没有，Claude 会添加一条设置说明，指明如何授予访问权限。

[!NOTE]

请参阅 GitHub 身份验证选项，了解授予访问权限的两种方式。在 Team 和 Enterprise 套餐中，必须由您 Claude 组织的 Owner 先启用每种方式，您才能使用；请参阅连接 GitHub。

如果在某次运行到期时您的 GitHub 连接缺失或已过期，定时任务会跳过运行，直到您重新连接为止，最长持续 72 小时。在此期间内重新连接 GitHub，任务会自行恢复。如果 72 小时后仍未连接，任务将被关闭，您需要在重新连接 GitHub 后再将其重新打开。

您添加的每个仓库都会在每次运行时被克隆。除非您的提示词另有指定，否则 Claude 会从仓库的默认分支开始。如果运行由 GitHub Pull Request 事件触发，且该 Pull Request 所在的仓库是任务中的第一个仓库，则该仓库会改为从 Pull Request 的 head 提交开始。

除非您的提示词指示 Claude 推送到其他分支，否则 Claude 会将其工作推送到以 claude/ 为前缀的分支。要控制运行可以推送到哪些分支，请在 GitHub 上使用分支保护规则或规则集。对于在 Anthropic 托管基础设施上的运行，以及通过 Anthropic 的 git 代理推送的自托管运行，GitHub 会将这些规则应用于您所连接的 GitHub 访问权限，因此该访问权限可以绕过的规则不会阻止运行的推送。使用您的部署所提供的 git 凭据进行推送的自托管运行，则会依据这些凭据进行检查。请参阅配置 git。

连接器

定时任务可以在每次运行期间使用您已连接的 MCP 连接器来读取和写入外部服务。例如，一个对支持请求进行分诊的任务可能会从 Slack 频道读取内容，并在 Linear 中创建问题。

连接器是您账户中的 claude.ai 集成。您在 CLI 中使用 claude mcp add 在本地添加的 MCP 服务器存储在您的计算机上，而不是您的 claude.ai 账户中，因此它们不会出现在连接器列表中。要在定时任务中使用其中某个服务器：

  • 作为连接器：在 claude.ai/customize/connectors 将其添加为连接器
  • 在仓库中：对于只有一个仓库的定时任务，您也可以改为在已提交的 .mcp.json 中声明该服务器，使其成为所克隆仓库的一部分

创建定时任务时，默认会包含您当前已连接的所有连接器。请移除不需要的连接器，以限制 Claude 在运行期间可以访问的工具。您也可以直接在任务的创建或编辑对话框中添加连接器。

要在该对话框之外管理或添加连接器，请访问 claude.ai/customize/connectors，或在 CLI 中使用 /schedule update。

运行在未询问的情况下发布 Artifact 的情形

当定时任务的计划或 Run now 启动一次运行时，Claude 可以在不询问的情况下发布新的 Artifact。在您共享它之前，新的 Artifact 仅对您可见。如果发布操作为页面声明了运行时能力，例如连接器调用或文件下载，Claude 会先询问。

在这些运行中，只有当以下所有条件都满足时，Claude 才会在不询问的情况下重新发布现有的 Artifact：

  • 您可以编辑该 Artifact，且它属于您自己的组织
  • 如果发布内容不止页面本身（例如附带支持文件），则您是该 Artifact 的所有者
  • 该 Artifact 未公开共享
  • 如果该 Artifact 已与特定人员或您的组织共享，其查看者不会自动看到每个新版本
  • 发布操作不会强制覆盖较新的版本
  • 发布操作未为页面声明运行时能力
  • 现有页面不持有任何超出页面范围的授权，例如连接器调用

在所有其他情况下，包括由 API 或 GitHub 触发器启动的运行，Claude 都会先询问。

如果定时任务的工作是保持某个页面处于最新状态，请为其提供一个您已经发布的 Artifact。

环境和网络访问

每个定时任务都使用一个云环境，用于控制网络访问、环境变量和设置脚本。任务在每次运行时都会继承该环境的网络策略。

Default 环境使用 Trusted 网络访问，仅允许默认允许列表中的主机通过会话的网络。通过该路径向允许列表以外主机发出的请求会失败，并返回 403 和 x-deny-reason: host_not_allowed。MCP 连接器流量通过 Anthropic 的服务器路由，而不经过该路径，因此您添加到任务中的连接器无需将其主机添加到 Allowed domains 即可正常工作。请在连接器下移除您不需要的任何连接器。

要在您自己的某个环境中允许更多域名，请按照以下步骤操作。组织共享环境在此处以只读方式打开，因此需要由 Owner 在管理设置的 Cloud environments 页面中更改其网络访问。

1. 打开任务进行编辑

访问 claude.ai/code/routines，点击该定时任务，然后打开其名称旁边的菜单并选择 Edit。随后会打开 Edit scheduled task 对话框。

2. 打开环境选择器

前往 Advanced settings > General > Cloud environment，如果 Advanced settings 处于折叠状态，请先将其展开。点击显示您环境名称（例如 Default）的云图标。

3. 打开环境设置

将鼠标悬停在列表中的环境上，然后点击右侧出现的设置图标。

4. 更改网络访问级别

在 Edit cloud environment 对话框中，将 Network access 更改为 Custom，并在 Allowed domains 中输入您的域名。勾选 Also include default list of common package managers，以便在自定义域名之外保留默认允许列表。如需不受限制的访问，请改为选择 Full。

5. 保存

在 Edit cloud environment 对话框中点击 Save changes，然后关闭其后方的 Edit scheduled task 对话框。新策略将从下一次运行开始生效。

有关访问级别和默认允许列表的详细信息，请参阅网络访问。

用量和限制

定时任务与交互式会话以相同的方式消耗订阅用量。您可以在 claude.ai/settings/usage 查看当前的消耗情况。

除订阅用量外，每种启动运行的方式都有每小时限制：

操作 限制 计数对象 超出限制时
计划运行，包括一次性运行 每小时 100 次 您的账户 运行会等待，直到限制重置
Run now、API 触发以及将一次性任务设置为再次运行 每小时 30 次 每个定时任务，三者共用一个计数 操作失败，直到限制重置
Run now 以及将一次性任务设置为再次运行 每小时 100 次 您的账户 同上
API 触发 每小时 100 次 您的账户，与 Run now 分开计数 同上
GitHub 事件 请参阅添加 GitHub 触发器

这些每小时限制均不提供超额使用。

当定时任务达到您的订阅用量限制时，已启用使用额度的组织可以继续以计量超额方式运行定时任务。如果没有使用额度，额外的运行会被拒绝，直到您的用量窗口重置。请在 claude.ai/settings/usage 启用使用额度。在 Team 和 Enterprise 套餐中，由管理员在 claude.ai/admin-settings/usage 为组织启用使用额度。

在您的订阅暂停期间，您的定时任务会被挂起且不会运行。订阅恢复后，请将它们重新打开。

Routine 名称仍出现的位置

定时任务以前称为 Routine，以下位置仍保留这一旧名称。它们指的都是同一项功能：

  • 网址：claude.ai/code/routines
  • CLI：/schedule 的别名 /routines、该命令的描述，以及 Claude 在设置任务时的回复
  • API：/fire 端点路径、其 beta 标头、其响应中的 type、<routine-fire-payload> 标签，以及 Trigger a routine through the API 参考页面
  • 组织设置：Scheduled tasks (Was Routines) 开关

故障排除

/schedule 返回 "Unknown command"

当某项要求未满足时，CLI 会隐藏 /schedule：您输入时命令菜单会显示 No commands match "/schedule"。提交该命令会返回 Unknown command: /schedule，但下文注明会给出不同回复的情况除外。

原因通常是以下之一：

  • 您使用 Console API 密钥、Anthropic profile 或联合凭据，或者 Amazon Bedrock、Google Cloud 的 Agent Platform 或 Microsoft Foundry 等云提供商进行身份验证。/schedule 需要使用 claude.ai 订阅登录。使用 Console API 密钥或 profile 且启用了功能标志获取时，提交 /schedule 会改为显示 /schedule is available with Claude for Enterprise — ask your admin about migrating from API-key access。使用云提供商登录时，您仍会看到 Unknown command: /schedule。如果您的 shell 中设置了 ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN，或者 settings.json 中设置了 apiKeyHelper，请先将其移除，因为它们优先于 claude.ai 登录。profile 或联合凭据同样具有优先级，因此也请将其关闭
  • 您已完全退出登录，没有 API 密钥或其他凭据。启用功能标志获取时，提交 /schedule 会显示 /schedule requires a claude.ai subscription. Run /login to sign in with your claude.ai account. 在 v2.1.268 之前，已退出登录的会话会显示与 Console API 密钥相同的 Claude for Enterprise 消息
  • 您处于云端会话中，此时提交 /schedule 会回复该命令在该环境中不可用。请改为在 Web UI 中管理定时任务
  • 您组织的策略禁用了定时任务所需的云端会话。在这种情况下，提交 /schedule 会改为回复 Cloud sessions are disabled by your organization's policy。在 v2.1.268 之前，它会返回 Unknown command: /schedule
  • Owner 为您的 Team 或 Enterprise 组织关闭了定时任务。在 v2.1.227 之前，这种情况下命令仍会显示，而当 Claude 尝试创建或运行任务时，claude.ai 会拒绝该任务

除非您组织的策略禁用了定时任务或云端会话，否则无论 CLI 如何配置，您都可以在 claude.ai/code/routines 创建和管理定时任务。

"Routines are disabled by your organization's policy"

您 Team 或 Enterprise 组织中的 Owner 可能已在 Organization settings > Capabilities > Remote sessions 关闭了 Scheduled tasks (Was Routines) 开关。在 Claude Code v2.1.227 或更高版本中，同一开关还会在 CLI 中隐藏 /schedule。这是一项服务器端的组织设置，因此无法通过您的本地配置覆盖。请联系 Owner 为您的组织重新启用定时任务。

相关资源

  • /loop 和会话内调度：在打开的 CLI 会话中安排本地任务
  • Desktop 定时任务：在您的计算机上运行、可访问本地文件的本地定时任务
  • 云环境：为云端会话配置网络访问、环境变量和设置脚本
  • Projects：Claude 跨并行云端会话协调的持续性工作；从项目创建的定时任务会显示在其 Scheduled tasks 标签页上
  • MCP 连接器：连接 Slack、Linear 和 Google Drive 等外部服务
  • GitHub Actions：在 CI 流水线中针对仓库事件运行 Claude