企业官网建设流程全解析

1. 先判断：Cowork 并入 Claude 后，工作流里哪些 Key 要换

Claude 把 Cowork 与聊天合并为一个 Claude 的公开标题出来后，工作流平台管理员最先要处理的往往不是界面入口，而是调用凭证和 Token 计量口径。TaoToken（https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=cowork-key-checklist）可以先把 Key 收口到统一入口：在准备填写调用凭证前，打开官网创建或获取 Key，再把各客户端的 Base URL 指向https://taotoken.net/api。公开材料只给到“Cowork 与聊天合并为一个 Claude”的标题级信息，没有展开正文细节，所以本文不猜功能变化，只讨论可验证的接入动作：哪些 Key 先替、怎么替、替换后如何计量 Token、怎么排障。

如果你负责一个含有 Claude Code、Codex、CC Switch、CI 生成任务、日志摘要任务的工作流平台，替换顺序建议是：高风险硬编码 Key > 高频交互 Key > 批处理 Key > 只读归档 Key。不要一上来全量切换，否则一旦模型 ID、协议或环境变量冲突，排查成本会成倍增加。先把调用方列出来，再决定每个调用方是走 Anthropic 兼容协议，还是走 OpenAI 兼容协议。两套协议的环境变量不要混用，尤其不要把ANTHROPIC_*套到 Codex 上。

工作流里常见的凭证位置有六类：

1. 本地~/.claude/settings.json或项目级.claude/settings.json；
2. Codex 的config.toml；
3. CC Switch 里的 Claude Code 配置档；
4. CI/CD secrets，例如 GitHub Actions、GitLab CI、Jenkins 凭据；
5. 脚本或服务里的.env、Docker Compose、K8s Secret；
6. 临时终端里export过的环境变量。

替换前先做一张资产表，字段至少包括：工作流名、阶段、调用方、当前 Key 别名、当前 Base URL、目标 Base URL、模型 ID、Token 消耗方、替换优先级、验证命令、回滚方式。目标 Base URL 统一写成https://taotoken.net/api，不要在代码里混入查询参数或 UTM。UTM 只用于官网和 deep link 入口，工具配置里的 Base URL 不加 UTM。

判断“先替哪类 Key”可以用一个简单矩阵：

这张表的用途不是做理论分类，而是给每个工作流打标签。标签打完后，你才能回答“Cowork 并入 Claude 后，TaoToken 先替哪类 Key”这个问题：先替直接面向开发者交互、且已经用环境变量管理的 Claude/Anthropic Key，因为它们最容易验证、最容易回滚；其次替 Codex 这类 OpenAI 兼容配置；最后替批处理和归档任务。

2. 管理员交付物：一份可执行的 Key 替换清单

工作流平台管理员不要只交一张“Key 已换”的结论，而要交一份别人能照着做的替换清单。清单里必须出现三个确定性信息：Base URL 是https://taotoken.net/api，Key 占位符是YOUR_API_KEY，每个工作流的 Token 消耗方是谁。建议先用 YAML 做清单，再同步到表格或工单系统。

workflows: - name: claude-code-local stage: dev caller: Claude Code protocol: anthropic base_url: https://taotoken.net/api key_alias: taotoken-claude-dev model: YOUR_CLAUDE_MODEL_ID token_consumers: - interactive_chat - code_edit - code_review priority: P0 - name: codex-ci stage: ci caller: Codex CLI protocol: openai_compatible base_url: https://taotoken.net/api key_alias: taotoken-codex-ci model: YOUR_CODEX_MODEL_ID token_consumers: - code_generation - unit_test_generation priority: P1 - name: log-summary-batch stage: prod caller: batch-worker protocol: http base_url: https://taotoken.net/api key_alias: taotoken-summary-prod model: YOUR_SUMMARY_MODEL_ID token_consumers: - long_context_summary - retry_on_timeout priority: P2

这份 YAML 可以直接放进仓库的docs/ai-key-migration.yaml，但不要把真实 Key 写进去，只写YOUR_API_KEY或 Key 别名。真实 Key 在 TaoToken 控制台创建后，放到各平台的 Secret 管理中。创建 Key 的入口可以走文末 deep link，也可以在准备填写调用凭证前先打开 TaoToken 官网：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=key-replacement-list 。

接着把清单扩展成 CSV，方便非技术同学 review：

