企业官网建设流程全解析

1. 个人网站项目里，Agent 团队为什么先卡在“模型入口”这一步

做个人网站这种全栈项目，页面不多、接口不复杂，但角色一点都不少：产品要写 Spec，交互要出页面方案，前端要写组件，后端要写接口和数据表，测试要跑 E2E，体验要站在用户视角验收。上一章我们把六个角色的职责矩阵和 Skills 配装逻辑理清了，这一章要解决的是一个更底层的问题——这些 subagent 和 Skills 到底从哪里拿模型能力。

我试过最省事的做法是每个 Agent 单独配一套 Key，结果就是配置文件里散落着五六个不同的 base_url 和 api_key，改一次模型要改六处，某个 Agent 报 401 还得挨个排查是哪把 Key 过期了。Agent Teams 的调用链是“主会话派发 → subagent 执行 → Skills 内部再调模型”，任何一层入口不一致，都会表现为“某个角色突然不干活了”，而不是干脆的报错。

所以团队搭建阶段的第一件事，是把模型调用入口收敛成一条通道。TaoToken 在这里扮演的角色就是统一 Key 与统一 API 通道：主会话、六个 subagent、以及它们加载的 Skills，全部指向同一个 base_url 和同一把 Key，模型切换、额度查看、调用排障都只在一个地方发生。这一章交付的是可直接复制的 settings.json / config.toml 配置骨架、CC Switch 与 Cline 的接入步骤，以及验证 subagent 调用链是否真正生效的具体动作。

适合谁看：已经在用 Claude Code 或 Cline 做多 Agent 开发、准备把个人网站项目拆成团队流水线的人；如果你还停留在单会话阶段，这一章的配置骨架同样可以直接用，只是暂时用不到 subagent 那部分。

2. TaoToken 前置：一把 Key 打通主会话与所有 subagent

2.1 为什么统一入口比“每个 Agent 一把 Key”更稳

Agent Teams 的调用链有个特点：模型请求不是只从主会话发出。主会话派发任务时调一次模型，subagent 启动后自己再调一次，Skills 在执行过程中（比如 brainstorming 逼需求、writing-plans 拆任务）还会再调。如果每个环节用不同的 Key 和不同的 base_url，会出现三种典型症状：一是某个 subagent 静默失败，主会话只看到“任务未完成”；二是 Skills 内部调用走了默认官方地址，额度消耗和主通道对不上；三是排查时要同时看多个控制台的用量，根本对不齐时间线。

统一到 TaoToken 之后，这些请求都落在同一个 API 通道上，用量、报错、模型名都在一处可见。对个人网站这种小项目来说，最大的收益不是省钱，而是排障时不用做“多控制台对账”这种体力活。

2.2 拿 Key 与确认通道地址

先到控制台创建一把 API Key，建议按项目命名，比如wanderchina-agent-teams，方便后面区分。创建入口在 console 页面，登录后进 API Keys 管理即可。

需要记住两个地址，后面所有配置都围绕它们展开：

• 官网入口：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
• API 基地址：https://taotoken.net/api

注意 API 基地址后面不加任何 UTM 参数，配置里填的就是这个干净地址。模型名按你实际要用的填，比如claude-sonnet-4-5这类，具体可用列表在模型对话页面能直接看到，也可以在那里先发一条消息确认通道通不通。

提示：Key 只创建一次，主会话、subagent、Skills 全部复用同一把。不要给不同角色发不同 Key，那会把“统一入口”这件事又拆散了。

3. 可复制配置：settings.json 与 config.toml 骨架

3.1 Claude Code 侧 settings.json 骨架

Claude Code 的配置分两层：一层是模型通道（走环境变量或 settings），一层是 subagent 定义（走.claude/agents/目录）。先看通道层，在项目根目录的.claude/settings.json里写：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "sk-你的TaoToken密钥", "ANTHROPIC_MODEL": "claude-sonnet-4-5" }, "permissions": { "allow": [ "Read", "Grep", "Glob", "Edit", "Write", "Bash(git *)", "Bash(npm *)" ] } }

