企业官网建设流程全解析

1. 从 spec 对话到 deck 工件：先把 Claude Code 的请求出口切到 TaoToken

如果你正在 Claude Code 里把一段 spec 讨论转成可分享的 slides 工件，却遇到 artifacts 生成请求没有按预期落到目标端点，或者团队同事拿到的 deck 与本地看到的不一致，那先别急着改提示词。演示协作者流程里真正容易出问题的环节，通常是请求出口：Claude Code 本身并不知道你要把 Claude Slides 的生成请求发到哪里，它只认 settings.json 里的 ANTHROPIC_BASE_URL 和 Key。建议先去 TaoToken 官网拿一个可用的 Key：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=slides-intro ，然后把请求地址统一设为 https://taotoken.net/api 。这样，从对话到 deck 的链路才可复现。

背景是 Claude Code 近期把 docs 和 slides 都纳入了 artifacts 能力：它既能把讨论中的 spec 写成 doc，也能继续转成 deck，还可以配合视觉材料。Thariq 在公开分享中描述过一种典型协作方式：先让 Claude 把 spec 落成 doc，发给同事征求意见，确认后再让 Claude 进入实现；@claudeai 的补充则把路径拆成三段——用 Claude Docs 起草单页文档、用 Claude Slides 转成 deck、用 Claude Design 制作配套视觉。对演示协作者来说，这意味着同一段对话可以同时产出文字稿、幻灯片和视觉资产，但前提是生成请求走对通道。需要特别注意的是，消耗 Token 的是 Claude Slides 中生成幻灯片工件的请求，而不是你在本地编辑 Markdown 或查看文件的操作。

这篇内容按“演示协作者”视角展开：假设你负责把一个已经讨论清楚的 spec 变成团队可评审的 deck，并且需要在本地保留可复现的配置、生成命令和评审对照。整条链路可以拆成四步：

1. 在 TaoToken 官网获取 Key，并把 Base URL 记为https://taotoken.net/api；
2. 在 Claude Code 的 settings.json 中写入 ANTHROPIC_* 配置；
3. 用对话让 Claude 先生成 doc 工件，再生成 slides 工件；
4. 用评审对照表检查 docs、slides、design 三类产出，定位 Token 消耗点。

只要第 2 步的请求地址填错，第 3 步的 artifacts 就可能根本不生成，或者生成到旧供应商那边。所以下面先处理配置，再处理提示词和评审流程。

2. Claude Code settings.json 接入 TaoToken：ANTHROPIC_* 字段的可复制配置

Claude Code 读取配置的优先级通常是：命令行参数 > 环境变量 > settings.json。为了避免“我明明改了配置但没生效”，建议直接使用 settings.json 的env字段集中管理。全局配置可以放在~/.claude/settings.json，项目级配置可以放在项目根目录的.claude/settings.json。如果你只想让当前项目走 TaoToken，项目级配置更清晰。

一个可复制的 settings.json 示例如下：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "YOUR_API_KEY", "ANTHROPIC_MODEL": "YOUR_MODEL_ID", "ANTHROPIC_SMALL_FAST_MODEL": "YOUR_SMALL_MODEL_ID" } }

这里有几个点需要核对：

• ANTHROPIC_BASE_URL必须写成https://taotoken.net/api，不要在后面误加/v1或其他路径，除非 TaoToken 控制台明确给出不同路径。
• ANTHROPIC_API_KEY的值替换成你在 TaoToken 官网申请到的 Key，本文统一用YOUR_API_KEY占位。
• ANTHROPIC_MODEL和ANTHROPIC_SMALL_FAST_MODEL不要照抄示例里的占位符，要以 TaoToken 控制台展示的模型 ID 为准。不同账号可见的模型可能不同，填错模型 ID 时 Claude Code 通常会报模型不存在或请求失败。
• 如果你之前为了测试其他供应商，在 shell 里 export 过ANTHROPIC_BASE_URL，环境变量会覆盖 settings.json。可以用下面的命令检查当前 shell 是否残留旧值：

env | grep -E 'ANTHROPIC|TAOTOKEN'

