企业官网建设流程全解析

1. 从 Claude Code 的 401 说起：先把 Key 和请求地址切到 TaoToken

在 Claude Code 里执行“把docs/spec.md生成 docs artifact 并分享给同事”时，如果终端返回401 Invalid API Key、Connection error，或者 artifact 面板一直不出现，第一件事不是反复改提示词，而是检查请求有没有走对地址。Claude Code 生成 docs artifacts 的请求会消耗 Token，而这些请求最终发往哪个 Base URL、带的是哪个 Key，决定了团队协作能不能复现。建议先去 TaoToken 官网拿 Key：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=claude_code_docs_artifacts_intro ，然后把 Claude Code 的请求地址设为https://taotoken.net/api。这样后续让 Claude 生成 docs artifact、slides artifact、Claude Docs 单页文档、Claude Slides deck、Claude Design 视觉配套时，消耗的才是 TaoToken 侧对应 Key 的请求。

这里先把最容易串的链路讲清楚：

• Key 来源：TaoToken 控制台创建的 API Key，占位符统一写成YOUR_API_KEY。
• 请求地址：https://taotoken.net/api，这是工具配置用的 Base URL，不加 UTM。
• Claude Code 侧核心变量：ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_MODEL。
• 消耗 Token 的动作：Claude Code 中生成文档工件的请求，例如把 spec 整理成 docs artifact、把 docs 转成 slides、用 Claude Design 生成配套视觉。
• 团队协作目标：每个人都用自己的 Key，但共享同一套项目配置、同一套 artifact 命名规范、同一套评审流程。

如果你之前把 Key 写在脚本里，或者把 Base URL 临时 export 在某个终端窗口，换一个终端后 Claude Code 可能又回到默认地址，于是出现“我本机可以，同事那边就 401”的典型团队问题。下面从最小配置开始，把 Key、Base URL、模型名落到 Claude Code 可读取的位置。

2. settings.json 与 ANTHROPIC_*：Claude Code 生成 docs artifacts 的最小可用配置

Claude Code 的配置可以走环境变量，也可以走settings.json。团队协作时推荐拆开：

• 个人敏感信息：ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY放个人环境变量，或者由 CC Switch 管理，不提交到 Git。
• 项目公共配置：Base URL、默认模型、权限、允许的工具范围，放项目级.claude/settings.json，提交到仓库。
• 临时覆盖：在单次终端里 export，仅用于排障，不作为团队标准。

先看项目级.claude/settings.json的写法。注意 JSON 不支持注释，下面只是示例，实际使用时把YOUR_CLAUDE_MODEL换成 TaoToken 控制台或模型对话页里显示的可用模型名：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_MODEL": "YOUR_CLAUDE_MODEL", "ANTHROPIC_SMALL_FAST_MODEL": "YOUR_CLAUDE_FAST_MODEL" } }

Key 不建议写进这个文件。更稳妥的方式是在个人 shell 里设置：

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

Windows PowerShell 对应写法：

$env:ANTHROPIC_BASE_URL="https://taotoken.net/api" $env:ANTHROPIC_AUTH_TOKEN="YOUR_API_KEY" $env:ANTHROPIC_MODEL="YOUR_CLAUDE_MODEL"

配置完成后不要只在一个旧终端里测试。关闭并重开终端，或者重启 Claude Code 所在的 IDE 窗口，让环境变量重新加载。然后检查：

echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKEN | sed 's/./*/g' claude --version

PowerShell 检查：

echo $env:ANTHROPIC_BASE_URL echo $env:ANTHROPIC_AUTH_TOKEN claude --version

如果ANTHROPIC_BASE_URL不是https://taotoken.net/api，或者ANTHROPIC_AUTH_TOKEN为空，那么 Claude Code 里生成 docs artifact 的请求就不会走 TaoToken。此时即使提示词写得再完整，也可能在终端看到 401、403 或连接超时。

进一步可以用最小请求验证 Key 和地址。下面命令里的模型名同样使用占位符，实际执行前替换：

curl -sS https://taotoken.net/api/v1/messages \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "anthropic-version: 2023-06-01" \ -H "content-type: application/json" \ -d '{ "model": "YOUR_CLAUDE_MODEL", "max_tokens": 64, "messages": [ { "role": "user", "content": "只回复 pong" } ] }'

如果控制台要求用x-api-key，把Authorization: Bearer YOUR_API_KEY换成：

-H "x-api-key: YOUR_API_KEY"