这里ANTHROPIC_BASE_URL指向 TaoToken 的 API 基地址，ANTHROPIC_AUTH_TOKEN填刚才创建的 Key。主会话启动时会读这份配置，subagent 继承同一份环境变量，所以它们天然走同一条通道——这正是统一入口的价值，不需要给每个 subagent 单独写 base_url。

3.2 subagent 定义骨架：以 product-manager 为例

subagent 定义放在.claude/agents/product-manager.md，用 frontmatter 声明元信息，正文写职责与约束：

--- name: product-manager description: 接收一句话需求，输出 PRD 与用户故事，只读权限 tools: Read, Grep, Glob model: inherit --- 你是个人网站项目的产品 Agent。 职责： - 接收一句话需求，输出功能概述 / 用户故事 / 边界清单 / 开放问题 - 不写代码，不改文件，只输出 Spec 文档 约束： - 必须显式列出“不做什么”，边界比功能更重要 - 开放问题必须逐条列出，强制人类拍板，不允许自行假设 - 输出格式固定四段，缺一段视为未完成 加载 Skills：brainstorming, writing-plans 加载 Rules：spec-driven-workflow

model: inherit是关键，表示这个 subagent 继承主会话的模型通道配置，不用自己再写一遍 base_url 和 Key。六个角色按同样的骨架写，区别只在tools（产品/交互/体验只读，前端/后端/测试读写）和加载的 Skills、Rules。

3.3 Cline 侧 config.toml 骨架

如果你用 Cline 做前端或后端的执行环节，配置走config.toml：

[api] provider = "anthropic" base_url = "https://taotoken.net/api" api_key = "sk-你的TaoToken密钥" model = "claude-sonnet-4-5" [agent] name = "frontend-agent" skills = ["test-driven-development", "executing-plans"] rules = ["frontend-conventions", "styling-conventions"] workspace = "../wanderchina-frontend" [limits] max_tokens_per_task = 8000

Cline 的base_url同样指向 TaoToken 的 API 基地址，api_key复用同一把 Key。workspace指向该 Agent 的独立工作目录，配合后面要讲的 git worktree 隔离。

3.4 CC Switch 接入步骤

CC Switch 用来在多个配置档之间切换，适合你同时维护“个人网站项目”和“其他项目”两套通道时使用。接入步骤：

第一步，在 CC Switch 里新建一个配置档，命名taotoken-wanderchina。第二步，把 base_url 填成https://taotoken.net/api，api_key 填 TaoToken 的 Key，模型填你要用的那个。第三步，保存后设为当前激活档，CC Switch 会把它写入 Claude Code 读取的配置位置。第四步，回到项目目录重启 Claude Code，让它重新加载配置。

切换完成后，可以用/status或类似命令确认当前生效的 base_url 是不是 TaoToken 的地址。如果显示的还是官方地址，说明配置档没激活成功，检查 CC Switch 当前档位和项目目录是否匹配。

4. 验证 subagent 调用链是否生效

配置写完不代表生效，Agent Teams 最容易出的问题是“主会话通了，subagent 没通”。下面这套动作按顺序做一遍，能定位到具体是哪一层断了。

4.1 第一步：主会话单点验证

在 Claude Code 主会话里直接发一条消息，比如“用一句话说明这个项目是做什么的”。如果这条能正常返回，说明主会话的通道配置没问题，base_url 和 Key 都对。

如果这一步就报 401 或连接失败，问题在 settings.json 的 env 段，重点检查 Key 有没有多余空格、base_url 是不是写成了带路径的完整地址。

4.2 第二步：subagent 单独触发

主会话里输入类似“让 product-manager 把‘用户能收藏文章’这个需求整理成 Spec”的指令，观察返回。如果主会话能返回但这一步卡住或报错，说明 subagent 定义有问题，常见原因是 frontmatter 里的model字段写成了具体模型名而不是inherit，导致它试图走一条没配置的通道。

