在日常开发与运维工作中，许多任务需要周期性地执行，例如每日代码审查、夜间 CI 故障分析、文档同步或依赖审计等。Claude Code 提供的定时任务功能，能够利用 Anthropic 托管的基础设施，以预设的频率自动运行提示词（Prompt），即使您的计算机处于关闭状态，任务也能可靠执行。

这项功能面向所有 Claude Code 用户开放，包括 Pro、Max、Team 和 Enterprise 版本。

核心功能概览：Claude Code 定时任务的多种选择

Claude Code 提供了三种方式来安排周期性工作，以适应不同的使用场景。理解它们的区别有助于您选择最合适的方案：

特性/选项 云端定时任务 (Cloud Tasks) 桌面端定时任务 (Desktop Tasks) CLI /loop 命令
运行位置 Anthropic 云端 您的本地机器 您的本地机器
是否要求机器开机 否 是 是
是否要求会话开启 否 否 是
重启后持久性 是 是 否 (会话限定)
本地文件访问 否 (全新克隆) 是 是
MCP 连接器 每个任务单独配置 配置在配置文件和连接器中 继承自当前会话
权限提示 否 (自主运行) 可按任务配置 继承自当前会话
可定制化调度 通过 CLI /schedule 命令 是 是
最小时间间隔 1 小时 1 分钟 1 分钟
典型应用场景 无需本地机器、需可靠运行的任务 需访问本地文件和工具的任务 会话期间的快速轮询

选择建议：

  • 云端定时任务： 适用于需要高度可靠性，且无需依赖您本地机器的任务。
  • 桌面端定时任务： 当任务需要访问本地文件或工具时选用。
  • /loop 命令： 适合在当前会话中进行快速、临时的轮询操作。

创建定时任务：一步步指南

您可以通过三种途径创建定时任务：Web 界面、桌面应用程序或命令行界面（CLI）。本文将重点介绍通过 Web 界面创建的详细步骤。

  1. 打开创建表单 访问 claude.ai/code/scheduled，点击“新建定时任务”（New scheduled task）。

  2. 命名任务并编写提示词 为任务设定一个描述性的名称，并编写 Claude 每次运行时将执行的提示词。提示词是任务的核心，它必须是自包含的，清晰地说明任务目标和成功的标准，因为任务将自主运行。您还可以在提示词输入框中选择任务将使用的模型。

  3. 选择代码仓库与分支权限 为 Claude 添加一个或多个 GitHub 仓库。每次任务运行时，Claude 都会从默认分支克隆这些仓库。Claude 创建的任何更改都将推送到以 claude/ 为前缀的新分支。 如果需要允许对任何分支进行推送（包括受保护分支），请勾选该仓库的“允许无限制分支推送”（Allow unrestricted branch pushes）选项。

  4. 配置运行环境 选择一个云端运行环境。环境决定了云端会话的访问权限：

    • 网络访问： 控制每次运行期间的互联网访问级别。
    • 环境变量： 提供 API 密钥、令牌或其他敏感信息供 Claude 使用。
    • 设置脚本： 在每次会话开始前运行安装命令，如安装依赖或配置工具。 系统提供一个“默认环境”（Default environment），您也可以在创建任务前配置自定义环境。

  5. 设定任务频率 从预设的频率选项中选择任务的运行周期。默认设置为每天上午 9:00（您的本地时区）。任务可能会因错开运行（stagger）而比预定时间晚几分钟启动。 如果预设选项不满足需求，可以选择最接近的，然后通过 CLI 命令 /schedule update 进行更精细的自定义调度。

  6. 管理连接器 所有已连接的 MCP 连接器默认都会包含在任务中。请移除任务不需要的连接器，以限制 Claude 在运行期间可访问的外部服务。连接器允许 Claude 访问 Slack、Linear 或 Google Drive 等外部服务。

  7. 完成创建 点击“创建”（Create）。新任务将出现在定时任务列表中，并在下一个预定时间自动运行。每次运行都会创建一个新的会话，您可以在其中查看 Claude 的操作、审查更改并创建拉取请求。 要立即触发一次运行，请在任务详情页面点击“立即运行”（Run now）。