如果输出里出现了旧的 Base URL，先清理当前 shell 会话，或者关闭终端重新打开，再启动 Claude Code。清理示例：

unset ANTHROPIC_BASE_URL unset ANTHROPIC_API_KEY unset ANTHROPIC_MODEL unset ANTHROPIC_SMALL_FAST_MODEL

然后重新进入项目目录，确认 Claude Code 能读到配置文件：

cd /path/to/your/project claude --version claude

进入交互后，可以先让 Claude 做一个最小验证，例如：

请用一句话说明你当前使用的请求出口配置，不要输出任何 Key 内容。

如果 Claude 能正常响应，说明请求已经通过 TaoToken 出口发出。接下来再去生成 doc 和 slides 工件。TaoToken 官网入口在这里：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=slides-settings 。如果你还没有 Key，建议先完成创建，再继续下面的步骤，否则后面的 slides 生成请求会直接返回鉴权失败。

另外要注意：Claude Code 使用ANTHROPIC_*，Codex 使用config.toml，两者不要混用。后面第 4 节会单独给出 Codex 的配置示例。

3. 对话转 deck：把 spec 对话变成 Claude Slides 工件的提示词与目录约定

配置完成后，演示协作者的核心工作是把“对话”变成“可评审工件”。这里不建议一上来就让模型直接生成 slides，因为 slides 的页序和要点依赖 doc 的结构。更稳的流程是两段式：先让 Claude 把 spec 整理成 doc，人工确认范围、目标和非目标，再让 Claude 把 doc 转成 deck 工件。

先在项目根目录建立两个目录：

mkdir -p artifacts/docs mkdir -p artifacts/deck mkdir -p artifacts/design

然后在一个 Claude Code 会话中，先发出 doc 生成请求：

角色：你是技术方案整理者。 任务：把当前对话中的 spec 整理成一份单页 doc 工件。 输出路径：./artifacts/docs/spec.md 要求： 1. 用一段话说明背景与目标用户。 2. 列出本次范围与非范围。 3. 给出核心流程，最多 6 步。 4. 列出依赖、风险和待确认问题。 5. 不要编造未讨论过的接口、表结构或第三方服务。

这个请求会生成 doc 工件。等文件出现后，用本地命令查看：

ls -la artifacts/docs sed -n '1,120p' artifacts/docs/spec.md

确认 doc 内容没有偏离讨论范围后，再发出 slides 生成请求。这个请求才是会触发 Claude Slides 生成幻灯片工件的步骤，也是本文强调的 Token 消耗点。提示词可以写成：

角色：你是演示协作者。 任务：把 ./artifacts/docs/spec.md 转成 8 页 Claude Slides 工件。 输出路径：./artifacts/deck/spec-deck.md 约束： 1. 第 1 页：标题与一句话价值。 2. 第 2 页：问题背景与目标用户。 3. 第 3 页：方案总览与架构图占位。 4. 第 4 页：关键流程与数据流。 5. 第 5 页：里程碑与排期。 6. 第 6 页：风险与依赖。 7. 第 7 页：评审问题清单。 8. 第 8 页：下一步行动与负责人。 每页最多 5 条要点，避免长段落；保留 doc 中的术语，不要新增未确认事实。

生成后，一个可接受的spec-deck.md片段可能长这样：

# Spec 转 Deck 工件 ## 1. 标题与价值 - 面向团队评审的 deck 工件 - 从 spec 对话自动整理，减少手工排版 ## 2. 问题背景 - 评审材料分散在聊天记录与文档中 - 同事需要可分享的 doc 与 slides ## 3. 方案总览 - 对话沉淀为 doc - doc 转为 slides - 视觉资产单独产出 ## 4. 关键流程 - 收集 spec - 生成 doc - 确认范围 - 生成 deck - 团队评审

然后检查生成目录：

find artifacts -maxdepth 3 -type f | sort

如果artifacts/deck/spec-deck.md存在，说明 Claude Slides 工件已经落到本地。此时可以继续让 Claude 基于同一份 doc 生成配套 design 说明：