workflow,stage,caller,key_alias,base_url,model,token_consumer,priority claude-code-local,dev,Claude Code,taotoken-claude-dev,https://taotoken.net/api,YOUR_CLAUDE_MODEL_ID,交互对话;代码编辑;代码审查,P0 cc-switch-dev,dev,CC Switch,taotoken-ccsw-dev,https://taotoken.net/api,YOUR_MODEL_ID,交互对话;上下文压缩,P0 codex-ci,ci,Codex CLI,taotoken-codex-ci,https://taotoken.net/api,YOUR_CODEX_MODEL_ID,代码生成;单测生成,P1 ticket-classify,prod,ticket-worker,taotoken-ticket-prod,https://taotoken.net/api,YOUR_CLASSIFY_MODEL_ID,工单分类;意图识别,P1 log-summary,prod,batch-worker,taotoken-summary-prod,https://taotoken.net/api,YOUR_SUMMARY_MODEL_ID,长文本摘要;超时重试,P2 doc-archive,prod,archive-worker,taotoken-archive-prod,https://taotoken.net/api,YOUR_ARCHIVE_MODEL_ID,归档摘要;向量化前清洗,P2

清单完成后，先不要忙着改生产。按下面顺序执行：

1. 在 TaoToken 创建两组 Key：dev和prod，不要一个 Key 跑所有环境；
2. 在测试环境替换ANTHROPIC_AUTH_TOKEN或TAOTOKEN_API_KEY；
3. 用最小请求验证模型可用；
4. 记录请求日志中的model、prompt_tokens、completion_tokens、total_tokens；
5. 观察 24 小时，再灰度生产；
6. 生产稳定后，删除旧 Key 或禁用旧 Base URL。

注意，Token 计量不是只看总账单。工作流平台里真正消耗 Token 的通常是这些节点：交互式对话、代码编辑、代码审查、长上下文摘要、工单分类、意图识别、超时重试、工具调用循环、并行分支、缓存未命中、开发环境共用 Key。把每个消耗方写进清单，后续优化才有依据。

3. Claude Code：settings.json 与 ANTHROPIC_* 的替换写法

Claude Code 是工作流平台里最应该先替换的一类调用方。它通常直接用ANTHROPIC_*环境变量，配置集中，验证简单。推荐在用户级~/.claude/settings.json或项目级.claude/settings.json中写：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_MODEL": "YOUR_CLAUDE_MODEL_ID", "ANTHROPIC_SMALL_FAST_MODEL": "YOUR_FAST_MODEL_ID" } }

这段配置的关键点有三个：

• ANTHROPIC_BASE_URL必须是https://taotoken.net/api，不要带 UTM，也不要自己拼接多余路径；
• ANTHROPIC_AUTH_TOKEN用YOUR_API_KEY占位，真实值放本地或 Secret 管理；
• ANTHROPIC_MODEL和ANTHROPIC_SMALL_FAST_MODEL写你实际可用的模型 ID，不确定时先在 TaoToken 模型对话页确认。

如果你同时保留了旧的ANTHROPIC_API_KEY，可能会和ANTHROPIC_AUTH_TOKEN冲突。替换时先检查终端：

env | grep ANTHROPIC

把旧变量清理掉，再重新打开终端，或者显式取消：

unset ANTHROPIC_API_KEY unset ANTHROPIC_BASE_URL unset ANTHROPIC_AUTH_TOKEN unset ANTHROPIC_MODEL

然后在当前 shell 中临时验证：

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" export ANTHROPIC_MODEL="YOUR_CLAUDE_MODEL_ID"

最后用 Claude Code 的最小任务验证：

claude -p "只回复 ok"

如果返回正常，再回到settings.json固化配置。不要用 Claude Code 去直连生产库，也不要把排障命令交给 MCP/Agent 去执行。Claude Code 的验证只应做本地只读或沙箱任务，例如读取当前目录、生成摘要、解释代码片段。

Claude Code 替换后常见的三个问题：

1. 401：Key 错误、Key 前后有空格、环境变量没有加载、CC Switch 覆盖了settings.json。
2. 404：Base URL 写错，或者模型 ID 不存在。先确认ANTHROPIC_BASE_URL是https://taotoken.net/api，再确认模型 ID。
3. 流式中断：通常是网络层或客户端参数不匹配。先用最小请求验证，不要直接在生产工作流里重试。

如果你用 CC Switch 管理多个 Claude Code 配置，下一节再展开。这里先记住：Claude Code 只认 Anthropic 兼容变量，Codex 不要照抄这段ANTHROPIC_*配置。

4. Codex：config.toml 不要混用 ANTHROPIC_*

Codex 走的是另一套配置体系，典型文件是config.toml，不是settings.json。工作流平台管理员最容易犯的错，是把 Claude Code 的ANTHROPIC_*直接复制到 Codex，结果环境变量找不到、协议不匹配、流式响应失败。Codex 应该用独立的TAOTOKEN_API_KEY。