这一步只验证 Key、Base URL、模型名三件事。验证通过后，再进入 Claude Code 会话，让它读取项目文档并生成 artifact。不要把验证命令和业务数据混在一起，也不要在共享终端里回显完整 Key。团队里每个人应该有自己的YOUR_API_KEY，项目配置只共享 Base URL 和模型名。

如果你还没有 Key，可以直接在 TaoToken 官网创建：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=claude_code_docs_artifacts_key 。创建后先放到个人环境变量或 CC Switch，不要提交到仓库。

3. CC Switch 三件套：团队多 Key、多环境切换不串配置

团队里常见的另一类问题是：同一个人既要给项目 A 用 TaoToken，又要临时切到另一套配置；或者前端、后端、测试各自用不同 Key。靠手改settings.json很容易把 Key 写进 Git，或者把 Base URL 改错。这时可以用 CC Switch 这类配置切换工具，把“供应商三件套”管理起来。

所谓三件套，核心是：

在 CC Switch 里新增一个 Claude Code 配置，填好上述三件套，保存后切换到该配置。切换完成后，重新打开终端和 Claude Code，再用上一节的echo $ANTHROPIC_BASE_URL检查是否生效。注意 CC Switch 改的是 Claude Code 侧配置，不要把ANTHROPIC_*变量写进 Codex。Codex 如果需要走 TaoToken，应在~/.codex/config.toml里配置 provider，而不是复制 Claude Code 的环境变量。

Codex 侧只需要记住原则：Codex 用config.toml，Claude Code 用settings.json/ANTHROPIC_*，两者不要混。下面是一个 Codex 侧的占位示例，仅用于说明配置位置，模型名和 provider 字段以实际控制台说明为准：

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

Claude Code 团队协作更推荐这样分工：

1. 项目仓库提交.claude/settings.json，只放ANTHROPIC_BASE_URL和默认模型，不放 Key。
2. 每个成员在 CC Switch 或本地环境变量中配置自己的ANTHROPIC_AUTH_TOKEN=YOUR_API_KEY。
3. 在团队文档里写清楚：切换供应商后必须重开终端，并用echo检查 Base URL。
4. PR 模板里加一句“本 PR 涉及 docs artifact 时，请贴 artifact 链接和生成所用模型”。
5. 不在聊天群里发完整 Key。需要轮换时，到 TaoToken 控制台重新创建，再让成员各自替换。

这样配置后，当你在 Claude Code 里让 Claude 读取docs/spec.md并生成 docs artifact 时，请求会稳定走https://taotoken.net/api，而不是因为终端环境不同而随机走默认地址。团队里谁生成了哪个 artifact、用了哪个模型、消耗了哪次请求，也更容易追踪。

如果你需要先确认 Key 是否可用，可以进入模型对话页做一次最小对话验证：https://taotoken.net/models/detail/chat?utm_source=taotoken_aicg_blog_end&utm_content=claude_code_docs_chat ，再回到 Claude Code 配置。

4. 让 Claude Code 生成 docs artifacts 的可复现命令

Claude Code 生成 docs artifacts 的价值在于：你可以把一次 spec 评审、一次接口设计、一次 onboarding 文档，从“聊天记录”变成可分享的文档工件。关键不是背某个神秘命令，而是把输入、约束、输出格式、共享方式写清楚。下面给出可复现的提示词模板，直接在 Claude Code 会话里执行。

先准备一个真实文件，例如：

docs/ spec.md api.md decisions.md

在项目根目录启动 Claude Code，然后输入第一段提示词：

读取 docs/spec.md，把它整理成一个 docs artifact，标题为“订单模块 v2 技术规格（评审稿）”。 必须包含以下章节： 1. 背景与目标 2. 范围与非目标 3. 接口定义与字段说明 4. 数据流与状态变化 5. 异常路径与错误码 6. 兼容性与迁移方案 7. 验收标准 8. 未决问题 要求： - 不新增 spec 中不存在的事实。 - 对不确定的地方标记“待确认”，不要编造。 - 生成后给出可分享给团队成员的 artifact 链接或入口说明。

Claude Code 会读取文件、组织内容、生成 docs artifact。这一次生成文档工件的请求会消耗 Token。为了减少返工，可以先生成大纲，再生成完整文档：

先不要生成完整 artifact。请基于 docs/spec.md 列出 8 个章节的提纲，每个章节 3 条要点。我确认后再生成完整 docs artifact。

确认提纲后，再让它生成完整版本：

