1. 从 spec 对话到 deck 工件先把 Claude Code 的请求出口切到 TaoToken如果你正在 Claude Code 里把一段 spec 讨论转成可分享的 slides 工件却遇到 artifacts 生成请求没有按预期落到目标端点或者团队同事拿到的 deck 与本地看到的不一致那先别急着改提示词。演示协作者流程里真正容易出问题的环节通常是请求出口Claude Code 本身并不知道你要把 Claude Slides 的生成请求发到哪里它只认 settings.json 里的 ANTHROPIC_BASE_URL 和 Key。建议先去 TaoToken 官网拿一个可用的 Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentslides-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并且需要在本地保留可复现的配置、生成命令和评审对照。整条链路可以拆成四步在 TaoToken 官网获取 Key并把 Base URL 记为https://taotoken.net/api在 Claude Code 的 settings.json 中写入 ANTHROPIC_* 配置用对话让 Claude 先生成 doc 工件再生成 slides 工件用评审对照表检查 docs、slides、design 三类产出定位 Token 消耗点。只要第 2 步的请求地址填错第 3 步的 artifacts 就可能根本不生成或者生成到旧供应商那边。所以下面先处理配置再处理提示词和评审流程。2. Claude Code settings.json 接入 TaoTokenANTHROPIC_* 字段的可复制配置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_sourcetaotoken_aicg_blog_endutm_contentslides-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_sourcetaotoken_aicg_blog_endutm_contentslides-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_KEYYOUR_API_KEY注意Codex 这边不要出现ANTHROPIC_API_KEY或ANTHROPIC_BASE_URL。如果你在同一个 shell 里同时使用 Claude Code 和 Codex建议用 CC Switch 这类切换工具管理配置。所谓的“CC Switch 三件套”可以按下面三项核对Base URL统一填https://taotoken.net/api不要带 UTM 参数。UTM 只用于官网链接不用于工具请求地址。API Key填YOUR_API_KEY对应的真实 Key创建入口在 TaoToken 控制台。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 消耗点方便后续优化。工件类型生成入口评审人通过标准Token 消耗点Claude Docs对话起草单页文档产品负责人、技术负责人背景、范围、非目标、风险、待确认问题齐全生成 doc 工件的请求Claude Slides从 doc 转成 deck演示协作者、评审主持人页序合理每页要点不超过 5 条术语与 doc 一致生成 slides 工件的请求Claude Design为 deck 补充视觉说明设计、品牌、前端色板、字体、留白、图示风格可落地生成 design 说明的请求评审流程可以固定为演示协作者先提交artifacts/docs/spec.md让产品和技术确认范围。范围确认后再提交artifacts/deck/spec-deck.md让评审人逐页批注。如果 deck 需要视觉配套再提交artifacts/design/spec-design.md。评审意见以文件形式回写例如artifacts/deck/spec-deck-review.md。需要二次生成时只让 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 项检查通常能定位大部分问题。Base URL 是否写成了https://taotoken.net/api。不要带 UTM 参数不要带结尾/v1除非控制台明确说明。ANTHROPIC_API_KEY是否已经替换成真实 Key。YOUR_API_KEY只是占位符直接使用会鉴权失败。settings.json 是否被项目级配置覆盖。检查~/.claude/settings.json和项目.claude/settings.json的优先级。当前 shell 是否残留旧的ANTHROPIC_BASE_URL。用env | grep ANTHROPIC检查必要时unset后重开终端。模型 ID 是否可用。ANTHROPIC_MODEL填错时请求会返回模型不存在或权限错误。输出目录是否存在且可写。先执行mkdir -p artifacts/deck再让 Claude 生成工件。本地网络策略是否拦截了taotoken.net。可以用本地命令测试连通性curl -sS -o /dev/null -w %{http_code}\n https://taotoken.net/apiClaude 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_sourcetaotoken_aicg_blog_endutm_contentslides-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接下来可以把这条流程固化到团队模板里。建议按下面顺序完成剩余动作先通过模型对话验证 Key 与 Base URL 是否可用https://taotoken.net/models/detail/chat?utm_sourcetaotoken_aicg_blog_endutm_contentslides-chat如果团队需要长期在 Claude Code、Codex 等工具间切换查看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentslides-plan在控制台创建并管理 API Keyshttps://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentslides-keys需要确认 Claude Code 的具体环境变量与配置方式查阅 Claude Code 文档https://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentslides-doc回到演示协作者流程最终目标不是“让模型随便生成一版 deck”而是让团队能稳定复现谁改了 doc谁基于哪版 doc 生成了 deck评审意见落在哪个文件Token 主要消耗在哪几次生成请求上。把这套配置和目录约定写进项目模板后从对话到 deck 就不再是一次性的演示而是一条可交接、可评审、可追踪的协作流水线。