1. 为什么 Claude Code 总是“干一半就停”如果你用 Claude Code 做过稍微大一点的任务大概率遇到过这种场景让它重构一个模块它改完两个文件就说“已完成”让它修 bug 直到测试全绿它跑一次测试就收工你想让它“过夜干活”第二天打开终端发现它凌晨一点就停了。这不是模型偷懒而是 LLM 的一个结构性缺陷——它无法客观判断自己的工作是否真正完成。人类判断完成靠的是“所有测试通过、构建成功、类型检查无报错”这类硬指标而模型只能靠“感觉差不多了”来收尾。社区里把这种现象叫做“过早停止”。2025 年夏天澳大利亚开发者 Geoffrey Huntley 用一个 5 行 bash 脚本解决了这个问题不断重启 Claude Code 并重新喂给它同一个任务直到外部条件满足才停。这个项目被命名为 Ralph Wiggum两周内拿到 7000 星标。它的核心思想很简单——把“完成判断”从模型手里拿走交给外部循环和客观标准。但要让这个循环稳定跑起来有两个前提第一API 通道不能中途断掉或限流第二Key 管理要统一否则多个 Agent 并行时容易乱。这篇就围绕 Claude Code 长时间运行场景把 TaoToken 统一 Key、Stop Hook 配置、settings.json 骨架和排障动作串起来让你能直接复制落地。2. TaoToken 前置统一 Key 与 API 通道Claude Code 长时间运行最怕两件事一是跑到一半 API 报 401/429二是多个 Agent Teams 并行时 Key 散落在不同配置文件里排查起来很痛苦。TaoToken 在这里的角色是提供一个统一的 API 入口把 Key 管理和通道稳定性收口到一处。你可以先到官网了解整体能力https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 然后在控制台创建 Key。API 基地址用 https://taotoken.net/api 注意这个地址不加 UTM 参数直接用于配置。具体操作路径模型对话入口用于快速验证 Key 是否可用https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite控制台管理 Key 和用量https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 创建页https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档含 Claude Code 配置说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite注意长时间循环任务建议单独创建一个 Key不要和日常对话混用。这样成本归因清晰出问题也容易定位是哪个循环在消耗额度。拿到 Key 之后Claude Code 侧需要配置两个地方一个是~/.claude/settings.json全局设置一个是项目级的config.toml如果你用 Claude Code 的 TOML 配置模式。下面给出可直接复制的骨架。3. 可复制配置settings.json 与 config.toml 骨架3.1 settings.json 骨架Claude Code 的全局配置放在~/.claude/settings.json。这个文件控制 API 通道、环境变量和 Hook 行为。下面是一个面向长时间运行场景的骨架{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-your-taotoken-key, ANTHROPIC_MODEL: claude-sonnet-4-20250514 }, permissions: { allow: [ Bash(npm test:*), Bash(npm run build:*), Bash(npm run typecheck:*), Bash(git diff:*), Bash(git status:*) ] }, hooks: { Stop: [ { matcher: , hooks: [ { type: command, command: bash ~/.claude/hooks/stop-check.sh } ] } ] } }几个关键点解释ANTHROPIC_BASE_URL指向 TaoToken 的 API 地址这样 Claude Code 的所有请求都走统一通道。ANTHROPIC_API_KEY填你在控制台创建的 Key。permissions.allow里预授权了测试、构建、类型检查、git 查看这几类命令避免循环过程中因为权限弹窗卡住。hooks.Stop是 Ralph Wiggum 机制的核心。当 Claude 想要退出时Stop Hook 会拦截这个信号执行你指定的脚本。脚本里检查“完成标记”是否存在不存在就重新注入任务。3.2 config.toml 骨架如果你使用 Claude Code 的 TOML 配置模式部分版本支持项目根目录下的config.toml可以这样写[api] base_url https://taotoken.net/api api_key sk-your-taotoken-key model claude-sonnet-4-20250514 timeout_seconds 600 max_retries 3 [loop] max_iterations 50 completion_promise TASK_COMPLETE rate_limit_per_hour 100 cost_alert_thresholds [10, 50, 100] [hooks.stop] enabled true script ~/.claude/hooks/stop-check.shtimeout_seconds设大一点长时间任务单次请求可能跑很久。max_retries配合 TaoToken 的通道稳定性减少偶发网络抖动导致的循环中断。loop段里的参数对应 Ralph 的安全机制最大迭代次数、完成标记、每小时速率限制、成本预警阈值。3.3 Stop Hook 脚本~/.claude/hooks/stop-check.sh的内容决定了循环是否继续。一个可用的最小实现#!/bin/bash # 检查最近一次输出中是否包含完成标记 PROMISE_FILE$HOME/.claude/last_output.txt COMPLETION_MARKERTASK_COMPLETE if grep -q $COMPLETION_MARKER $PROMISE_FILE 2/dev/null; then echo 检测到完成标记允许退出 exit 0 else echo 未检测到完成标记重新注入任务 exit 2 fi退出码0表示允许 Claude 退出退出码2表示阻止退出并重新注入 prompt。这个脚本需要配合 Claude Code 的输出重定向使用把每次输出写到last_output.txt。提示Stop Hook 脚本里的完成标记要和你在 prompt 里指定的promise标签保持一致否则永远匹配不上循环会一直跑。4. 验证请求与成功结果配置写完之后不要直接上大任务。先用一个小任务验证整条链路是否通。4.1 验证 API 通道在终端里直接发一个请求确认 TaoToken 通道可用curl -s https://taotoken.net/api/v1/messages \ -H x-api-key: sk-your-taotoken-key \ -H anthropic-version: 2023-06-01 \ -H content-type: application/json \ -d { model: claude-sonnet-4-20250514, max_tokens: 64, messages: [{role: user, content: 回复 OK}] }如果返回里有正常的 content 字段说明 Key 和通道都没问题。这一步也可以用模型对话页面快速验证https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite4.2 验证 Stop Hook 触发写一个最简单的 PROMPT.md你的任务在项目根目录创建一个 hello.txt内容为 hello ralph。 完成后输出 promiseTASK_COMPLETE/promise然后启动循环claude --prompt-file PROMPT.md观察行为Claude 创建文件后输出完成标记Stop Hook 检测到标记允许退出。如果它没输出标记就想退出Hook 会拦截并重新注入任务。你可以在~/.claude/last_output.txt里看到每次的输出记录。4.3 验证长时间运行稳定性用一个中等任务跑 10 轮左右观察三件事第一API 有没有出现 429 或 401。如果出现检查 TaoToken 控制台的用量和 Key 状态。第二Stop Hook 有没有正确拦截。如果 Claude 每次都直接退出检查脚本退出码和完成标记是否匹配。第三成本是否在预期范围内。控制台可以看到实时消耗。实测下来把max_iterations设成 20 到 50 之间比较稳妥既能完成大部分重构任务又不会因为死循环烧掉太多额度。5. 本篇常见错排查5.1 Stop Hook 不触发最常见的原因是settings.json里 hooks 的路径写错或者脚本没有执行权限。检查chmod x ~/.claude/hooks/stop-check.sh ls -la ~/.claude/hooks/另外确认settings.json的 JSON 格式合法可以用python -m json.tool ~/.claude/settings.json验证。5.2 循环一直跑不退出如果完成标记一直匹配不上循环会无限跑。排查顺序先看 prompt 里的promise标签和脚本里的COMPLETION_MARKER是否完全一致大小写、下划线都要对。再看输出文件last_output.txt是否真的被写入。如果 Claude 的输出没有重定向到这个文件脚本永远读不到标记。5.3 API 报 401 或 403Key 失效或填错。到 API Keys 页面重新生成一个https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。注意ANTHROPIC_API_KEY的值不要带多余空格或换行。5.4 多 Agent 并行时 Key 冲突Agent Teams 场景下多个 Claude 实例如果共用同一个 Key容易出现速率限制。建议给每个 Agent 分配独立 Key或者在config.toml里设置rate_limit_per_hour做软限制。长期跑编码和 Agent 任务的话可以了解 Coding Plan 的分流方案https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite5.5 成本失控没有设置max_iterations和cost_alert_thresholds是最常见的原因。任何自动循环都必须有硬性上限。另外可以在 Stop Hook 脚本里加一个检查如果最近 5 次 git diff 没有实质变化就强制退出。if [ $(git diff HEAD~5 | wc -l) -eq 0 ]; then echo 最近 5 次提交无实质变化可能陷入循环 exit 0 fi6. 长任务接入路径与工具选择把上面的配置串起来Claude Code 长时间运行的完整链路是TaoToken 统一 Key 和 API 通道 → settings.json 配置环境变量和 Stop Hook → config.toml 设置循环参数和安全阈值 → Stop Hook 脚本判断完成标记 → 验证请求确认通道可用 → 排障处理常见错误。如果你主要是在排障和接入阶段优先看 API Keys 和接入文档https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 和 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。如果是要验证模型在长任务里的表现用模型对话快速试https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewrite 。如果是长期编码和 Agent Teams 并行Coding Plan 更适合https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。最后说一个我踩过的坑Stop Hook 脚本里不要做太重的操作比如跑完整测试套件。Hook 是在每次退出时触发的如果脚本本身跑几分钟循环节奏会被拖得很慢。把重检查放在 prompt 的验收标准里让 Claude 自己跑测试Hook 只做轻量的标记匹配和退出码判断。这样循环才能跑得顺。