角色：你是视觉协作者。 任务：为 ./artifacts/deck/spec-deck.md 补充一份 design 说明工件。 输出路径：./artifacts/design/spec-design.md 要求：给出色板、字体层级、留白节奏、图示风格和每页视觉重点，不生成外部图片，只输出可评审的设计说明。

这样，同一个对话上下文就产出了 docs、slides、design 三类工件。团队评审时，大家对比的是本地文件，而不是聊天记录。这里再次强调：消耗 Token 的是 Claude Slides 中生成幻灯片工件的请求，尤其是你要求模型重新排版、扩写每页要点、根据评审意见二次生成 deck 时，Token 会集中消耗在这些生成请求上。

如果你还没有可用的 Key，可以先通过 TaoToken 模型对话入口验证调用方式：https://taotoken.net/models/detail/chat?utm_source=taotoken_aicg_blog_end&utm_content=slides-chat 。确认对话可用后，再回到 Claude Code 配置。

4. Codex config.toml 与 CC Switch 三件套：不要混用 ANTHROPIC_*

很多团队会同时使用 Claude Code 和 Codex。Claude Code 走ANTHROPIC_*，Codex 走config.toml，两者配置字段不同，不能把ANTHROPIC_BASE_URL直接写进 Codex 配置。Codex 的config.toml通常放在~/.codex/config.toml，一个可参考的 TaoToken 接入示例如下：

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

对应的环境变量可以这样设置：

export TAOTOKEN_API_KEY="YOUR_API_KEY"

注意：Codex 这边不要出现ANTHROPIC_API_KEY或ANTHROPIC_BASE_URL。如果你在同一个 shell 里同时使用 Claude Code 和 Codex，建议用 CC Switch 这类切换工具管理配置。所谓的“CC Switch 三件套”可以按下面三项核对：

1. Base URL：统一填https://taotoken.net/api，不要带 UTM 参数。UTM 只用于官网链接，不用于工具请求地址。
2. API Key：填YOUR_API_KEY对应的真实 Key，创建入口在 TaoToken 控制台。
3. Model：填 TaoToken 控制台展示的模型 ID，不要写占位符。

检查当前 Codex 配置是否生效，可以执行：

cat ~/.codex/config.toml codex --version

然后启动 Codex，观察请求是否正常返回。如果报鉴权失败，优先检查TAOTOKEN_API_KEY是否导出到当前 shell；如果报连接错误，优先检查base_url是否误写成了官网地址或其他路径。记住：工具配置里的 Base URL 是https://taotoken.net/api，不是官网首页。

对于 CC Switch，切换后建议重新打开终端，避免旧环境变量残留。可以用下面的命令确认：

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

如果同时看到ANTHROPIC_BASE_URL和TAOTOKEN_API_KEY，并不一定冲突，但要确认你当前启动的是 Claude Code 还是 Codex。Claude Code 读前者，Codex 读后者，串用会导致请求发错供应商。

5. 团队评审对照：docs、slides、design 三类工件的验收表

演示协作者的产出不是“聊完就算”，而是让团队能按同一套标准评审。下面这张对照表可以贴在项目 README 或评审文档里。它的作用是把“对话生成”变成“可检查的工件”，同时标出 Token 消耗点，方便后续优化。

评审流程可以固定为：

1. 演示协作者先提交artifacts/docs/spec.md，让产品和技术确认范围。
2. 范围确认后，再提交artifacts/deck/spec-deck.md，让评审人逐页批注。
3. 如果 deck 需要视觉配套，再提交artifacts/design/spec-design.md。
4. 评审意见以文件形式回写，例如artifacts/deck/spec-deck-review.md。
5. 需要二次生成时，只让 Claude Slides 重新生成 deck 工件，不要连带重生成 doc。

这样做的原因是：Token 主要消耗在生成请求上，尤其是 slides 工件的多轮重排。如果每次评审都让模型从头生成 doc、slides、design，消耗会快速上升。更经济的方式是保留 doc 作为稳定输入，只对 deck 做增量修改。

一个评审对照命令示例：

