企业官网建设流程全解析

1. TaoToken Key 接入 Claude Code 后，Claude Slides 读取 RFC 的真实链路

把 TaoToken Key 放进 Claude Code 的settings.json后，Claude Slides 能不能读取仓库 RFC，并不只是幻灯片工具本身的问题，而是上下文读取链路是否完整的问题。先到 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=claude_slides_rfc_intro 获取 Key，再把 Claude Code 的 API Base URL 设置为https://taotoken.net/api。在这条链路里，Claude Code 负责读取当前工作目录、指定文件、RFC 章节和行号范围，Claude Slides 负责把已经进入上下文的材料组织成设计评审幻灯片，Claude Design 负责 UI 原型描述，Claude Docs 负责评审记录与文档草稿。如果只改了 Key，却没有让 Claude Code 在仓库根目录启动，也没有在提示词里显式要求读取docs/rfc下的文件，Claude Slides 大概率只能生成一份没有仓库依据的通用 PPT 大纲。

本文按“上下文读取视角”来拆：Key 设置片段怎么写，仓库 RFC 引用片段怎么准备，Claude Slides 调用命令怎么发，生成后如何验证引用不是幻觉，以及 Codex、CC Switch 的配置边界。目标不是讨论工具能不能用，而是给出一套可以本地复现的接入与排障步骤。下面所有命令都由读者在自己的机器和仓库中执行，不要连接生产数据库，也不要把密钥写进可提交的仓库文件。

2. Key 设置片段：Claude Code 的 settings.json 与 ANTHROPIC_* 环境变量

Claude Code 侧建议优先使用项目级或用户级settings.json。项目级文件可以放在仓库的.claude/settings.json，用户级文件可以放在~/.claude/settings.json。如果你不想把 Key 写进文件，也可以只保留ANTHROPIC_BASE_URL，然后用 shell 环境变量传入 Key。最小配置如下：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "YOUR_API_KEY" } }

如果你需要指定模型，可以把模型字段一并加入，模型 ID 以 TaoToken 控制台当前可用列表为准：

{ "env": { "ANTHROPIC_BASE_URL": "https://taotoken.net/api", "ANTHROPIC_API_KEY": "YOUR_API_KEY", "ANTHROPIC_MODEL": "按 TaoToken 控制台可用模型填写" } }

临时验证时，可以在当前 shell 里导出环境变量，再启动 Claude Code：

export ANTHROPIC_BASE_URL="https://taotoken.net/api" export ANTHROPIC_API_KEY="YOUR_API_KEY" claude --version

如果你使用 CC Switch 管理多个供应商，记住“三件套”原则：Base URL 填https://taotoken.net/api，API Key 填YOUR_API_KEY，模型 ID 从 TaoToken 官网的模型对话页或控制台复制。切换完成后重启 Claude Code，避免旧进程继续读取旧环境变量。CC Switch 只是配置切换工具，不改变 Claude Code 读取仓库文件的方式；Claude Slides 能否读到 RFC，仍然取决于启动目录和提示词里的文件引用。

这里再次提醒：Claude Code 使用ANTHROPIC_*和settings.json，Codex 使用config.toml，两者不要混用。不要把ANTHROPIC_API_KEY写进 Codex 的config.toml，也不要把 Codex 的model_provider写进 Claude Code 的settings.json。如果 Key 配置正确但工具调用仍然失败，先去 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=claude_slides_rfc_config 检查 Key 状态和可用模型，再回到本地排查 Claude Code 的启动路径。

3. 仓库 RFC 引用片段：让 Claude Code 先读文件，再交给 Claude Slides

Claude Slides 不是凭空数据库，它读到的是 Claude Code 已经放进上下文的文本。因此第一步不是打开 Claude Slides，而是在仓库里准备一份可被读取、可被引用、可被验证的 RFC 文件。建议目录结构如下：

repo/ docs/ rfc/ RFC-001-design-review.md RFC-002-ui-prototype.md src/ components/ DesignReview.tsx Button.tsx .claude/ settings.json

一个可复现的 RFC 片段可以写成这样，放在docs/rfc/RFC-001-design-review.md：