提纲确认。现在生成完整 docs artifact，标题“订单模块 v2 技术规格（评审稿）”，保留刚才的 8 个章节。生成后输出 artifact 分享链接。

接下来是团队评审环节。把 artifact 链接贴到 PR、Issue 或群公告里，让同事在 artifact 上评论。评论收敛后，让 Claude Code 根据最终意见更新文档：

读取刚才的 docs artifact 和 PR 评论摘要。把“错误码”章节按评论更新，新增 409 和 422 两种情况的处理说明。重新生成 docs artifact，版本号改为 v2-review-2，并列出本次变更点。

如果评审通过，需要转成 deck：

基于最新的 docs artifact，用 Claude Slides 生成一个 10 页 review deck。 页面顺序： 1. 问题 2. 目标 3. 方案概览 4. 接口 5. 数据流 6. 异常与错误码 7. 兼容性 8. 里程碑 9. 风险 10. 待确认与下一步 输出 slides artifact 分享链接，每页只保留一个核心结论。

如果还需要单页文档，可以让 Claude Docs 起草：

在对话中用 Claude Docs 起草单页文档：“本地启动与调试步骤”。 面向新加入的团队成员，包含： - 前置依赖 - 环境变量 - 启动命令 - 常见错误与排查 - 需要找谁确认 生成 docs artifact，标题为“onboarding-local-dev”。

如果还需要配套视觉，可以让 Claude Design 制作：

用 Claude Design 为刚才的 slides artifact 生成配套视觉： - 一张架构图 - 一张数据流图 - 一张状态机图 - 一张错误处理流程图 风格简洁，适合嵌入技术文档。输出可分享的 design artifact 或图片链接。

注意：生成 docs artifact、slides artifact、Claude Docs 单页、Claude Slides deck、Claude Design 视觉，都会触发请求。Token 消耗通常集中在生成长文档和幻灯片时。团队里可以约定：

• 先提纲后全文，避免直接生成大而全的 artifact。
• 一次只更新一个章节，减少整篇重写。
• 把最终 artifact 链接写进 PR 描述，而不是反复贴聊天截图。
• 对敏感项目，生成 artifact 前先确认输入文件里没有密钥、生产连接串、客户数据。

如果你希望把 Claude Code 配置成团队默认工作流，可以回到 TaoToken 官网确认 Key 和模型：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=claude_code_docs_artifacts_workflow ，然后在项目.claude/settings.json中固定 Base URL。

5. 团队共享对照表：docs、slides、design 分别怎么评审与归档

生成 artifact 只是第一步，团队协作还需要“谁看什么、什么时候看、看完做什么”。下面给出一张可直接放进团队 Wiki 的对照表。

推荐流程：

1. 文档作者在 Claude Code 中生成 docs artifact，命名带日期或版本，例如spec-order-v2-2026-02-14。
2. 把 artifact 链接贴到 PR 或 Issue，写清楚需要谁在什么时间前反馈。
3. 同事只评论不确定项和阻塞项，避免在聊天工具里分散讨论。
4. 作者让 Claude Code 按评论更新 artifact，输出变更点。
5. 评审通过后，用 Claude Slides 生成 deck，用于评审会或周会。
6. 如果需要视觉配套，用 Claude Design 生成架构图和数据流图，并回链到 docs artifact。
7. 最终让 Claude 按已确认的 docs artifact 产出代码变更，PR 描述里必须包含 artifact 链接。
8. 合并后把 artifact 链接归档到docs/artifacts.md，防止链接散落在聊天记录里。

这张表的关键是：docs artifact 是评审快照，不是唯一事实源。项目里的docs/spec.md仍然是源文件，artifact 是给团队评论和分享的视图。每次源文件变更后，重新生成 artifact，并更新版本号。这样同事不会拿旧 artifact 做实现依据。

另外，共享 artifact 前要检查权限。如果链接需要登录，就在团队公告里说明；如果链接对外可见，就不要放内部接口、密钥、客户数据。团队可以约定一套最小检查清单：

• 是否包含YOUR_API_KEY、真实 Key、Token、密码？
• 是否包含生产连接串、内部域名、客户数据？
• 是否包含未公开的商务信息？
• 是否标注了“评审稿”“已确认”“已归档”状态？
• 是否写明了负责人和截止时间？

这些检查不涉及任何生产库直连，也不需要 MCP 或 Agent 去访问外部系统。所有命令、文件读取、artifact 生成都在本地 Claude Code 会话中由读者自己执行。

