企业官网建设流程全解析

用 Plato 跑 PRJ-123 时，真正卡住我的不是 ticket 拆解，而是第二个终端里那个 claude 工作进程的模型配额。后来我把执行 agent 的 Key 换到 TaoToken，一条统一 API 通道解决了多终端、多成员、多会话反复使用同一模型的问题。Plato 强调每个任务都用干净会话，让工作 agent 只加载当前角色需要的上下文，而不是背一整份聊天记录；但干净会话也有代价：每次启动 claude 都要重新认证模型通道，官方配额一紧，整个流程就卡在“等额度”而不是写代码上。TaoToken 把这一步统一掉了，design、planning、coding 各阶段，团队里任何人的执行终端，都走同一个 API 地址，用各自可控的 Key。下面从 PRJ-123 的实际操作顺序开始讲。

1. 先看 PRJ-123 在 Plato 里的实际执行路径

1.1 安装 skill 并初始化 .plato 与 plato-workspace

如果你还没装 Plato，先在任意项目里添加这个 skill：

npx skills@latest add CodePlato3721/plato -y -g

然后在要跑 PRJ-123 的项目根目录执行：

/plato init

Plato 会在项目下建立两个目录：.plato存放运行必需的规则文件，plato-workspace存放你和 agent 共同维护的项目文档与 ticket 工作区。这两个目录要提交进 git，否则同事拉下来后没有规则文件，工作 agent 就只能裸奔。init 没有执行，或者执行时机不对，后面/plato PRJ-123会报找不到规则目录，生成的命令里--append-system-prompt-file指向的路径也是空的。

1.2 guide 会话与执行终端的分工

Plato 至少要开两个终端。一个跑 guide 会话，跟/platoskill 交互，负责创建 ticket、维护任务进度、产出执行命令；另一个终端真正执行任务，跑 guide 给的 claude 工作进程。在 VS Code 里，可以把 guide 放在 Claude Code 插件窗口，第二个终端开在编辑器底部。两个窗口各管一段：guide 的上下文不会被实现细节塞满；工作 agent 每阶段都是干净会话，不会把上一阶段的中间结论当成项目规则。很多人第一次用 Plato 不习惯这种双窗口，觉得麻烦，但正是这个设计避免了“聊太久之后 agent 把反模式当成真理”。

1.3 /plato PRJ-123 拿到 claude 执行命令

假设从 Jira 拿到 PRJ-123：给系统增加购物车功能。在 guide 窗口输入：

/plato PRJ-123

Plato 会先问 feature 还是 defect，选 feature；再问 simple 还是 complex，购物车要跨好几个页面联动，选 complex feature。然后它创建plato-workspace/tickets/PRJ-123工作区，并给出一条执行命令，形式类似：

claude --dangerously-skip-permissions \ --session-id "<plato-生成的-session-id>" \ --append-system-prompt-file ".plato/designer/<当前角色规则文件>" \ "ticket-number=PRJ-123..."

--session-id决定工作 agent 的会话身份，--append-system-prompt-file把角色规则插到系统提示里。命令由 Plato 原样给出，你不用手工拼 UUID，直接复制到第二个终端。

1.4 工作 agent 的上下文由规则文件驱动

工作 agent 启动后，决定它行为的主要是.plato下那些角色化文档。Plato 把规则拆成 designer、planner、coder 等各自适用的文档，再加上项目架构文档，而不是把所有内容堆进一个 CLAUDE.md，每次新会话只加载当前角色需要的文件。这是它应对“规则文档多到上下文不够”的核心办法。我踩过的坑在于：.plato规则写得再完整，模型通道一旦在第二个终端断掉，一切归零。官方端点配额不足、连接超时，工作 agent 直接退出；重试后又得重新对齐执行状态，设计阶段讨论到一半的思路全忘了。这个断点跟 Plato 无关，是模型通道的问题。

2. 工作 agent 的模型通道：在 settings.json 里接 TaoToken

2.1 为什么改模型通道而不改 Plato 命令

工作 agent 的本质是一个 claude 进程。Claude Code 原生支持通过环境变量切换 API 端点，它认三个变量：ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL。所以正确的接入方式不是去改/plato生成的命令，而是让 claude 进程在启动时读到这三个变量。TaoToken 在这里的角色是统一 API 通道，不干预 Plato 的 ticket 流程，--session-id、--append-system-prompt-file、.plato目录规划全部保持原样。只替换一件事：模型请求发往哪里。