# RFC-001: 设计评审幻灯片生成流程 ## 2. 背景 当前设计评审材料分散在 PR 描述、Figma 评论和聊天记录中，评审人需要在多个入口之间跳转。需要把仓库内的设计约束、组件实现和未决问题汇总到一份可分享的幻灯片中。 ## 3. 目标 - 幻灯片必须引用仓库内 RFC 的章节号和文件路径。 - UI 原型必须引用组件实现和设计约束。 - 每页幻灯片至少保留一个可回查的来源字段。 ## 4. 非目标 - 不自动修改生产代码。 - 不连接生产数据库。 - 不替代人工评审结论。 ## 6. 验收标准 - 每页幻灯片至少有一个 sources 字段。 - 引用行号必须能在本地仓库复现。 - 如果引用文件不存在，必须明确标记为缺失，不得编造。

有了 RFC 后，在仓库根目录启动 Claude Code：

cd /path/to/repo git rev-parse --show-toplevel claude

进入 Claude Code 后，先用本地命令确认 Claude Code 能看到 RFC 文件。下面这些命令由你在本地终端执行，不是让 Claude 直接连生产环境：

pwd ls -la docs/rfc sed -n '1,160p' docs/rfc/RFC-001-design-review.md

然后给 Claude Code 一段显式读取指令。这里的关键是“先读文件，再生成大纲，确认后再调用 Claude Slides”。可以复制下面这段作为对话调用命令：

@docs/rfc/RFC-001-design-review.md @src/components/DesignReview.tsx 请先读取上述文件，输出 8 页设计评审幻灯片大纲。 要求： 1. 每页列出 RFC 章节号、文件路径、行号范围。 2. 第 3 页引用 RFC-001 第 3 节目标。 3. 第 5 页引用 DesignReview.tsx 的 props 定义。 4. 大纲确认后，使用 Claude Slides 生成幻灯片，并保留 sources 字段。 5. 如果某个行号无法确认，明确写“未验证”，不要编造。

这段不是 shell 命令，而是 Claude Code 对话里的调用指令。它的作用是把“读取上下文”和“生成幻灯片”拆成两个阶段：先让 Claude Code 读取并列出引用，再让 Claude Slides 基于已确认的上下文生成页面。这样做的原因是，设计评审幻灯片最怕的是看起来完整、实际上没有仓库依据。只要引用片段先经过人工确认，后续 Claude Design、Claude Slides、Claude Docs 的产出才有可追溯性。

4. 验证 Claude Slides 是否真的读了 RFC：引用、行号、章节三查

生成幻灯片之后，不要只看页面好不好看，要先检查三类证据：文件路径是否存在，行号范围是否对得上，章节标题是否准确。一个理想的 Claude Slides 输出片段应该长这样：

## Slide 3: 目标与验收 - 幻灯片必须保留 RFC 来源。 - 每页至少有一个 sources 字段。 - sources: - docs/rfc/RFC-001-design-review.md#L12-L18 - src/components/DesignReview.tsx#L7-L31

接下来在本地终端验证行号：

nl -ba docs/rfc/RFC-001-design-review.md | sed -n '12,18p' nl -ba src/components/DesignReview.tsx | sed -n '7,31p'

如果 Claude Slides 给出的引用行号与本地文件不一致，不要手动改幻灯片就结束。要把差异反馈给 Claude Code，让它重新读取并修正。可以使用下面的修正指令：

你刚才引用的 docs/rfc/RFC-001-design-review.md#L12-L18 与本地文件不一致。 请重新读取该文件，只保留能验证的行号，并重新生成第 3 页。 如果无法验证，删除该引用并说明原因。

除了行号，还要检查章节标题。例如 RFC 里写的是“3. 目标”，幻灯片里不能写成“3. 需求”或“3. 背景”。如果章节标题变了，说明模型在做语义概括，而不是引用原文。设计评审场景下，概括可以放在备注里，但 sources 字段必须保留原始章节和行号。Claude Docs 生成的评审记录也应该遵循同样规则：每个待决问题、决策记录和行动项，都要能回查到 RFC 或组件文件。

如果你发现 Claude Slides 只输出页面标题，没有 sources，可以直接追问：

请为每一页补充 sources 字段，格式为“文件路径#L起始行-L结束行”。 只引用你已经读取过的文件。没有读取过的文件不要写进 sources。

这一步也是排障的核心：Key 正常、Base URL 正常，不代表 Claude Slides 一定读了 RFC。只有引用、行号、章节三查都通过，才能确认上下文读取链路是通的。

5. 常见失败与排障：Key 正常但 Claude Slides 读不到仓库 RFC