4.3 第三步：Skills 内部调用验证

让 product-manager 执行一次带 brainstorming 的任务，比如“用 brainstorming 方式把‘用户能收藏文章’这个需求逼出三个开放问题”。如果 subagent 能启动但 Skills 环节没输出，说明 Skills 内部的模型调用没走通。这时候去 TaoToken 控制台看用量记录，如果这条请求根本没出现，说明 Skills 用的是默认官方地址，需要在 Skills 配置里显式指定 base_url。

4.4 第四步：用量对账

在 TaoToken 控制台的用量页面，按时间倒序看最近几条请求。一次完整的 subagent 调用链应该能看到：主会话派发一次、subagent 启动一次、Skills 执行若干次，模型名一致、时间连续。如果只看到主会话那一条，后面的都没出现，说明 subagent 和 Skills 没走统一通道，回到 3.2 检查model: inherit和 Skills 的 base_url 配置。

注意：验证阶段建议把max_tokens_per_task调小一点，比如 2000，避免调试时一次跑掉太多额度。确认链路通了再调回正常值。

5. 本篇常见错排查

5.1 报 401：Key 无效或带了多余字符

最常见的原因是复制 Key 时带上了首尾空格，或者把 Key 写进了带引号的字符串但引号本身也被复制进去了。检查 settings.json 里ANTHROPIC_AUTH_TOKEN的值，确保只有sk-开头的那串字符。另一个原因是 Key 被删除或过期，去控制台确认这把 Key 还在。

5.2 报 404：base_url 写成了带路径的地址

TaoToken 的 API 基地址是https://taotoken.net/api，不要在后面加/v1或/messages之类的路径。有些客户端会自动拼接路径，你只需要给到/api这一层。如果报 404，先检查 base_url 是不是多写了东西。

5.3 subagent 不启动：frontmatter 格式错误

.claude/agents/下的 md 文件，frontmatter 必须用---包裹，且name、description、tools三个字段不能少。如果tools写成了不存在的工具名，subagent 会静默不启动，主会话只显示“任务未完成”。检查工具名拼写，只读角色用Read, Grep, Glob，读写角色再加上Edit, Write。

5.4 Skills 调用走了默认地址

如果 subagent 能启动但 Skills 环节没反应，去 Skills 自己的配置文件里找 base_url。有些 Skills 是独立安装的，不会自动继承主会话的环境变量，需要手动把 base_url 指向https://taotoken.net/api。改完后重启 Claude Code 让配置生效。

5.5 用量对不上：多个配置档同时激活

如果你同时装了 CC Switch 和其他配置工具，可能出现两个配置档互相覆盖的情况。表现是主会话走 TaoToken，但 subagent 走了另一个地址，用量分散在两处。解决方法是只保留一个激活档，其他档位设为禁用，重启后确认/status显示的 base_url 唯一。

6. 下一步：把统一通道接进 Coding Plan 与接入文档

通道打通之后，团队搭建阶段还剩两件事：一是把长期编码任务接到 Coding Plan 上，让前端、后端这些高频调用的角色有稳定的额度支撑；二是把接入细节沉淀成文档，方便后面加新角色时直接复用。

如果你在排障阶段遇到 401、404 或 subagent 不启动的问题，先去 API Keys 页面确认 Key 状态，再对照接入文档检查配置字段。需要验证模型本身是否可用时，直接在模型对话页面发一条消息最快。长期跑编码和 Agent 任务的话，Coding Plan 页面有额度方案说明，按项目规模选就行。

配置骨架这部分，建议你把.claude/settings.json和.claude/agents/目录一起提交到项目仓库，这样换机器或加新角色时不用重新配一遍。subagent 定义文件本身就是团队的角色说明书，和代码一起版本管理，改了什么一目了然。