6. 常见报错排查：401、404、模型不存在、artifact 不出现

团队配置最容易踩的坑集中在四类报错。下面按现象给出排查顺序。

第一类：401 Invalid API Key或authentication_error。

检查顺序：

echo $ANTHROPIC_BASE_URL echo $ANTHROPIC_AUTH_TOKEN

如果ANTHROPIC_AUTH_TOKEN为空，说明当前终端没有加载个人 Key。把YOUR_API_KEY放到个人环境变量或 CC Switch，然后重开终端。如果 Key 有空格、换行、引号，也会导致 401。重新复制 Key，不要手动补字符。如果团队里有人把 Key 提交到了 Git，立即到 TaoToken 控制台创建新 Key，并让所有人替换。

第二类：404 Not Found或路径错误。

Claude Code 的 Base URL 应配置为：

https://taotoken.net/api

不要额外写成https://taotoken.net/api/v1再让工具自己拼路径，除非你明确知道当前工具版本的要求。Base URL 末尾不要带多余斜杠，也不要带 UTM 参数。UTM 只用于浏览器访问官网和 deep link，不用于工具配置。

第三类：模型不存在或模型名不匹配。

在 Claude Code 会话里如果出现model_not_found，先确认ANTHROPIC_MODEL是否来自 TaoToken 控制台或模型对话页，而不是从旧项目复制过来的模型名。不同团队、不同时间可用的模型名可能不同。把模型名统一写成占位符YOUR_CLAUDE_MODEL，并在团队 Wiki 里维护一份“当前推荐模型名”。切换模型后重开 Claude Code。

第四类：Claude Code 能对话，但生成 docs artifact 不出现。

先确认是否真的是配置问题。可以让 Claude 先做一次短输出：

只输出当前会话使用的模型名和请求地址配置说明，不要生成 artifact。

如果短输出正常，说明 Key 和 Base URL 已生效。artifact 不出现通常和提示词、版本、权限有关。把提示词改成更明确的结构：

请生成 docs artifact，而不是在普通回复里输出 Markdown。 标题：spec-order-v2-review 章节：背景、目标、接口、数据流、异常、验收、未决问题。 生成后给出 artifact 链接或入口说明。

如果仍然不出现，检查当前 Claude Code 版本是否支持 artifacts，以及团队是否关闭了某些分享权限。不要为了绕过权限去连接生产系统，也不要让任何工具直连数据库。所有验证都在本地终端和 TaoToken API 请求层完成。

第五类：同事打开 artifact 链接失败。

可能原因包括：链接需要登录、链接权限范围不对、链接已过期、同事不在共享列表。解决办法不是重新生成十遍，而是确认 artifact 分享设置，把链接和访问说明一起发到 PR。对外部可见的 artifact，先做敏感信息检查。

排查完成后，建议把结论写进团队排障文档：

7. 文末 CTA：从模型对话到 Claude Code 文档

如果你还没有完成 Key 配置，可以按下面顺序走一遍：

1. 先到模型对话页验证 Key 和模型是否可用：https://taotoken.net/models/detail/chat?utm_source=taotoken_aicg_blog_end&utm_content=claude_code_docs_chat
2. 如果团队需要长期在 Claude Code 中生成 docs artifacts、slides、Claude Docs、Claude Slides、Claude Design，可以查看 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=claude_code_docs_coding_plan
3. 进入控制台创建和管理 API Key：https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=claude_code_docs_api_keys
4. 配置 Claude Code 时，把 Base URL 设为https://taotoken.net/api，把ANTHROPIC_AUTH_TOKEN设为YOUR_API_KEY，模型名以控制台为准。
5. 更完整的 Claude Code 接入说明可以看：https://taotoken.net/doc/ClaudeCodeAnthropic?utm_source=taotoken_aicg_blog_end&utm_content=claude_code_docs_guide

回到最初的目标：让 Claude Code 把 spec 写成 docs artifact，分享给同事征求意见，就绪后再让 Claude 按最终文档实现。这个流程能否在团队里复现，取决于三件事有没有固定下来：Key 从 TaoToken 官网获取，请求地址固定为https://taotoken.net/api，docs artifacts 的生成提示词和共享对照表写进团队规范。这样每个人都能在自己的终端里生成一致结构的 artifact，评审时看同一份文档，实现时按同一份验收标准推进。生成文档工件的请求会消耗 Token，所以先把配置做对，再让 Claude 生成完整 artifact，是最省返工的做法。