1. 从手动 Prompt 到 Loop 设计师为什么你的 Agent 还在等你敲键盘如果你现在用 Codex 或 Claude Code 写代码大概率还是这个节奏写一段 Prompt等结果读 diff不满意再写一段。Agent 是工具你是那只一直握着工具的手。这个模式在单次任务上没问题但一旦某类任务每周都来——CI 失败分诊、依赖升级、Lint 修复——你就会发现自己变成了人肉调度器。Loop 工程要解决的就是这件事搭一套小系统让它自己找到要干的活、丢给 Agent 去做、检查结果、记录状态、决定下一步。你只设计一次之后是它在替你发 Prompt。杠杆点已经从“会不会写 Prompt”挪到了“会不会设计一套让 Agent 自己跑的系统”。但这东西不是免费的。只有四个条件都满足收益才能覆盖成本任务至少每周重复一次、验证能自动完成测试/类型检查/Lint/构建、Token 预算扛得住浪费、Agent 有可复现环境和日志能跑自己的代码。少一个Loop 的开销就大于好处。我试过在一个没有测试覆盖的脚本仓库上跑自动修复 Loop结果就是 Agent 自己批自己作业改了三轮还在原地打转。下面这套流程面向用 Codex 和 Claude Code 的开发者交付可复制的 Loop 配置骨架帮你把重复提示词改造成可观测、可迭代的自动化循环。前置只需要一个能调模型的 API KeyTaoToken 的接入方式对 Codex 和 Claude Code 都兼容配置一次两边都能用。2. TaoToken 前置拿 Key 和接入地址TaoToken 是一个模型 API 聚合服务对 Codex 和 Claude Code 这类编码 Agent 来说它的价值在于统一了接入地址和 Key 管理不用为每个工具单独配一套凭证。你可以在模型对话页面先验证模型可用性再去 Console 创建 API Key。具体操作路径打开模型对话页https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentloop_guide确认你要用的模型在列表里发一条测试消息看返回是否正常。进 Consolehttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentloop_guide创建 API Key复制保存。接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentloop_guide里有各工具的配置示例Codex 和 Claude Code 的写法下面也会给。API 基础地址是https://taotoken.net/api这个地址不加 UTM 参数直接用于配置文件里的 base_url 字段。Key 拿到后不要硬编码在脚本里用环境变量注入后面配置示例会体现这一点。注意Key 只在创建时完整显示一次关掉页面就看不到了。建议创建后立刻写入本地环境变量或密钥管理工具不要贴在聊天记录或提交到仓库。3. 可复制配置settings.json 与 config.toml 骨架这一节给两份可直接改的配置骨架。Claude Code 用settings.jsonCodex 用config.toml。两份都包含模型接入、Loop 节奏、状态文件和闸门四个部分。3.1 Claude Code 的 settings.json{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: ${TAOTOKEN_API_KEY} }, loop: { interval: 30m, goal: All tests in test/auth pass and lint is clean, checker: independent, maxIterations: 20, tokenBudget: 500000 }, state: { file: .claude/STATE.md, vision: .claude/VISION.md }, gate: { commands: [npm test, npm run lint, npm run typecheck], requireAll: true }, permissions: { deny: [src/payments/**, src/billing/**, ci/**] } }几个关键字段说明ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址ANTHROPIC_API_KEY从环境变量读不写死。loop.goal是停止条件checker: independent表示由独立模型核对完成状态写代码的 Agent 不参与打分。gate.commands是自动闸门三条命令全过才算通过。permissions.deny把支付和计费目录排除在外Loop 碰不到。3.2 Codex 的 config.toml[model] base_url https://taotoken.net/api api_key_env TAOTOKEN_API_KEY name your-model-name [automation] schedule */30 * * * * prompt_file .codex/loop-prompt.md worktree true triage_inbox .codex/triage/ [automation.stop] condition tests_pass_and_lint_clean max_iterations 20 token_budget 500000 [state] file .codex/STATE.md vision .codex/VISION.md [gate] commands [npm test, npm run lint] require_all true [agents.explorer] model fast-model reasoning low readonly true [agents.verifier] model strong-model reasoning highCodex 这边用automation.schedule控制节奏worktree true让每次运行在独立 checkout 里跑不跟其他线程撞车。agents.explorer和agents.verifier是两个子 Agent探索用快模型只读验证用强模型高推理。这样“写的人”和“查的人”分开避免自我偏好偏差。3.3 状态文件与 Skill 骨架状态文件放在.claude/STATE.md或.codex/STATE.md每次运行后更新。骨架如下# Loop State · ci-triage ## Last run 2026-06-09 03:30 UTC · 7 failures classified, 3 fixes drafted, 4 escalated ## In progress - claude/fix-auth-token-refresh — tests passing locally, awaiting CI - claude/fix-flaky-payment-webhook — retry pattern applied, monitoring ## Escalated to humans - src/billing/refund.ts — tests failing in 3 ways, root cause unclear ## Lessons learned - 2026-06-08: PowerShell hits TLS 1.2 issue on this Windows runner. Use bash. - 2026-06-07: tests/e2e/checkout requires Stripe webhook secret in env.Skill 文件放在.claude/skills/ci-triage/SKILL.md把项目上下文写一次每次运行都能读到--- name: ci-triage description: Classify CI failures by root cause, draft fixes for easy ones, escalate the rest. --- # CI triage skill ## Classification rules - env: missing secret, wrong env var, infra not provisioned. # human - flake: passes on retry without code change. # retry once, then file - bug: deterministic failure tied to recent commit. # draft fix - dependency: failure tied to a version bump. # draft rollback ## Never do - Disable failing tests — always file as escalation instead - Modify CI config without human approval - Touch src/payments/ or src/billing/4. 验证请求从单次手动运行到 Loop 跑通配置写好后不要直接上调度先手动跑一次确认每个零件都工作。第一步验证 API 连通性。用 curl 发一条最小请求curl -s https://taotoken.net/api/v1/messages \ -H x-api-key: $TAOTOKEN_API_KEY \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: your-model-name, max_tokens: 64, messages: [{role: user, content: reply with ok}] }返回里有content字段且文本是 ok说明 Key 和地址都对。第二步手动跑一次闸门命令确认测试、Lint、类型检查在当前代码上是通过的。如果手动都过不了Loop 跑起来只会反复失败。第三步手动触发一次 Loop 的单次运行。Claude Code 里用/loop 30m加/goal条件Codex 里在 Automations 标签页点一次 Run。观察三件事Agent 有没有读到 Skill 文件、状态文件有没有被更新、闸门命令有没有被执行。第四步检查 Triage 收件箱。Codex 会把有产出的 Run 放进.codex/triage/Claude Code 会在会话里输出结果。确认分类和修复草稿符合预期。第五步确认停止条件生效。故意把 goal 设成一个当前不成立的条件看 Loop 是否在 maxIterations 或 tokenBudget 到达时停下而不是一直跑。跑通之后把调度打开。Codex 的schedule */30 * * * *表示每 30 分钟一次Claude Code 的interval: 30m同理。第一次上调度建议把间隔设长一点比如 2 小时观察一天再缩短。5. 本篇常见错排查报错401 Unauthorized 或 invalid api key检查环境变量TAOTOKEN_API_KEY是否在当前 shell 里生效。echo $TAOTOKEN_API_KEY看有没有值。配置文件里写的是${TAOTOKEN_API_KEY}这种引用形式如果工具不支持变量展开需要改成实际值或确认工具的变量语法。报错model not foundmodel.name或请求里的model字段跟 TaoToken 模型列表里的名称不一致。去模型对话页确认可用模型名复制准确字符串。Loop 跑起来但状态文件不更新检查state.file路径是否存在父目录有没有写权限。Claude Code 的.claude/和 Codex 的.codex/目录需要提前创建。另外确认 Skill 文件里的STATE.md更新指令没有被permissions.deny挡住。闸门命令全部通过但 Loop 还在跑停止条件写得太模糊。goal必须是可机器判定的比如“test/auth 下所有测试通过且 lint 干净”不能是“看起来不错”。同时确认checker: independent生效如果 checker 跟写代码的是同一个 Agent它可能提前宣布完成。Token 消耗远超预期Loop 反复读上下文和重试会烧 Token。检查tokenBudget有没有设上限maxIterations是不是太大。另外看 Skill 文件是不是太长每次运行都全量读入会累积消耗。把不常用的参考资料拆到单独文件按需读取。Worktree 冲突或分支混乱Codex 的worktree true和 Claude Code 的--worktree会为每次运行创建独立 checkout。如果发现分支没清理检查子 Agent 的isolation: worktree设置确认运行结束后有清理动作。手动清理可以用git worktree list查看git worktree remove删除。Agent 改了不该改的文件permissions.deny的路径匹配可能没生效。确认路径写法跟工具文档一致有些工具用 glob 有些用前缀匹配。支付、计费、CI 配置这些目录一定要排除不可逆操作需要人工审批闸门。6. 把 Loop 跑起来之后接入文档与长期编码方案配置骨架和验证步骤都在上面了。如果你在接入过程中遇到 Key 或地址的问题先去 API Keys 页面https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentloop_guide确认 Key 状态再对照接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentloop_guide检查配置格式。模型可用性验证在模型对话页https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentloop_guide做发一条消息就能确认。如果你打算把 Loop 长期跑在编码任务上比如每晚的 CI 分诊、每周的依赖升级Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentloop_guide的额度模型比按量付费更适合这种反复读上下文、反复重试的场景。Claude Code 的接入细节在 ClaudeCodeAnthropic 页面https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentloop_guide有单独说明。最后提醒一句Loop 跑起来之后唯一值得盯的指标是“每个被接受的变更花了多少成本”。如果接受率低于 50%说明你在干 Loop 本该替你省掉的 Review 工作这时候要么收紧闸门要么把任务拆小。别让 Loop 碰架构、认证、支付这些判断题把它压在 Lint 修复、依赖升级、CI 分诊这类可机器校验的变更上。读 diff 这件事不能省理解力欠债是按复利涨的。