一个可参考的config.toml写法如下：

model = "YOUR_CODEX_MODEL_ID" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY" wire_api = "chat"

然后在 shell 中设置 Key：

export TAOTOKEN_API_KEY="YOUR_API_KEY"

Windows PowerShell 可以写：

$env:TAOTOKEN_API_KEY="YOUR_API_KEY"

验证 Codex：

codex --version codex exec "只回复 ok"

这段配置与 Claude Code 的差异要明确：

Codex 替换时，CI 环境要特别小心。很多 CI 会把旧 Key 写在 secret 里，然后通过env_key读取。如果你只改了config.toml，没有改 secret 名称，Codex 会报 Key 不存在。建议把 secret 名称也纳入替换清单：

• OPENAI_API_KEY→TAOTOKEN_API_KEY
• OPENAI_BASE_URL→ 不再使用，改为config.toml中的base_url
• ANTHROPIC_AUTH_TOKEN→ 仅用于 Claude Code，不用于 Codex

Codex 验证通过后，再接入 CI 生成任务。不要在 CI 里执行会修改生产数据的命令，也不要让 Codex 直连生产库。生成类任务只输出补丁、测试用例或文档草稿，最终合并由人工或既有流水线完成。

5. CC Switch 三件套：Base URL、API Key、模型

CC Switch 适合管理多个 Claude Code 配置档。对工作流平台管理员来说，它最大的价值是灰度：开发用一套，测试用一套，生产用一套，切换时不用改全局settings.json。但 CC Switch 也有一个坑：它会覆盖环境变量，导致你在终端里export的 Key 看起来没生效。

CC Switch 的三件套可以理解为：

1. Base URL：https://taotoken.net/api
2. API Key：YOUR_API_KEY
3. Model：YOUR_MODEL_ID或你的实际模型 ID

在 CC Switch 里新增一个 TaoToken 配置档，字段映射可以写成：

{ "name": "TaoToken", "baseUrl": "https://taotoken.net/api", "apiKey": "YOUR_API_KEY", "model": "YOUR_MODEL_ID" }

实际界面字段名可能不同，但核心就是这三项。不要在这里填 Codex 的TAOTOKEN_API_KEY，也不要把 Codex 的config.toml内容粘进来。CC Switch 是给 Claude Code 用的，协议仍然是 Anthropic 兼容。

配置完成后，建议做三步验证：

claude -p "当前使用哪个模型？只回复模型名"

如果模型名不对，检查 CC Switch 是否选中了 TaoToken 配置档。然后检查环境变量：

env | grep ANTHROPIC

如果看到旧 Base URL 或旧 Key，说明 shell 里的变量优先级更高。先清理旧变量，再重启终端或 IDE。最后在 CC Switch 中切换一次再切回，确认配置档不会互相污染。

CC Switch 的替换清单可以单独列一行：

workflow,stage,caller,key_alias,base_url,model,token_consumer,priority cc-switch-dev,dev,CC Switch,taotoken-ccsw-dev,https://taotoken.net/api,YOUR_MODEL_ID,交互对话;上下文压缩,P0 cc-switch-test,test,CC Switch,taotoken-ccsw-test,https://taotoken.net/api,YOUR_MODEL_ID,回归测试;代码审查,P1

Token 计量上，CC Switch 本身不产生额外消耗，但它切换的模型会影响成本。比如长上下文任务切到大模型，成本会明显上升。建议在 CC Switch 配置档里固定模型 ID，不要让它跟随默认模型漂移。

6. Token 计量：列出工作流里的消耗方，按节点打标签

Key 替换完成后，下一步是把 Token 消耗方列清楚。很多团队换完 Key 只看到总用量，却不知道是谁用的。工作流平台管理员要把“调用方”和“消耗方”分开：调用方是 Claude Code、Codex、CC Switch、批处理 Worker；消耗方是具体任务，比如交互对话、代码生成、代码审查、长文本摘要、工单分类、重试、工具调用循环。

建议每个请求都记录以下字段：

request_id workflow_name stage caller key_alias model prompt_tokens completion_tokens total_tokens retry_count latency_ms status

如果客户端不直接返回 Token 明细，就在应用层记录请求前后的估算值，或者通过 TaoToken 控制台的 Key 维度用量做拆分。拆分时至少按 Key 别名区分dev、test、prod，否则开发环境的调试请求会混进生产账单。

Token 消耗方清单可以按下面表格整理：

