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 打通主会话与所有 subagent2.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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基地址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 文档 约束 - 必须显式列出“不做什么”边界比功能更重要 - 开放问题必须逐条列出强制人类拍板不允许自行假设 - 输出格式固定四段缺一段视为未完成 加载 Skillsbrainstorming, writing-plans 加载 Rulesspec-driven-workflowmodel: 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 8000Cline 的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/apiapi_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 报 401Key 无效或带了多余字符最常见的原因是复制 Key 时带上了首尾空格或者把 Key 写进了带引号的字符串但引号本身也被复制进去了。检查 settings.json 里ANTHROPIC_AUTH_TOKEN的值确保只有sk-开头的那串字符。另一个原因是 Key 被删除或过期去控制台确认这把 Key 还在。5.2 报 404base_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 定义文件本身就是团队的角色说明书和代码一起版本管理改了什么一目了然。
基于 Agent Teams 全栈实践个人网站开发【二】：Agent 团队搭建篇——TaoToken 统一 Key 接入与 subagent 配置骨架
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 打通主会话与所有 subagent2.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_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 基地址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 文档 约束 - 必须显式列出“不做什么”边界比功能更重要 - 开放问题必须逐条列出强制人类拍板不允许自行假设 - 输出格式固定四段缺一段视为未完成 加载 Skillsbrainstorming, writing-plans 加载 Rulesspec-driven-workflowmodel: 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 8000Cline 的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/apiapi_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 报 401Key 无效或带了多余字符最常见的原因是复制 Key 时带上了首尾空格或者把 Key 写进了带引号的字符串但引号本身也被复制进去了。检查 settings.json 里ANTHROPIC_AUTH_TOKEN的值确保只有sk-开头的那串字符。另一个原因是 Key 被删除或过期去控制台确认这把 Key 还在。5.2 报 404base_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 定义文件本身就是团队的角色说明书和代码一起版本管理改了什么一目了然。