企业官网建设流程全解析

1. 先定位：/build auto 到底停在哪一步

在 Claude Code 里跑 agent-skills 的/build auto，最让人卡住的往往不是计划本身，而是计划批准后任务刚拆到一半，会话因为模型供应商返回限流、连接超时或额度提示停在半路。此时先别急着重开项目，把 Claude Code 的模型入口切到 TaoToken：到 TaoToken 官网 创建 Key，把ANTHROPIC_BASE_URL设为https://taotoken.net/api，再用claude --continue回到原会话，让 Agent 继续消费 Token 完成拆解。下面按「暂停定位 → 配置切换 → 恢复命令 → 计划批准与任务拆解对照 → CC Switch/Codex 对照 → 验收排障」走一遍。

agent-skills 的/build auto在支持斜杠命令的宿主里，批准计划后会继续拆解并实现任务，但遇到失败或高风险操作仍会暂停。所以“暂停”本身不是异常，先要判断停在哪一类：

# 常见暂停输出 Waiting for approval: docs/plan.md API Error: 429 rate limit exceeded Connection error: request timed out High-risk operation detected: git push --force

第一类：等待批准。计划已经生成，但用户没有输入approve、yes或类似确认。这个阶段还没有进入任务拆解，直接批准即可。

第二类：模型调用中断。计划已经批准，Agent 也开始调用planning-and-task-breakdown拆任务，但请求模型时出现 429、超时、连接中断。这种暂停与 Skill 逻辑无关，重点检查 Base URL、Key 和当前供应商状态。

第三类：风险闸门。Agent 识别到删除文件、强制推送、执行迁移、修改 CI 等高风险动作，主动停下来等待人工确认。这类暂停建议保持，不要为了“全自动”强行跳过。

排查时先看 Claude Code 最后 5 行输出。如果出现Waiting for approval，输入：

approve

如果出现API Error或Connection error，先去 TaoToken 官网 拿 Key，再切换 Base URL。如果出现High-risk operation，先人工确认命令影响，再输入continue。

2. 从 TaoToken 拿 Key 并写入 Claude Code：settings.json 与 ANTHROPIC_* 双写法

TaoToken 的接入入口在官网，注册登录后进入控制台创建 API Key。创建 Key 的页面可以直接走这个 deep link：API Keys。创建完成后，你会拿到一串 Key，下文统一用YOUR_API_KEY占位。

Claude Code 的模型入口通过ANTHROPIC_*系列变量控制，Base URL 固定填：

https://taotoken.net/api

注意：Base URL 不加 UTM 参数，也不要写成带?utm_source=...的地址。Claude Code 读取的是纯接口地址。

写法一：改settings.json。可以放在用户级~/.claude/settings.json，也可以放在项目级.claude/settings.json。

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929" } }

如果你的 Claude Code 版本使用ANTHROPIC_API_KEY，也可以改成：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "YOUR_API_KEY", "ANTHROPIC_MODEL": "claude-sonnet-4-5-20250929" } }

两种 Key 变量名以你本地 Claude Code 版本文档为准。核心只有两点：Base URL 指向https://taotoken.net/api，Key 用 TaoToken 控制台创建的那一串。

写法二：用环境变量，适合临时切换或 CI 环境。

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" export ANTHROPIC_MODEL="claude-sonnet-4-5-20250929"

写入后验证：

echo $ANTHROPIC_BASE_URL # 期望输出：https://taotoken.net/api echo $ANTHROPIC_AUTH_TOKEN # 期望输出：YOUR_API_KEY 对应的实际值

如果你之前配置过其他供应商的ANTHROPIC_*，先确认没有冲突。Claude Code 通常优先读取当前 shell 环境变量，其次读取 settings 文件。最稳妥的方式是：在同一个终端里unset旧变量，再重新export，最后用claude --continue恢复会话。

3. 暂停恢复命令：claude --continue 与会话内 continue

切换 Base URL 后，不要直接开一个全新会话。/build auto的上下文、已批准计划、已拆任务都在原会话里，重开会丢失状态。Claude Code CLI 提供两种恢复方式：

# 继续最近一次会话 claude --continue # 列出历史会话，手动选择 claude --resume # 如果知道 session id，也可以直接指定 claude --resume <session-id>

进入会话后，先确认当前状态：

> 当前 /build auto 拆到哪一步？列出已完成和未完成任务。

如果 Agent 回复还在等待计划批准，输入：

approve

如果计划已经批准，只是模型调用中断，输入：

continue

或者重新触发/build auto：

/build auto

在支持斜杠命令的 Claude Code 适配层里，/build auto会接着已有计划继续拆解。它不会默认从头重写需求，除非你明确要求重新规划。

如果你用的是 IDE 插件，可能没有独立的claude --continue按钮。可以打开集成终端，cd到项目根目录，再运行：

claude --continue

这样比在插件里重新点“新建会话”更安全，因为最近会话的历史会被重新挂载。

另外，恢复后建议先让 Agent 输出任务看板：

> 用清单列出本次计划的所有任务，标记 done、doing、todo。

确认没有重复拆解、没有跳过测试任务，再继续/build auto。

4. 计划批准片段与任务拆解对照：让 planning-and-task-breakdown 继续