2.2 先去 TaoToken 官网创建一个 Key

在配置之前，先打开 TaoToken，注册账号，进入控制台创建一个 API Key。Key 创建后只会完整显示一次，顺手填进下一步的配置。模型 ID 不要凭印象写，以模型广场上列出的为准；某些模型系列有不同规格和日期版本，ID 差一个字符就会 404。

2.3 配置 ~/.claude/settings.json 的 env

推荐把环境变量写进~/.claude/settings.json，这样无论从哪个终端启动 claude，都会自动应用：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_MODEL": "从模型广场复制的模型 ID" } }

三点说明：

• ANTHROPIC_BASE_URL填https://taotoken.net/api，末尾不要加/v1；
• ANTHROPIC_AUTH_TOKEN替换成你在官网创建的真实 Key；
• ANTHROPIC_MODEL以模型广场当前列表为准，不要照抄旧教程里的模型名。

如果只是临时跑一次，也可以把变量写到当前终端：

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" export ANTHROPIC_MODEL="从模型广场复制的模型 ID"

写进 settings.json 的好处是每个终端都生效，适合团队里多个人各自开 guide 的场景。

2.4 快速确认模型 ID 与 Key 可用

配置保存后先别急着跑 PRJ-123。开一个临时 Claude Code 会话，问一句“你现在是什么模型”；如果返回的模型名和你填的一致，说明 claude 已经借道 TaoToken 的 API 通道拿到模型。也可以用配套 CLI 发一条测试消息：

npm install -g @taotoken/taotoken taotoken cc -k YOUR_API_KEY -u https://taotoken.net/api -m 模型广场上的模型 ID

CLI 正常返回，说明 Key 和模型 ID 都可用，再回 Plato 正式开工。这个前置检查能省掉后面很多排查时间。

3. 第二个终端跑通 PRJ-123 的完整验证

3.1 原样执行 claude 命令，工作 agent 自动走新通道

回到 guide 会话，把/plato PRJ-123给出的 claude 命令复制到第二个终端，直接回车。命令不用改。Claude Code 启动时读 settings.json，请求自动发往https://taotoken.net/api。工作 agent 起来后，--append-system-prompt-file指定的规则照常加载，--session-id保持会话干净。TaoToken 只负责模型请求这一跳，不碰 Plato 的目录结构，也不碰plato-workspace里的任何文件。工作 agent 产出的代码、SQL、重构建议，仍然要由你在本地审查后再执行，它不会去连你的生产环境。

3.2 用控制台核对这次调用

验证这次调用真正走通，方法非常简单：工作 agent 开始回答问题后，打开 TaoToken，找到刚才创建的 Key，如果用量记录里出现了一条新请求，说明链路已经通：claude → https://taotoken.net/api → 模型 → 返回工作 agent。看用量比翻日志直观，也更适合团队里不熟命令行的同事自查。

3.3 确认 .plato 规则文件被加载

如果你担心新会话忘记规则，可以先在工作 agent 窗口问一句“你现在加载了哪些规则文件”。回答里如果包含.plato/designer/...之类路径，说明规则已经进上下文；如果 agent 一脸茫然，回 guide 检查--append-system-prompt-file的路径是否在当前项目目录内。路径正确、文件存在、agent 也承认读到了，规则这块就正常。不要一遇到新会话忘规则就怀疑通道，通道只转发请求，不负责文件加载。

3.4 design / planning / coding 多阶段共用同一把 Key

PRJ-123 这种 complex feature 会经历 design、planning、coding 多个阶段。每完成一个阶段，在第二个终端用/exit退出工作 agent，然后回 guide 再次输入/plato PRJ-123。Plato 会生成下一条执行命令，--session-id又是全新的，但 Key 和 Base URL 始终不变。这意味着每个阶段都是干净会话，模型通道始终由同一把 Key 兜底；几个人同时跑不同任务，也不会互相挤占。

4. 团队多人开 guide 时，Key 与模型怎么统一管

4.1 各自创建 Key，而不是共享一把

团队协作时不要共享一把 Key。TaoToken 支持按账号创建 API Key，每个人在控制台注册自己的，独立创建。A 同事的 Key 误删或触发限制，B 同事的 PRJ-123 照常跑。共享 Key 看起来省事，实际上一次限额打满全组瘫痪，排查是谁刷爆了还得翻日志。