第一种常见情况是启动目录不对。Claude Code 通常以当前工作目录作为上下文边界。如果你在~/projects启动，而不是在具体仓库根目录启动，docs/rfc可能根本不在上下文里。先在 Claude Code 里或本地终端执行：

pwd git rev-parse --show-toplevel

如果pwd不是仓库根目录，退出 Claude Code，cd到仓库根目录后重新启动。不要在错误目录里反复要求 Claude Slides“再读一次”，它看不到就是看不到。

第二种情况是settings.json没有生效。检查环境变量：

env | grep -E 'ANTHROPIC_(BASE_URL|API_KEY|MODEL)'

注意不要把完整 Key 输出到公开日志里。如果发现ANTHROPIC_BASE_URL仍然是旧地址，重启 Claude Code，或者在 CC Switch 中重新切换 TaoToken 配置。Base URL 应该精确写成：

https://taotoken.net/api

不要多加路径，也不要依赖旧 shell 里的覆盖值。若 Key 状态异常，到 TaoToken 官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_content=claude_slides_rfc_troubleshoot 重新确认 Key 和模型可用性。

第三种情况是文件被 Git 忽略或权限不足。Claude Code 能读本地文件，但如果文件被.gitignore排除，某些工作流可能不会把它当作仓库文件。可以检查：

git check-ignore -v docs/rfc/RFC-001-design-review.md ls -la docs/rfc

如果确实被忽略，把 RFC 移到未被忽略的目录，或者调整忽略规则。不要为了省事把 Key 写进 RFC 文件。

第四种情况是 RFC 太长，模型只读了开头。解决方式不是强行塞入全文，而是分块读取。先让 Claude Code 读取目录和标题：

请先列出 docs/rfc 下的文件，并提取每个 RFC 的一级、二级标题和行号。 不要生成幻灯片。

确认标题后，再指定章节读取：

请读取 docs/rfc/RFC-001-design-review.md 的第 1 到 80 行。 只总结背景和目标，不要总结非目标。

第五种情况是提示词没有显式要求 sources。Claude Slides 不会自动知道你需要行号引用。把“每页必须有 sources”“无法验证就标记未验证”“不要编造文件路径”写进提示词。第六种情况是 Claude Slides 工具未在当前 Claude Code 会话中启用。你可以在对话中直接问：

当前会话是否可以使用 Claude Slides、Claude Design 和 Claude Docs？ 如果可以使用，请列出调用方式；如果不可以，请说明缺少什么配置。

不要编造工具名，也不要把第三方插件名写进配置。能核实的是 Claude Code 的settings.json、ANTHROPIC_*环境变量、Base URLhttps://taotoken.net/api，以及仓库里的 RFC 文件路径和行号。先保证这些事实可验证，再谈生成效果。

6. Claude Design、Claude Docs 与 Slides 的上下文复用

Claude Slides 跑通后，Claude Design 和 Claude Docs 可以复用同一批 RFC 与仓库文件。Claude Design 适合生成 UI 原型说明或设计评审用界面草案。调用时仍然要显式挂载文件，例如：

@docs/rfc/RFC-002-ui-prototype.md @src/components/Button.tsx 使用 Claude Design 生成一个评审用 UI 原型说明。 必须引用 RFC-002 第 3 节的可访问性约束和 Button.tsx 的 variant 类型。 先列出引用来源，再给原型描述。 不要修改任何生产代码。

Claude Docs 适合把幻灯片、RFC 和讨论结论整理成评审文档。可以这样调用：

@docs/rfc/RFC-001-design-review.md @.claude/slides/rfc-001.md 使用 Claude Docs 生成设计评审会议纪要模板。 包含：RFC 来源、待决问题、决策记录、行动项、负责人占位。 每个待决问题都要保留 RFC 文件路径和行号。

这样做的价值是上下文一致：Claude Slides 引用的 RFC 章节，Claude Docs 里可以继续引用；Claude Design 生成的 UI 原型，也能回查到Button.tsx或DesignReview.tsx。如果 Claude Slides 生成后你还需要修改，可以在同一会话里继续对话：

第 5 页的组件引用不准确。 请重新读取 src/components/DesignReview.tsx，只保留 props 定义所在行号，然后更新第 5 页。 其他页面保持不变。

完成后，你可以自行编辑生成的幻灯片，继续在对话中修改，或分享链接给评审人。分享之前建议再做一次本地核对，确认所有 sources 都能在仓库中找到。设计评审材料不是一次性文本，它会进入评审流程，被其他人回查。引用可验证，比页面动画和模板样式更重要。

