加载中

定时任务与无头模式

第 6 课7 分钟
加载中

定时任务与无头模式

一旦您信任Claude能完成某项任务,下一步就是不再手动操作它。如果是同一个提示在一个反复出现的触发条件下运行,您就不应该每次都坐在那里自己去启动它。本课介绍了两种将这项工作交出去的方法:云端定时任务(以前称为routines),您无需构建任何东西;以及无头模式,您可以通过自己的脚本获得完全控制权。

可以把它想象成一个光谱。在一端,您有在Anthropic托管基础设施上运行的云端定时任务。在另一端,您有无头模式和Agent SDK,它们从您自己的代码中运行Claude Code。让我们从您构建最少的那一端开始。

定时任务:一个在云端运行的已保存提示

云端定时任务是自动化重复性工作最直接的方法。它不需要脚本,也不需要服务器。它将三样东西打包在一起:一个提示、它所操作的代码仓库,以及它所需要的任何连接器。然后,每当被触发时,它就会在云端运行这个打包内容。

关键之处在于,基础设施是Anthropic的。没有您自己的机器需要彻夜开着,也没有需要您维护的工作流文件。您只需描述一次任务,它就会自动运行。

定时任务并不一定需要一个时间安排。它可以在几种类型的触发条件下启动:

  • 一个cron计划,比如每天早上9点。
  • 发送到其API端点的HTTP POST请求,这样您自己的代码就可以启动它。
  • 一个GitHub事件,比如一个新的拉取请求(pull request)到来。

任何在反复出现的触发条件下使用同一个提示的工作都很适合这种方式。比如早间依赖项审计。比如在新拉取请求到来时启动的PR分类器。比如每天扫描您的Sentry工单,以找出最紧急的事项。

这是定时任务将各部分联系在一起的思维模型:一个提示、代码仓库、连接器,以及一个触发条件。

两种创建方式

您可以在网页端 claude.ai/code/routines 上创建一个定时任务。您为它取一个名字,写下描述Claude在每次会话中应该做什么的指令,选择一个代码仓库,并选择一个触发条件。

您也可以在Claude Code内部创建,而无需离开您的终端。只需运行 /schedule 命令,并用日常语言描述您想要的内容,例如:

/schedule 每天上午9点进行依赖项审计

两种入口点背后的理念相同。选择适合您工作流程的那一种即可。

在依赖云端定时任务之前需要了解的三件事

在将任何重要事项依赖于云端定时任务之前,请牢记这三个限制。

  • 云端定时任务目前处于研究预览阶段。 其行为和限制会持续变化,因此如果情况有所改变,请不要感到意外。
  • 循环计划最多每小时运行一次。 如果您需要更高频率的运行,云端定时任务就不是合适的工具。
  • 除非您的提示中指定了其他分支,否则运行会从您默认分支的一个全新克隆开始,并推送到一个 claude/ 分支。 当GitHub拉取请求事件触发运行时,只要该拉取请求的代码仓库是定时任务中的第一个代码仓库,运行就会改为从该拉取请求的头部提交(head commit)开始。要控制一次运行可以推送到哪些分支,请在GitHub上使用分支保护规则或规则集。GitHub会将这些规则应用到您所连接的GitHub访问权限上,因此,如果您的访问权限可以绕过某条规则,该规则就无法阻止此次推送。

无头模式:当您需要自己的环境时

当工作可以在Anthropic的基础设施上运行时,云端定时任务非常好用。但有时任务需要您自己的环境,或者需要围绕运行过程封装一些逻辑。这时您就需要降级到无头模式,文档中现在称之为非交互模式。

无头模式的核心是 -p 标志(--print 的缩写)。它将Claude Code作为一次性命令运行,没有交互式界面。它读取标准输入并写入标准输出,因此它可以像任何其他shell工具一样进行管道传输:

claude -p "summarize the changes in this diff"

有一点值得了解:单独使用时,-p 会加载与交互式会话相同的上下文,包括钩子(hooks)、技能(skills)、插件(plugins)、MCP服务器,以及CLAUDE.md文件。要跳过所有这些,请添加 --bare,下文会介绍。

获取结构化输出

由于无头模式可以像任何shell工具一样进行管道传输,您通常会希望得到结构化数据而非散文式文本作为返回。您可以将一个JSON schema与JSON输出格式配对使用,Claude会将其输出约束为符合您的schema。

与您的schema匹配的对象会出现在JSON响应的 structured_output 字段中。因此,您可以用一条 jq 命令将其提取出来,并将其传输到数据库或另一个脚本中:

bash
claude -p "Extract the exported function names from src/core/style.js" \
  --output-format json \
  --json-schema '{"type":"object","properties":{"functions":{"type":"array","items":{"type":"string"}}},"required":["functions"]}' \
  | jq '.structured_output.functions'

这样您就能得到一个干净的数组,可以交给接下来的任何处理环节。

使用会话实现多步骤自动化

对于跨多个步骤进行的工作,您不必把所有内容都塞进一条命令里。从JSON输出中捕获会话ID,以便之后恢复该会话:

claude --resume "$(jq -r .session_id /tmp/plan.json)"

一个脚本启动工作,另一个脚本稍后携带完整上下文恢复该工作。当第一轮生成一个计划、第二轮负责执行时,这种方式非常方便。

为CI提供一致的运行

当CI需要在每台机器上使用相同的设置时,有一种专门为此构建的模式。

--bare 标志会跳过对钩子、技能、插件、MCP服务器以及CLAUDE.md文件的自动发现。您得到的Claude具备Bash、文件读取和文件编辑工具,外加您通过诸如 --settings 或 --mcp-config 之类的标志传入的任何内容。这样一来,每台机器都从相同的设置开始,启动速度也更快。Bare模式不使用您的订阅登录,因此请先设置 ANTHROPIC_API_KEY。

Agent SDK:在您自己的应用中使用Claude Code

光谱上的最后一步是Agent SDK。它为您提供了一个库,可以将Claude Code嵌入到您自己的TypeScript或Python应用程序中。

这两种语言都暴露了一个 query 函数,以及与CLI相同的原语(primitives)。您传入一个提示加上一些选项,比如:

  • allowedTools,用于控制Claude可以做什么,
  • 一个系统提示,
  • 以及一个权限模式。

然后,您遍历Claude流式返回的消息,并按照您的应用程序所需的方式处理它们。这与CLI是同一个引擎,只是可以从您的产品内部调用。

您应该选择哪一种?

这是一份快速决策指南:

  • 云端定时任务 是处理重复性工作的默认选择。它们运行在Anthropic的基础设施上,您无需托管任何东西。
  • 使用 -p 的无头模式 适用于任务需要您自己的流水线,并且您想通过脚本传输数据的情况。
  • --bare 适用于CI需要在每台机器上使用相同设置的情况。
  • Agent SDK 适用于工作属于您自己产品内部的情况。

从云端定时任务开始。只有当任务需要额外的控制权时,才沿着光谱向下移动。