这里要特别强调：不要让 MCP/Agent 直连 Oracle 或生产库。Token 计量可以在应用层做，排障命令只在本地终端执行。比如本地聚合日志可以用grep、awk这类命令，不要写一个 Agent 去查生产数据库。

本地日志聚合示例：

grep '"workflow_name"' app.log \ | grep '"total_tokens"' \ | awk -F'"total_tokens":' '{print $2}' \ | awk -F',' '{sum+=$1} END {print sum}'

这个命令只是示例，实际日志格式按你的应用调整。核心目标不是写复杂脚本，而是让每个工作流都能回答三个问题：谁调的、用了哪个 Key、消耗在哪个节点。

7. 排障：401、404、模型不存在、用量突增怎么查

替换 Key 后，排障顺序要从客户端到服务端，不要一上来就改工作流。下面按错误类型拆开。

401 未授权

常见原因：

• YOUR_API_KEY没有替换成真实 Key；
• Key 复制时带了空格或换行；
• Secret 名称写错，例如 Codex 用了OPENAI_API_KEY；
• CC Switch 覆盖了settings.json；
• 终端旧变量没清理。

检查命令：

env | grep -E "ANTHROPIC|TAOTOKEN|OPENAI"

Claude Code 重点看ANTHROPIC_AUTH_TOKEN，Codex 重点看TAOTOKEN_API_KEY。不要把两者混用。

404 路径或模型不存在

常见原因：

• Base URL 写成https://taotoken.net/api/或带多余路径；
• 客户端自动拼接了不兼容的路径；
• 模型 ID 写错；
• Codex 的wire_api与客户端要求不一致。

先确认 Base URL 是https://taotoken.net/api，再确认模型 ID。Claude Code 用ANTHROPIC_MODEL，Codex 用model。

429 并发或限流

工作流平台常见于批量任务同时触发。解决方式：

• 给批处理加并发上限；
• 对 429 做指数退避；
• 区分dev、prodKey，避免开发调试挤占生产；
• 把非紧急任务放到低峰。

用量突增

不要只看总账单，按 Key 别名拆：

1. 哪个 Key 突增？
2. 哪个工作流使用这个 Key？
3. 该工作流是否在重试？
4. 是否把长上下文任务切到了大模型？
5. 是否有循环调用或工具调用轮次过多？
6. 是否缓存未命中导致重复请求？

本地验证命令示例：

claude -p "只回复 ok" codex exec "只回复 ok"

如果这两个最小请求正常，说明凭证和 Base URL 基本正确，问题在工作流参数或业务逻辑。如果最小请求失败，先修配置，不要动业务流程。

8. 上线顺序与 CTA：从模型对话到 Coding Plan 到创建 Key 到 Claude Code 文档

最后给一个可以直接执行的上线顺序。

第一步，在 TaoToken 模型对话页确认可用模型。打开： https://taotoken.net/models/detail/chat?utm_source=taotoken_aicg_blog_end&utm_content=key-checklist 先选你要用的模型，记下模型 ID，再写入 Claude Code 或 Codex 配置。

第二步，如果你的工作流主要是编码、代码审查、CI 生成，可以查看 Coding Plan： https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=key-checklist 把开发、测试、生产 Key 分开规划，避免一个 Key 跑所有环境。

第三步，创建 Key。打开： https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=key-checklist 创建至少两组 Key：taotoken-dev、taotoken-prod。如果 CI 单独计费，再加taotoken-ci。创建后只把 Key 放到本地或 Secret 管理，不要写进仓库。

第四步，配置 Claude Code。参考 Claude Code 文档： https://taotoken.net/doc/ClaudeCodeAnthropic?utm_source=taotoken_aicg_blog_end&utm_content=key-checklist 把ANTHROPIC_BASE_URL设为https://taotoken.net/api，把ANTHROPIC_AUTH_TOKEN设为YOUR_API_KEY，把模型 ID 换成你在模型对话页确认的值。

替换清单最终版应该包含：

• 每个工作流的 Base URL：https://taotoken.net/api；
• 每个工作流的 Key 别名；
• 每个工作流的模型 ID；
• 每个工作流的 Token 消耗方；
• 每个工作流的验证命令和回滚方式。

如果只能先替一类 Key，我的建议是：先替 Claude Code 和 CC Switch 使用的 Anthropic 兼容 Key，再替 Codex 的 OpenAI 兼容 Key，最后替批处理和归档 Key。原因不是其他 Key 不重要，而是这两类 Key 最容易验证、最容易灰度、最容易在出问题时回滚。TaoToken 官网入口可以先从 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=token-metering 进入，把 Key 创建、Base URL 替换、Token 消耗方盘点三步做完，再回到工作流平台做灰度上线。