mkdir -p artifacts/review touch artifacts/review/spec-deck-review.md printf '%s\n' "# Deck 评审记录" "" "| 页码 | 问题 | 建议 | 负责人 | 状态 |" "| --- | --- | --- | --- | --- |" > artifacts/review/spec-deck-review.md sed -n '1,80p' artifacts/review/spec-deck-review.md

评审人只需要在本地运行查看命令，不需要让 Agent 连接任何生产库或外部系统。所有文件都保留在项目仓库或本地工作区，便于版本对比。

6. 排障清单：slides artifact 生成失败时先查这 8 项

如果 Claude Slides 工件没有生成，或者生成到一半报错，不要立刻重写提示词。按下面 8 项检查，通常能定位大部分问题。

1. Base URL 是否写成了https://taotoken.net/api。不要带 UTM 参数，不要带结尾/v1，除非控制台明确说明。
2. ANTHROPIC_API_KEY是否已经替换成真实 Key。YOUR_API_KEY只是占位符，直接使用会鉴权失败。
3. settings.json 是否被项目级配置覆盖。检查~/.claude/settings.json和项目.claude/settings.json的优先级。
4. 当前 shell 是否残留旧的ANTHROPIC_BASE_URL。用env | grep ANTHROPIC检查，必要时unset后重开终端。
5. 模型 ID 是否可用。ANTHROPIC_MODEL填错时，请求会返回模型不存在或权限错误。
6. 输出目录是否存在且可写。先执行mkdir -p artifacts/deck，再让 Claude 生成工件。
7. 本地网络策略是否拦截了taotoken.net。可以用本地命令测试连通性：

curl -sS -o /dev/null -w "%{http_code}\n" https://taotoken.net/api

8. Claude Code 是否需要重启。修改 settings.json 后，退出当前会话再重新进入，避免旧配置继续生效。

如果仍然失败，可以查看当前配置的脱敏输出。不要直接打印完整 Key，只确认前缀和后缀：

python3 - <<'PY' import os for name in ["ANTHROPIC_BASE_URL", "ANTHROPIC_API_KEY", "ANTHROPIC_MODEL"]: value = os.environ.get(name) if not value: print(f"{name}: <empty>") elif name.endswith("KEY"): print(f"{name}: {value[:3]}****{value[-4:]}") else: print(f"{name}: {value}") PY

如果ANTHROPIC_BASE_URL不是https://taotoken.net/api，请回到第 2 节修改 settings.json。TaoToken 官网入口再次放在这里，方便核对 Key 与文档：https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=slides-troubleshoot 。创建 Key 后，不要把它提交到 Git 仓库，也不要写进公开的 settings.json。团队协作时用环境变量或本地私有配置文件覆盖。

7. 文末 CTA：模型对话 → Coding Plan → 创建 Key → Claude Code 文档

如果你已经按上面的步骤把 Claude Code 的请求出口切到 TaoToken，并且成功生成了artifacts/docs/spec.md、artifacts/deck/spec-deck.md和artifacts/design/spec-design.md，接下来可以把这条流程固化到团队模板里。建议按下面顺序完成剩余动作：

1. 先通过模型对话验证 Key 与 Base URL 是否可用：https://taotoken.net/models/detail/chat?utm_source=taotoken_aicg_blog_end&utm_content=slides-chat
2. 如果团队需要长期在 Claude Code、Codex 等工具间切换，查看 Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=slides-plan
3. 在控制台创建并管理 API Keys：https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=slides-keys
4. 需要确认 Claude Code 的具体环境变量与配置方式，查阅 Claude Code 文档：https://taotoken.net/doc/ClaudeCodeAnthropic?utm_source=taotoken_aicg_blog_end&utm_content=slides-doc

回到演示协作者流程，最终目标不是“让模型随便生成一版 deck”，而是让团队能稳定复现：谁改了 doc，谁基于哪版 doc 生成了 deck，评审意见落在哪个文件，Token 主要消耗在哪几次生成请求上。把这套配置和目录约定写进项目模板后，从对话到 deck 就不再是一次性的演示，而是一条可交接、可评审、可追踪的协作流水线。