Claude Code · 官方入门

四类循环原语

官方定义：循环 = 智能体重复干活，直到满足停止条件。按「怎么触发 / 怎么停 / 用哪个原语 / 适合啥任务」分成四类。

不是所有任务都要复杂循环——从最简单的开始，有选择地用。下面四类基本覆盖了飞飞现有的 stack。

源 · Anthropic《Getting started with loops》（老金 译）· 中文方法论见 wiki concepts/claude-code-loop-primitives

01

四类循环

从「你手动引导每回合」到「事件触发、无需你在场」，触发越来越自动、停止越来越靠条件。

1

基于回合

Turn-based
触发用户 prompt
停止Claude 判断完成 / 需更多上下文
适合短任务、不属常规流程
省 token写具体 prompt + skill 编码验证减回合
你的对应 · 日常跟我聊天就是这个。Claude 收集上下文→动手→自查→回复。
2

基于目标

/goal
触发实时手动 prompt
停止目标达成 / 达最大回合
适合有可验证退出条件的任务
省 token设具体完成条件 + 回合上限（"试 5 次停"）
你的对应 · 你那个 goal skill（移植 Codex）。评估器模型盯着，Claude 想提前收工就被打回——跟你「验证器先行」是一回事。
3

基于时间

/loop · /schedule
触发指定时间间隔
停止你取消 / 工作完成（PR 合了、队列空）
适合定期性工作、盯外部系统
省 token拉长间隔，或改成事件响应
你的对应 · 世界杯 14:00 触发器、活档 fanout。/loop 在本机（关机就停）；/schedule 把循环移到云端成例程。
4

主动式

Proactive
触发事件 / 计划，无需实时人工
停止每任务达标即退，例程持续到你关
适合明确定义的重复工作流（bug 分诊 / 迁移 / 依赖升级）
省 token杂活给小快模型，最强模型只用在要判断处
你的对应 · 呼应你 CLAUDE.md 那条「模型干主观活、别干客观活」。上述原语 + 自动模式 + 动态工作流可组合成长期运行的循环。
02

两条护栏

循环输出的质量，取决于它周围的系统。

保持代码质量

  • 代码库本身整洁 → Claude 跟随既有模式约定
  • 给它自我验证的方式 → 用 skill 编码"什么是好的"
  • 文档易获取 → 含最新最佳实践
  • 第二个 agent 做 review → 新鲜上下文偏见小 = 你的 codex-cross-review
  • 单个结果不达标，别只修个案——编码化改进系统

管理 token

  • 选对原语和模型：小任务不需要多 agent
  • 明确成功与停止标准：让它更快收敛（别太快）
  • 大规模前先试点：动态工作流能生成数百 agent
  • 确定性工作用脚本 = 你的"代码能答的别让模型答"
  • 别过频跑例程：间隔匹配监控对象的变化频率
  • 审查用量：/usage · /goal · /workflows
03

怎么开始

看你已经在做的工作，挑一个你是瓶颈的任务，问哪部分能交出去：

  1. 你能写验证检查吗？（→ 能不能用 ② goal）
  2. 目标足够清晰吗？（→ ② 的退出条件）
  3. 工作是否按计划到达？（→ ③/④ 的触发）

有想法就跑，观察哪里卡住或过度延伸，别怕迭代。

循环不是目的——挑一个你在当瓶颈的活，把能交的那段交出去。