4.2 按 Key 查用量，成本摊到团队和项目

每把 Key 在控制台都有独立用量记录。design 阶段烧了多少，coding 阶段烧了多少，按 Key 一查就清楚。一个项目组如果要把模型成本摊到不同业务线，这个记录就是现成依据。你也可以专门给长期任务单独建一把 Key，任务结束时整体对账。

4.3 切模型只改 ANTHROPIC_MODEL

想切新模型，只改 settings.json 里的ANTHROPIC_MODEL，重启工作 agent 生效。因为 Plato 每个任务都是新会话，改动不会污染已经跑了一半的旧任务。长会话里切模型则麻烦得多：新模型没有旧上下文，旧上下文又带着旧模型的习惯。Plato 的会话隔离和模型切换在这里配合得正好。

5. PRJ-123 途中常见的报错对照

5.1 401：Key 或环境变量没进到 claude 进程

第二个终端里的 claude 启动后报 401，优先检查 settings.json：YOUR_API_KEY是否被真实 Key 替换、JSON 是否合法、Key 有没有多复制空格。另一个典型现象是启动时弹出官方 OAuth 登录提示，这通常意味着ANTHROPIC_BASE_URL没被读到，或者ANTHROPIC_AUTH_TOKEN为空。这条链路跟 Plato 无关，纯模型通道问题。

5.2 404：模型 ID 与模型广场不一致

报 404 时去模型广场查模型 ID。带日期后缀的模型名最容易抄错，一个字符不对就 404。把ANTHROPIC_MODEL改成模型广场上当时显示的 ID，重启工作 agent。长周期任务运行中如果突然报模型不存在，也先回模型广场确认该 ID 是否下线或改名。

5.3 Base URL 误填成网页地址

ANTHROPIC_BASE_URL是 API 端点，不是官网落地页。比如https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=是给人点击注册、创建 Key 用的页面；Claude Code 能识别的是https://taotoken.net/api，不带查询参数，也不带/v1。官网和 API 的分工要分清：官网管账号和用量，/api管模型请求。

5.4 规则文件没加载，不是通道的问题

换了模型通道之后新会话仍然忘记规则，先查--append-system-prompt-file指向的文件是否存在、路径是否在项目内；再查.plato和plato-workspace是否提交进 git，同事有没有 pull 最新规则。还有一点容易被忽略：guide 会话和工作 agent 必须在同一个项目根目录下运行，路径错位会导致规则文件加载不到。这些属于 Plato 规则管理问题，不要甩给模型通道。

6. PRJ-123 跑完后，把规则沉淀成项目资产

6.1 在 guide 里 review 工作 agent，形成提问闭环

一个阶段执行完，不要急着 commit。Plato 的透明体现在这里：它不会同时开一堆不可见的 subagent，只保留一个工作 agent，也不会自动提交代码。回到 guide 会话，让工作 agent 解释它改了什么、为什么这么改，然后像 code review 一样继续追问。Plato 的核心是提问：设计阶段它问你，审阅阶段你问它。如果 agent 丢出一句“已修复，测试通过”，不要直接放行，要求它把实际测试输出贴回对话。这样可以避免假阴性单测——AI 重写大量代码后宣称通过，线上另一个功能却坏了。

6.2 把这次 PRJ-123 的约束写回 .md 文档

一个任务真正沉淀下来的不是代码 diff，而是过程中总结出的约束和决策：为什么购物车不能直接在旧订单表上扩展？为什么这个模块的缓存只放在 service 层？把这些内容写进.plato对应角色文档或plato-workspace下的.md文件。下一次/plato PRJ-124创建新会话时，--append-system-prompt-file会把更新后的规则加载进去。规则越攒越厚，agent 的行为越收敛，最终 PR 也不会再是没人看得懂的巨型改动。

6.3 回到控制台对账，顺手看看 Coding Plan

PRJ-123 全部跑完后，回到 模型对话 用同一把 Key 发一条消息，确认通道还健康；任务量大可以看 Coding Plan 是否够用；新 Key 在 控制台 API Keys 创建；Claude Code 环境变量完整对照见 接入文档。团队里人人各自开 guide、共用一套通道时，最值得坚持的习惯是：代码由工作 agent 写，规则由你维护，模型通道交给 TaoToken。