7. Codex 与 CC Switch 的配置边界：不要把 ANTHROPIC_* 套进 config.toml

有些读者会同时使用 Claude Code 和 Codex。这里必须把配置边界说清楚：Claude Code 使用settings.json和ANTHROPIC_*环境变量；Codex 使用config.toml。不要把ANTHROPIC_BASE_URL、ANTHROPIC_API_KEY写进 Codex 的config.toml，也不要把 Codex 的model_provider写进 Claude Code 的settings.json。Codex 的配置示例可以写成：

model = "按 TaoToken 控制台可用模型填写" model_provider = "taotoken" [model_providers.taotoken] name = "TaoToken" base_url = "https://taotoken.net/api" env_key = "TAOTOKEN_API_KEY"

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

export TAOTOKEN_API_KEY="YOUR_API_KEY"

如果你用 CC Switch，建议把 Claude Code 和 Codex 的配置分开管理。CC Switch 三件套仍然是：Base URL、API Key、模型 ID。Claude Code 侧填https://taotoken.net/api和YOUR_API_KEY，Codex 侧使用自己的config.toml和TAOTOKEN_API_KEY。切换后重启对应工具，避免进程缓存旧配置。这样做的目的不是增加步骤，而是避免“Claude Code 能读 RFC，但 Codex 配置报错”这类混用问题。

如果你在 Claude Code 中同时使用多个供应商，还要注意模型名称不要跨供应商复制。模型 ID 从 TaoToken 控制台或模型对话页选择，不要凭记忆填写。Key 占位符统一使用YOUR_API_KEY，不要把真实 Key 写进博客、截图、提交记录或 RFC 文件。需要创建或检查 Key 时，走 TaoToken 的控制台入口，不要在本机脚本里硬编码。

8. 端到端可复现清单与 CTA

把前面的步骤压缩成一条可复现路径：

1. 到 TaoToken 官网获取 Key，并确认模型可用。
2. 在 Claude Code 的settings.json中配置ANTHROPIC_BASE_URL=https://taotoken.net/api和ANTHROPIC_API_KEY=YOUR_API_KEY。
3. 在仓库根目录启动 Claude Code，确认pwd和git rev-parse --show-toplevel正确。
4. 准备docs/rfc/RFC-001-design-review.md，写入可被引用的章节和行号。
5. 在 Claude Code 中先让模型读取 RFC 和组件文件，输出带 sources 的大纲。
6. 确认大纲后，使用 Claude Slides 生成设计评审幻灯片。
7. 用nl -ba本地核对行号，用git check-ignore检查文件是否被忽略。
8. 需要 UI 原型时调用 Claude Design，需要评审记录时调用 Claude Docs，继续复用同一批 RFC 引用。
9. 分享前检查每页 sources，无法验证的引用改成“未验证”或删除。
10. 如果 Key 或 Base URL 异常，回到 TaoToken 官网检查，而不是反复重试 Claude Slides。

这条路径里，Claude Slides 能不能读仓库 RFC，答案不是简单的“能”或“不能”，而是“取决于 Claude Code 是否把 RFC 放进了上下文，并且提示词是否要求保留可验证引用”。Key 和 Base URL 只是入口，真正决定产出质量的是上下文读取、行号引用和本地核验。

如果你还没有 Key，可以先从模型对话页确认模型能力，再选择适合的 Coding Plan，然后创建 API Key，最后按 Claude Code 文档完成配置。推荐按下面顺序操作：

• 模型对话：https://taotoken.net/models/detail/chat?utm_source=taotoken_aicg_blog_end&utm_content=claude_slides_rfc_chat
• Coding Plan：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=claude_slides_rfc_plan
• 创建 Key：https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=claude_slides_rfc_key
• Claude Code 文档：https://taotoken.net/doc/ClaudeCodeAnthropic?utm_source=taotoken_aicg_blog_end&utm_content=claude_slides_rfc_doc

配置完成后，用一个小仓库先验证“读取 RFC、生成大纲、保留行号”这三步。等 Claude Slides 能稳定引用docs/rfc和组件文件后，再扩展到 Claude Design 和 Claude Docs。这样即使后续换成更大的仓库，你也能快速判断问题出在 Key、Base URL、启动目录、文件权限，还是提示词没有要求 sources。