下面用一个具体需求走一遍：给用户中心增加手机号验证码登录，要求 60 秒倒计时、验证码 5 分钟过期、错误次数限制。agent-skills 的流程大致是/spec→/plan→ 批准 →/build auto→planning-and-task-breakdown拆解。

计划批准片段可以长这样：

> /spec 用户中心增加手机号验证码登录，要求 60 秒倒计时、验证码 5 分钟过期、错误次数限制 ... > /plan 计划已写入 docs/plan-sms-login.md 阶段：Define -> Plan -> Build -> Verify -> Review -> Ship 任务： 1. 新增 sms_code 表与迁移 2. 实现发送验证码接口 POST /auth/sms/send 3. 实现校验验证码接口 POST /auth/sms/verify 4. 登录成功签发 JWT 5. 前端倒计时与错误提示 6. 补充集成测试与安全评审 > approve > /build auto

批准后，planning-and-task-breakdown会把 6 个计划任务拆成更小、可验证的子任务。下面是任务拆解对照，方便你检查 Agent 有没有偏航：

如果拆到第 3 项时暂停，切换 TaoToken 后claude --continue，再输入continue，Agent 会从当前任务继续，而不是从第 1 项重来。你可以用下面的命令检查进度：

> 当前 doing 任务是什么？下一个 todo 是什么？

如果 Agent 回答“已完成 1、2，正在做 3”，说明恢复成功。如果它回答“还没有计划”，说明你打开的不是原会话，需要claude --resume手动选择。

这里还有一个容易忽略的点：/build auto继续拆解时，每个子任务都应该带验收证据。比如“发送验证码接口”不能只说“已实现”，而要给出测试命令、测试结果和失败路径覆盖。你可以要求：

> 对当前任务运行测试，并把命令和输出摘要贴出来。

这样 Skill 的检查点才会真正生效。

5. CC Switch 三件套与 Codex config.toml：配置别混用

如果你用 CC Switch 管理多个供应商，TaoToken 的配置可以按三件套填写：

供应商名称：TaoToken Base URL：https://taotoken.net/api API Key：YOUR_API_KEY 默认模型：claude-sonnet-4-5-20250929

三件套就是 Base URL、API Key、模型名。切换后回到 Claude Code 会话，用claude --continue恢复/build auto。不要在 CC Switch 里把 Codex 的配置和 Claude Code 的配置混在一起，否则可能出现“会话恢复了但模型调用仍然报错”的情况。

如果你同时用 Codex，要在 Codex 自己的config.toml里单独配置。Codex 不读取ANTHROPIC_*，不要把 Claude Code 的ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN复制到 Codex。下面是一个 Codex 配置示例：

# ~/.codex/config.toml model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY"

然后在 shell 里设置 Codex 自己的环境变量：

export TAOTOKEN_API_KEY="YOUR_API_KEY"

注意：Codex 的env_key是TAOTOKEN_API_KEY，不是ANTHROPIC_AUTH_TOKEN。Claude Code 的ANTHROPIC_*只服务于 Claude Code。两者分开配置，排障时会清晰很多。

如果你只用 Claude Code，可以跳过 Codex 部分，只保留settings.json或ANTHROPIC_*环境变量即可。

6. 验收与排障：任务拆解继续后检查什么

恢复/build auto后，不要只看 Agent 说“继续中”。可以从下面几个点验收：

第一，检查 Base URL 是否生效：

echo $ANTHROPIC_BASE_URL # 期望：https://taotoken.net/api

第二，检查 Key 是否可用。去 TaoToken 控制台看最近请求记录，或者重新触发一次简单对话：

> 回复一句：Base URL 已切换。

第三，检查 Skill 路由。agent-skills 里的using-agent-skills负责判断当前任务该调用哪个 Skill。拆解任务时，它应该输出类似“当前阶段 Build，调用 planning-and-task-breakdown 和 test-driven-development”的理由。如果没有路由说明，可能 Skill 没有正确加载。

第四，检查完成证据。每个子任务至少要有：修改文件列表、测试命令、测试结果、未完成风险。可以用命令检查：

curl -sS -o /dev/null -w "%{http_code}\n" https://taotoken.net/api

这个命令只检查网络连通性。根路径返回 404 也不代表 Base URL 不可用，关键看 Claude Code 是否还报 429 或连接超时。

第五，检查高风险闸门是否仍然有效。/build auto在遇到高风险操作时暂停是预期行为。比如强制推送、删除迁移文件、修改生产配置，这些都不应该被“自动继续”绕过。切换 Base URL 只解决模型调用问题，不改变安全边界。

最后，如果/build auto再次暂停，先看暂停类型：等待批准就输入approve；模型调用失败就检查ANTHROPIC_BASE_URL和YOUR_API_KEY；高风险操作就人工确认。恢复会话优先用claude --continue或claude --resume，不要直接开新窗口。

想先验证模型输出，可以去 模型对话 试跑；准备长期在 Claude Code 里跑 agent-skills，可以看 Coding Plan；创建 Key 在 API Keys；Claude Code 的详细接入步骤在 Claude Code 文档。官网入口再放一次：TaoToken。把 Base URL 固定为https://taotoken.net/api，Key 用YOUR_API_KEY占位替换，/build auto暂停后就能回到原会话继续拆任务。