1. 为什么 Builder 需要一个能跑起来的 Loop
Loop Engineering 说白了就是让 Agent 自己转起来：你定目标、定裁判、定边界，它自己跑「执行 → 验证 → 修正」这个圈，直到条件满足或者触发退出。它不是一个新命令，而是一套编排思路。适合谁？用过 Claude Code、手里有能自动判定成败的项目（测试、lint、类型检查、构建脚本任意一个都行）、并且愿意 review 产出的 Builder。如果你只是偶尔让 AI 改个函数，写个好 Prompt 更快，别上 Loop。
真正卡住大多数人的不是「Loop 是什么」，而是第一次跑通时那一堆琐碎问题：Key 怎么统一、Base URL 填哪个、模型 ID 写什么、Agent 定义放哪、跑起来报 401 或者local proxy failed怎么查。我试过把同一套 Key 分散在 Claude Code、Cline、Codex 三个工具里，改一次配置要翻三个文件，Loop 还没跑起来人先烦了。所以这篇的路线是：先用 TaoToken 把 Key 和接入点统一，再写第一个最小 Loop，最后做一次完整运行和结果验证。
前置条件先确认清楚，缺一个都会在中间卡住：
- 用过 Claude Code，知道
/命令和CLAUDE.md是干嘛的 - 项目里有能跑的自动化测试，
npm test或pytest至少有一个能出结果 - 装了 GitHub CLI 并且
gh auth status是登录状态（后面查 CI 要用） - Claude Code 是最新版本，
claude --version能正常输出
先拿四个问题问自己。第一，这活是不是每周都要干好几遍？一锤子买卖写 Prompt 更省。第二，有没有东西能自动判定「干砸了」？没有裁判，Loop 吐出来的东西你还得一行行读 diff，那它省了什么。第三，Token 预算扛不扛得住浪费？Loop 会反复读上下文、重试、试探，不出活也照样烧。第四，你打算 review 它产出的代码吗？不打算就别建。
一句话判断标准：如果你发现自己在重复做「给 AI 下指令 → 检查结果 → 再下指令」超过三次，就该考虑写个 Loop 了。下面从统一 Key 开始，一步步把它跑起来。
2. 用 TaoToken 统一 Key 的前置准备
Loop 要跑得稳，第一步是把「模型从哪来」这件事固定下来。Claude Code、Cline、Codex 这些工具各自读各自的配置，如果每个都填一套 Key 和地址，Loop 里 spawn 出来的子 Agent 很容易因为环境不一致而失败。TaoToken 在这里的角色就是一个统一的接入点：一个 Key、一个 Base URL，所有 Agent 工具都指向它，模型 ID 按需切换。
先拿 Key。打开 https://taotoken.net/api-keys ，登录后创建一个 API Key，复制出来先存到安全的地方。注意这个 Key 只在创建时完整显示一次，关掉页面就看不到了，丢了只能重建。拿到之后不要直接写进会提交到 git 的文件里，用环境变量或者本地配置文件。
然后是接入点。TaoToken 的 API 地址是https://taotoken.net/api，注意这里不带任何查询参数，配置里填的就是这个干净的地址。官网入口在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，需要看文档或者进控制台的时候从这走。
模型 ID 这块要特别说清楚，因为这是 401 和 404 之外最常见的坑。不同工具对模型名的写法要求不一样，有的要带前缀有的不要，填错了报错信息往往很含糊。稳妥的做法是先到模型对话页面确认当前可用的模型名，再原样抄进配置。模型对话入口：https://taotoken.net/model-chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite 。
统一 Key 的价值在 Loop 场景里会被放大。因为一个 Loop 可能同时涉及主 Agent、Builder 子 Agent、Checker 子 Agent，如果它们各自读不同的配置源，你排查问题时根本不知道是哪个环节的凭证失效了。全部指向同一个 Base URL 和同一个 Key 之后，出问题只可能是「Key 失效」或「模型名写错」这两类，排查面直接缩小一半。
还有一点，Loop 会长时间、高频次地发请求，所以 Key 的额度管理和限流要提前想。建议单独建一个给 Agent 用的 Key，别和你手动调试用的混在一起，这样烧了多少一目了然。控制台入口：https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite 。
3. 可复制的配置片段：Claude Code 与 Codex 三件套
这一节给可直接抄的配置。核心是三件套：Base URL、Key、Model ID，三个工具都按这个结构填。先看 Claude Code 的 settings 配置，路径是~/.claude/settings.json，如果你用的是项目级配置就是项目根目录下的.claude/settings.json：
{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "sk-你的TaoToken密钥", "ANTHROPIC_MODEL": "claude-sonnet-4-20250514" } }这里三个字段对应三件套：ANTHROPIC_BASE_URL是接入点，ANTHROPIC_AUTH_TOKEN是 Key，ANTHROPIC_MODEL是模型 ID。模型 ID 请以模型对话页面实际显示的为准，上面这个只是示例格式。改完配置后重启 Claude Code，让它重新读环境变量。
如果你用 Codex，配置在~/.codex/auth.json，结构不太一样：
{ "OPENAI_API_KEY": "sk-你的TaoToken密钥", "OPENAI_BASE_URL": "https://taotoken.net/api", "model": "gpt-4.1" }Codex 的字段名是OPENAI_前缀，别和 Claude Code 的ANTHROPIC_混了。两个工具可以同时指向同一个 TaoToken Key，互不影响。
Cline 这类 VS Code 插件走的是图形界面配置，在设置里找 API Provider，选 OpenAI Compatible 或 Anthropic 兼容模式，然后填三件套：Base URL 填https://taotoken.net/api，API Key 填你的 Key，Model ID 填可用模型名。填完点保存，插件会自己发一个测试请求验证连通性。
如果你用 CC Switch 管理多个配置，它的配置文件里同样是这三件套的结构，切换配置本质上就是切换这三个值。Cline MCP 场景下，MCP server 的配置里如果需要调模型，也是把 Base URL 和 Key 指向 TaoToken，Model ID 单独指定。
配置写完先别急着跑 Loop，用一条最简单的请求验证连通。Claude Code 里直接问一句「你好，回复 ok」，能正常返回就说明三件套没问题。这一步过了再往下，能省掉大量「到底是配置错还是 Loop 逻辑错」的纠结。
4. 写第一个 Loop：从单 Agent 到 Builder + Checker
配置通了，开始写 Loop。先上最简单的单 Agent 版本，五分钟能跑起来。打开 Claude Code，进到你的项目目录，确认测试能跑：
cd your-project npm test有通过有失败最好，全绿的话 Loop 没东西可修。然后在 Claude Code 里输入：
/loop 2m 运行 npm test，如果有失败就分析报错原因并修复，直到全部通过它会每 2 分钟执行一次：跑测试 → 有失败就分析 → 改代码 → 再跑 → 全通过就停。你会看到它自动运行测试、读报错、定位源码文件、修改、再跑。这就是一个 Loop，和你手动「跑测试 → 看报错 → 告诉 AI 改」的区别在于，中间那几轮没有你。项目没测试的话用 linter 代替：/loop 2m 运行 eslint .，如果有报错就修复，直到零报错。
单 Agent 有个致命问题：写代码的 Agent 往往高估自己的答案，写完再问自己「行不行」，答案大概率是「行」。所以进阶要做 Builder + Checker 双 Agent，把执行和验证拆开。在.claude/agents/目录下建两个文件。
builder.md：
--- name: builder description: 负责编写和修复代码 tools: Read, Write, Edit, Glob, Grep, Bash model: sonnet --- 你只负责构建和修复，不做其他任何事情。 接到任务时： 1. 先读项目的 README、package.json，理解架构和编码约定 2. 确认任务涉及的文件范围 3. 开始实现 接到修复请求时： 1. 逐条阅读 Checker 报告的失败项，每条都要读到 file:line 2. 定位根因，区分症状和病因 3. 一次只修一个根因 4. 不要顺手重构不相关的代码checker.md：
--- name: checker description: 负责验证代码质量 tools: Read, Bash, Glob, Grep model: sonnet --- 你只负责检查，不修改任何代码。 检查清单： 1. 运行测试套件，记录所有失败 2. 运行 linter，记录所有警告 3. 运行类型检查（如有） 输出格式：每条失败必须包含文件路径、行号、错误信息、严重程度注意 Checker 的 tools 里没有 Write 和 Edit，这是刻意的，从工具层面禁止它改代码。编排逻辑就是：Builder 改完 → Checker 检查 → 有失败反馈给 Builder → 再检查 → 直到全绿。职责分离之后，验证环节不再由「想证明自己对」的那个 Agent 来做，Loop 的可信度会明显提升。
5. 完整运行与结果验证：自动修 CI 失败
用一个真实场景把整条链路跑通：自动修复 CI 失败。背景是项目用 GitHub Actions 跑 CI，经常有人合并代码后测试挂了。
第一步，写CLAUDE.md作为项目记忆：
# 项目约定 - 语言：TypeScript - 测试框架：Jest - 包管理：pnpm - CI：GitHub Actions - 分支策略：main 分支保护，必须通过 CI 才能合并 # 常见 CI 失败原因 - import 路径错误（新文件忘加到 tsconfig） - 测试文件没有 mock 外部依赖 - 类型错误（any 类型泛滥）第二步，写 Checker Agentci-checker.md：
--- name: ci-checker description: 检查 CI 状态并分析失败原因 tools: Read, Bash --- 步骤： 1. 运行 `gh run list --limit 1` 获取最新 CI 状态 2. 如果状态是 success，输出"CI 正常"并退出 3. 如果状态是 failure，运行 `gh run view <id> --log-failed` 获取失败日志 4. 分析失败原因，输出失败的测试文件和行号、错误信息、可能的原因第三步，写 Builder Agentci-fixer.md：
--- name: ci-fixer description: 根据 Checker 的分析修复代码 tools: Read, Write, Edit, Bash --- 规则： 1. 只修复 Checker 报告的问题，不改其他代码 2. 修复后立即运行对应的单个测试验证 3. 单个测试通过后，运行完整测试套件确认没有引入新问题 4. 如果修复需要改动超过 5 个文件，停止并请求人工介入第四步，配置 Loop 并加上边界条件：
/loop 5m 1. 用 ci-checker 检查 CI 状态 2. 如果 CI 正常，什么都不做 3. 如果 CI 失败，用 ci-fixer 修复 4. 修复后推送代码，等待下一轮 CI 5. 最多试 3 轮，3 轮后还有失败就通知我边界条件必须写死，没有刹车的 Loop 就是一辆没刹车的车。四个关键参数：最大迭代次数max_iterations: 50，超过说明方向错了；Token 预算上限max_tokens: 500000，防止一个 Loop 烧光月度配额；连续失败阈值max_consecutive_failures: 5，连续没进展就停；进展度量progress_metric: "测试通过率"，每轮对比上一轮，没改善就提前退出。
第五步，撒手观察。Loop 每 5 分钟检查一次，CI 挂了它自己修，修好了自己推，推完自己等结果，3 轮修不好才叫你。验证结果分两层：先看 Loop 自己的输出，确认它报告「CI 正常」；再手动跑一次gh run list --limit 1和npm test，确认状态真的变了。别只信 Agent 的自述，一定要用外部命令复核。
6. 常见报错排查：401、local proxy failed 与 OAuth
Loop 跑不起来，九成问题出在接入层。下面按真实报错对照排查。
401 Unauthorized或invalid api key：Key 没填对或者失效了。检查ANTHROPIC_AUTH_TOKEN或OPENAI_API_KEY的值，确认没有多余空格、没有把 Key 名当值填进去。如果 Key 是刚创建的，确认复制完整。重建一个 Key 再试是最快的排除法。
local proxy failed或连接被拒绝：Base URL 写错了。确认填的是https://taotoken.net/api，不要多加路径、不要带查询参数、不要漏掉https。有些工具会自动在末尾拼/v1，如果报 404 就检查是不是重复拼接了。
reading choices相关报错或返回结构解析失败：通常是模型 ID 写错，或者工具期望的响应格式和实际返回不匹配。到模型对话页面确认当前可用的模型名，原样抄进配置。别凭记忆写模型名，版本号差一位就报错。
OAuth 相关报错：如果你之前用 OAuth 登录过 Claude Code，本地可能残留了旧的凭证，和新的 Token 配置冲突。清掉旧的登录状态，改用 Token 方式配置，重启工具再试。
gh: command not found或 CI 查询失败：GitHub CLI 没装或者没登录。跑gh auth status确认，没登录就gh auth login。Loop 里用到gh run list的地方都依赖这个。
Loop 跑了几轮没进展：先看是不是触发了乒乓循环，Agent 在两个状态之间来回切换。解法是设「连续无进展」阈值，超过 3 次直接退出。再看是不是上下文膨胀，跑到第 20 轮时窗口里塞满历史，有用信息被淹没。解法是每轮只保留关键信息：当前任务、最近一次成功、最近一次失败原因。
排查顺序建议固定下来：先验证三件套（Base URL、Key、Model ID），再验证单次请求能通，最后才怀疑 Loop 逻辑。接入层没通的情况下调 Loop，纯属浪费时间。接入文档在 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite ，配置细节以文档为准。
7. 下一步：把 Loop 接进你的日常工作流
第一个 Loop 跑通之后，别急着上三层架构。先把五个构件一个个试：Automation 是触发器，/loop和 Routines 配，关键是停止条件写死；Worktree 做工作隔离，多个 Agent 同时干活时给每个一份独立工作区；Skill 是项目记忆，就是CLAUDE.md，Agent 每轮直接读；Connector 通过 MCP 接上 GitHub、Slack、CI，Loop 才算真正接入工作流；Sub-agent 做职责分离，Builder 只写、Checker 只查，这可能是最有用的一个改造。
四个成熟场景可以直接抄：CI 失败自动修复、批量重构（/goal 把项目中所有的 var 声明改成 const 或 let，全部测试通过）、Issue 转 PR、每日代码审查。后两个用 Routines 配定时任务，关了电脑也能跑。
如果你打算长期跑编码类 Loop，或者要 spawn 多个子 Agent 并行，建议单独开一个 Coding Plan 来管理额度，别和手动调试混用。入口：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。需要新建或轮换 Key 的时候走 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite 。
最后一条经验：Loop 只负责提交 PR 草稿，永远不要让它直接推代码到 main 分支。跑完的产出必须有人 review 才能合并。无人 review 的 Loop，三天后线上出问题的时候你连是哪一轮改的都找不到。