深入理解任务配置项

灵活的频率选项

调度器提供了多种预设频率，并能自动处理时区转换。您只需选择本地时间，任务便会根据该时间执行，而无需考虑云基础设施的实际物理位置。任务可能会比预定时间晚几分钟启动，但这种延迟对每个任务而言都是一致的。

  • 每小时（Hourly）： 每小时运行一次。
  • 每天（Daily）： 每天在您指定的时间运行一次（默认为本地时间上午 9:00）。
  • 工作日（Weekdays）： 与“每天”相同，但会跳过周六和周日。
  • 每周（Weekly）： 每周在您指定的日期和时间运行一次。

对于更复杂的自定义间隔，例如“每 2 小时”或“每月第一天”，请选择最接近的预设选项，然后使用 CLI 命令 /schedule update 来设置精确的调度。

代码仓库与分支权限

每次任务运行时，Claude 都会克隆您指定的代码仓库。除非您的提示词另有说明，Claude 将从仓库的默认分支开始操作。 默认情况下，Claude 只能将更改推送到以 claude/ 为前缀的分支。这是为了防止定时任务意外修改受保护或长期存在的分支。 要为特定仓库移除此限制，请在创建或编辑任务时启用“允许无限制分支推送”（Allow unrestricted branch pushes）选项。

连接器 (Connectors)

定时任务可以使用您已连接的 MCP 连接器，在每次运行期间读写外部服务。例如，一个用于分类支持请求的任务可以从 Slack 频道读取信息并在 Linear 中创建问题。 创建任务时，所有当前已连接的连接器都会默认包含。请移除任务不需要的连接器，以限制 Claude 在运行期间可访问的工具。您也可以直接从任务表单中添加连接器。 如需在任务表单之外管理或添加连接器，请访问 claude.ai 上的“设置 > 连接器”（Settings > Connectors），或使用 CLI 命令 /schedule update。

运行环境 (Environments)

每个任务都在一个云端环境中运行，该环境控制着网络访问、环境变量和设置脚本。在创建任务之前配置环境，可以赋予 Claude 访问特定 API 的权限，安装必要的依赖项，或限制网络范围。

管理与控制定时任务

在定时任务列表中点击任意任务，即可进入其详情页面。该页面会显示任务的仓库、连接器、提示词、调度信息以及过往的运行记录。

查看与交互任务运行

点击任何一次运行，即可将其作为完整的会话打开。在此会话中，您可以查看 Claude 执行的操作、审查更改、创建拉取请求，或继续与 Claude 交互。每次运行会话的操作方式与其他会话相同：使用会话标题旁的下拉菜单可以重命名、归档或删除会话。

编辑与控制任务

在任务详情页面，您可以执行以下操作：

  • 立即运行： 点击“立即运行”（Run now）可立即启动任务，无需等待下一个预定时间。
  • 暂停/恢复： 在“重复”（Repeats）部分使用切换按钮暂停或恢复任务调度。暂停的任务会保留其配置，但在您重新启用之前不会运行。
  • 编辑任务： 点击编辑图标可以修改任务名称、提示词、调度、仓库、环境或连接器。
  • 删除任务： 点击删除图标可以移除任务。请注意，任务创建的过往会话仍会保留在您的会话列表中。

您也可以通过 CLI 命令 /schedule 来管理任务：

  • 运行 /schedule list 查看所有任务。
  • 运行 /schedule update 修改任务。
  • 运行 /schedule run 立即触发任务。

结语

Claude Code 的定时任务功能为开发者提供了一个强大而灵活的自动化工具，能够显著提高工作效率，确保关键任务的可靠执行。通过合理配置云端环境、连接器和调度选项，您可以构建出高度定制化的自动化工作流，让 Claude 成为您团队的得力助手。

👉 如果你需要 ChatGPT 代充 / Claude / Claude Code / 镜像 / 中转 API：