1. 在 Claude Code 里让 Claude Docs 写 RFC 前先把 TaoToken Key 的环境变量边界钉住我在 Claude Code 会话里让 Claude Docs 基于仓库 RFC 生成草稿、让 Claude Slides 出设计评审页、让 Claude Design 补 UI 原型说明时第一件事不是写长 prompt而是确认 TaoToken Key 从哪里来、会不会被 shell、Git、CI 或日志顺手带出去。可以直接到 TaoToken 官网取 Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_rfc_intro 然后把 Claude Code 的 API Base URL 设为 https://taotoken.net/api 。这一步看起来只是配置实际决定了后面 Claude Design、Claude Slides、Claude Docs 在 Claude Code 内调用时密钥是只存在当前用户环境里还是被写进项目文件、命令历史、终端截图和团队仓库。本文从密钥安全视角出发给出环境变量设置片段、Key 掩码对照表、Claude Docs 调用命令并顺带说明 Codex 的 config.toml 和 CC Switch 三件套该怎么区分避免把ANTHROPIC_*混到 Codex 里。先把结论说清楚把 TaoToken Key 放环境变量通常比硬编码进代码或提交到仓库安全但它不是“绝对安全”。环境变量会被当前用户启动的子进程继承可能出现在进程诊断信息、崩溃转储、日志采集、CI 报错和共享终端会话里。如果你的机器有同用户权限的恶意进程或者你习惯把export写进~/.zshrc、~/.bashrc风险会从“临时内存”变成“长期明文”。所以正确目标不是“找一个绝不出事的壳”而是分层密码只给最小权限、只在需要时注入、只让必要进程可见、日志全部掩码、出现异常可快速轮换。2. TaoToken Key 放环境变量安全吗先分清临时环境、settings.json 和 shell profile在 Claude Code 里使用 TaoToken一般要让 Claude Code 知道两个核心变量ANTHROPIC_BASE_URL指向https://taotoken.net/apiANTHROPIC_AUTH_TOKEN或ANTHROPIC_API_KEY放你的 TaoToken Key。不同版本或不同封装可能读取其中某一个所以建议先只设置一个确认联通后再决定是否兼容另一个。不要把真实 Key 写进项目级.claude/settings.json因为项目级文件很容易被 Git 追踪。用户级~/.claude/settings.json权限更可控但仍要注意同机其他进程和同步盘备份。临时会话注入是最低残留的方式适合第一次验证 Claude Code 调 TaoToken。打开新终端执行# 只在当前终端会话生效关闭窗口后失效 export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY # 某些 Claude Code 版本或周边工具会读取 API_KEY 变量 # 如果确认你的版本只认 AUTH_TOKEN可以不加下面这行 export ANTHROPIC_API_KEY$ANTHROPIC_AUTH_TOKEN # 验证时不要把完整 Key 打印出来 env | grep -E ^ANTHROPIC_(BASE_URL|AUTH_TOKEN|API_KEY) \ | sed -E s/^(ANTHROPIC_(AUTH_TOKEN|API_KEY)).*/\1***masked***/如果你要把配置落到用户级settings.json建议先建目录并收紧权限mkdir -p ~/.claude chmod 700 ~/.claude然后编辑~/.claude/settings.json只在这个用户级文件里放环境变量。示例{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY } }保存后执行chmod 600 ~/.claude/settings.json但这里有一个取舍用户级settings.json虽然比项目级好但它仍然是明文文件。更好的长期做法是settings.json只放非敏感配置Key 由系统钥匙串、密码管理器或每次启动终端时从安全来源注入。如果你必须在settings.json里放 Key至少不要把它放到项目目录不要提交不要同步到公共云盘不要截图分享。Key 掩码对照可以按下面这张表执行场景推荐存法是否明文可提交到 Git说明本地临时验证export当前 shell进程环境内可见否关闭终端后失效残留最低个人长期使用用户级~/.claude/settings.json权限 600文件明文否不要放项目级目录团队项目项目级只放 Base URL成员本地注入 Key否否避免 CI 和仓库泄露CI/CD平台 Secret 变量平台托管否命令中加set x禁止 echoCodexconfig.toml写env_keyKey 走环境变量Key 不明文进配置config.toml可提交不要写ANTHROPIC_*CC Switch面板保存供应商三件套取决于工具否Base URL、Key、模型分开管理演示/录屏只显示YOUR_API_KEY或掩码否否先unset或替换为假值安全边界还要看几个容易被忽略的地方。第一命令历史。不要把真实 Key 直接写进export ANTHROPIC_AUTH_TOKENsk-...然后回车因为很多 shell 会把它记进历史。可以用read -s或密码管理器注入。第二终端复用。tmux、screen、IDE 内置终端、远程开发容器会继承环境变量退出时不一定清理。第三日志采集。Claude Code、IDE 插件、CI runner 在报错时可能打印环境变量必须配合掩码。第四轮换成本。如果所有工具共用一个 Key泄露后要改很多地方建议按机器、按项目、按用途拆 Key。3. 在 Claude Code 中配置 TaoTokensettings.json、ANTHROPIC_* 与会话级注入配置 Claude Code 时先确认你拿到的 Key 来自 TaoToken 官网。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_rfc_key 创建或选择一个专用 Key不要把所有权限和所有项目塞进同一个 Key。然后在本地终端设置 Base URLhttps://taotoken.net/api。注意Base URL 不需要加 UTM 参数工具配置里只填纯 API 地址避免路径被额外查询参数干扰。如果你使用 shell 会话可以用下面的启动脚本模板。建议把真实 Key 放在密码管理器里而不是直接写在脚本文件里#!/usr/bin/env bash set -euo pipefail # 从密码管理器或安全输入中获取不要硬编码到脚本 if [ -z ${TAOTOKEN_API_KEY_FROM_SECRET:-} ]; then printf 请输入 TaoToken Key: read -r -s KEY echo export TAOTOKEN_API_KEY_FROM_SECRET$KEY unset KEY fi export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKEN$TAOTOKEN_API_KEY_FROM_SECRET # 可选兼容部分工具链 export ANTHROPIC_API_KEY$ANTHROPIC_AUTH_TOKEN # 打印掩码确认变量已设置 printf ANTHROPIC_BASE_URL%s\n $ANTHROPIC_BASE_URL printf ANTHROPIC_AUTH_TOKEN%s...%s\n \ ${ANTHROPIC_AUTH_TOKEN:0:6} \ ${ANTHROPIC_AUTH_TOKEN: -4}如果你已经在~/.claude/settings.json中配置了env可以用以下方式检查文件权限和 Git 状态ls -l ~/.claude/settings.json chmod 600 ~/.claude/settings.json # 如果你在项目目录里也有 .claude/settings.json检查它是否被 Git 追踪 git ls-files .claude/settings.json .claude/settings.local.json 2/dev/null || true git check-ignore -v .claude/settings.local.json 2/dev/null || true项目级.claude/settings.json更适合放团队共享的非敏感项例如默认模型、允许的工具、Base URL 的说明。不要把ANTHROPIC_AUTH_TOKEN写进项目级文件。如果团队需要统一 Base URL可以只写{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api } }成员各自在本地注入ANTHROPIC_AUTH_TOKEN。这样即使项目仓库被公开也不会直接泄露 Key。配置完成后进入一个真实仓库测试 Claude Code 是否能启动。不要用生产数据库连接串、生产云账号或生产 Token 做验证先用只读仓库和文档目录。4. 用 Claude Docs 写 RFC、Claude Slides 做评审、Claude Design 出原型可复现调用链当 Claude Code 已经指向 TaoToken 后就可以在仓库里调用 Claude Design、Claude Slides、Claude Docs 相关能力。建议先进入代码仓库根目录cd ~/workspace/your-service claude在 Claude Code 会话中不要一上来就让它改文件先让它读取 RFC、设计文档和仓库结构生成草稿。下面是 Claude Docs 调用命令模板可以直接作为会话输入请只读取以下内容不要修改文件 - docs/rfc/2025-auth-refactor.md - docs/design/review-notes.md - src/auth/ 目录下的接口与类型定义 基于这些材料用 Claude Docs 生成一份 RFC 草稿包含 1. 背景、目标、非目标 2. 现状与问题 3. 接口/数据模型变更 4. 迁移步骤与回滚方案 5. 风险、依赖和未决问题 6. 需要设计评审确认的问题清单 要求每个关键结论都标注引用的仓库文件路径和 RFC 小节编号。 输出 Markdown先给草稿不要改仓库文件。生成草稿后可以让 Claude Slides 把 RFC 转成设计评审幻灯片。提示词可以这样写基于刚生成的 RFC 草稿用 Claude Slides 生成 8 页设计评审幻灯片 1. 背景与目标 2. 当前问题与影响面 3. 方案对比 4. 架构与流程变化 5. API/数据模型变更 6. 迁移与回滚计划 7. 风险与未决问题 8. 评审决策项 每页控制在 5 个要点以内引用对应 RFC 章节。 生成后保留可继续编辑和分享的链接。如果还需要 UI 原型说明可以继续用 Claude Design 补页面结构和状态用 Claude Design 根据 docs/rfc/2025-auth-refactor.md 中的登录与授权流程 生成 UI 原型说明包括 - 页面列表 - 核心组件 - 正常态、空态、错误态、加载态 - 与 RFC 章节的对应关系 不要编造后端接口只引用仓库中已有的类型和文件路径。实际使用中建议把“读取仓库”和“写入仓库”分开。第一阶段只让 Claude Docs、Claude Slides、Claude Design 生成草稿、链接和评审材料第二阶段你再人工确认哪些文件需要修改。涉及 SQL、数据库变更、部署命令时让工具输出建议文本由你在本地终端逐条执行。不要配置文档生成流程直连生产库也不要让任何自动流程拿到生产写权限。5. Codex config.toml 与 CC Switch 三件套不要把 ANTHROPIC_* 混进 Codex很多同学同时用 Claude Code 和 Codex配置时最容易犯的错误是把 Claude Code 的ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN直接复制到 Codex 的config.toml。两者变量体系不同。Claude Code 侧使用ANTHROPIC_*Codex 侧应在config.toml中声明 provider并通过独立的env_key读取环境变量。Codex 的 Base URL 同样是https://taotoken.net/api但不要把这个地址写成ANTHROPIC_BASE_URL。一个 Codex 配置示例可以这样组织。模型名按你在 TaoToken 控制台或 Coding Plan 中实际可用的模型填写model YOUR_MODEL model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY然后在 shell 中为 Codex 单独设置环境变量export TAOTOKEN_API_KEYYOUR_API_KEY注意config.toml里只写env_key TAOTOKEN_API_KEY不要写真实 Key。这样config.toml可以进版本库真实 Key 留在环境变量或系统钥匙串中。Claude Code 和 Codex 可以同时使用但建议分别使用不同 Key至少不要把一个 Key 同时塞进ANTHROPIC_AUTH_TOKEN和TAOTOKEN_API_KEY后到处复制。如果你用 CC Switch 管理多套配置按“三件套”填Base URL、API Key、模型。Base URL 填https://taotoken.net/apiAPI Key 填YOUR_API_KEY或从面板的安全输入中读取模型按 TaoToken 控制台可用列表选择。供应商信息可以从 TaoToken 官网核对https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_rfc_ccswitch 。切换后重启终端或 Claude Code/Codex 会话避免旧环境变量残留。检查时用掩码命令不要直接env | grep KEY后把完整值贴到聊天窗口。CC Switch 的便利性带来一个安全提醒面板保存 Key 的存储方式取决于工具实现。如果它把 Key 写在本地明文配置里你要像保护~/.claude/settings.json一样保护它。共享电脑、录屏、远程协助前先切到假 Key 或清空面板。团队协作时只共享 Base URL 和模型名不共享个人 Key。6. 泄露面排查与轮换history、Git、CI、日志、共享终端配置完成后建议做一次密钥泄露面排查。以下命令只在本机执行输出到终端前先确认没有完整 Key# 1. 检查 shell 历史中是否出现疑似 Key history | grep -Ei ANTHROPIC_(AUTH_TOKEN|API_KEY)|TAOTOKEN_API_KEY|YOUR_API_KEY || true # 2. 检查 Git 追踪文件是否包含敏感变量名或真实 Key git grep -n -E ANTHROPIC_(AUTH_TOKEN|API_KEY)|TAOTOKEN_API_KEY || true # 3. 检查本地 Claude/Codex 配置是否被 Git 追踪 git ls-files | grep -E (^|/)\.claude/|(^|/)config\.toml$ || true # 4. 检查环境变量时只输出掩码 env | grep -E ^(ANTHROPIC_(AUTH_TOKEN|API_KEY)|TAOTOKEN_API_KEY) \ | sed -E s/^(.*).*/\1***masked***/如果发现 Key 已经进入 Git 历史只在最新提交里删除并不够因为历史提交仍可能被拉取。此时应立即到 TaoToken API Keys 页面创建新 Key撤销旧 Key再清理本地和远端历史。创建和轮换入口建议走https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_rfc_rotate 。如果 Key 出现在 CI 日志除了轮换还要把 CI 命令改成set x并使用平台 Secret 注入set x export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKEN$TAOTOKEN_API_KEY # 不要在 CI 中 echo 变量日常建议一个项目一个 Key一个用途一个 Key泄露后影响面小。定期轮换尤其是团队成员变化、电脑送修、录屏发布后。不把 Key 写进 issue、聊天记录、截图、录屏、临时文本文件。不在公共终端、共享跳板机、公共 IDE 远程环境中保留长期 Key。出现异常调用量、异常模型消耗时先停用相关 Key再排查日志。重要仓库开启提交前检查至少用正则拦截ANTHROPIC_AUTH_TOKEN、TAOTOKEN_API_KEY、sk-等模式。这些措施不能让环境变量变成绝对保险箱但能把风险从“一直明文暴露”压到“可控、可发现、可轮换”。对于 Claude Code 内调 Claude Docs、Claude Slides、Claude Design 这类研发文档工作流密钥安全的核心不是把 Key 藏得多深而是让 Key 有边界、有掩码、有轮换、有最小权限。7. 文末 CTA按“模型对话 → Coding Plan → 创建 Key → Claude Code 文档”走一遍如果你准备把 Claude Code 内的 Claude Docs、Claude Slides、Claude Design 工作流跑起来可以按下面顺序完成接入先到模型对话页确认模型和调用方式https://taotoken.net/models/detail/chat?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_rfc_chat如果准备长期在 Claude Code、Codex、CC Switch 里使用查看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_rfc_plan创建或轮换专用 API Key不要把真实 Key 贴进项目文件https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_rfc_key按 Claude Code 文档把 Base URL 配为https://taotoken.net/api并用YOUR_API_KEY占位符先跑通环境变量https://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_rfc_docs配置时记住三条Claude Code 用ANTHROPIC_*Codex 用config.toml加独立env_keyCC Switch 用 Base URL、API Key、模型三件套分开管理。先临时环境变量验证再落用户级配置先掩码、再截屏先轮换、再排查。这样让 Claude Docs 写 RFC、让 Claude Slides 出设计评审页、让 Claude Design 补 UI 原型时密钥不会成为工作流里最薄弱的一环。 20 Claude Code 调 Claude Docs 写 RFC：TaoToken Key 放环境变量安全吗
1. 在 Claude Code 里让 Claude Docs 写 RFC 前先把 TaoToken Key 的环境变量边界钉住我在 Claude Code 会话里让 Claude Docs 基于仓库 RFC 生成草稿、让 Claude Slides 出设计评审页、让 Claude Design 补 UI 原型说明时第一件事不是写长 prompt而是确认 TaoToken Key 从哪里来、会不会被 shell、Git、CI 或日志顺手带出去。可以直接到 TaoToken 官网取 Keyhttps://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_rfc_intro 然后把 Claude Code 的 API Base URL 设为 https://taotoken.net/api 。这一步看起来只是配置实际决定了后面 Claude Design、Claude Slides、Claude Docs 在 Claude Code 内调用时密钥是只存在当前用户环境里还是被写进项目文件、命令历史、终端截图和团队仓库。本文从密钥安全视角出发给出环境变量设置片段、Key 掩码对照表、Claude Docs 调用命令并顺带说明 Codex 的 config.toml 和 CC Switch 三件套该怎么区分避免把ANTHROPIC_*混到 Codex 里。先把结论说清楚把 TaoToken Key 放环境变量通常比硬编码进代码或提交到仓库安全但它不是“绝对安全”。环境变量会被当前用户启动的子进程继承可能出现在进程诊断信息、崩溃转储、日志采集、CI 报错和共享终端会话里。如果你的机器有同用户权限的恶意进程或者你习惯把export写进~/.zshrc、~/.bashrc风险会从“临时内存”变成“长期明文”。所以正确目标不是“找一个绝不出事的壳”而是分层密码只给最小权限、只在需要时注入、只让必要进程可见、日志全部掩码、出现异常可快速轮换。2. TaoToken Key 放环境变量安全吗先分清临时环境、settings.json 和 shell profile在 Claude Code 里使用 TaoToken一般要让 Claude Code 知道两个核心变量ANTHROPIC_BASE_URL指向https://taotoken.net/apiANTHROPIC_AUTH_TOKEN或ANTHROPIC_API_KEY放你的 TaoToken Key。不同版本或不同封装可能读取其中某一个所以建议先只设置一个确认联通后再决定是否兼容另一个。不要把真实 Key 写进项目级.claude/settings.json因为项目级文件很容易被 Git 追踪。用户级~/.claude/settings.json权限更可控但仍要注意同机其他进程和同步盘备份。临时会话注入是最低残留的方式适合第一次验证 Claude Code 调 TaoToken。打开新终端执行# 只在当前终端会话生效关闭窗口后失效 export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKENYOUR_API_KEY # 某些 Claude Code 版本或周边工具会读取 API_KEY 变量 # 如果确认你的版本只认 AUTH_TOKEN可以不加下面这行 export ANTHROPIC_API_KEY$ANTHROPIC_AUTH_TOKEN # 验证时不要把完整 Key 打印出来 env | grep -E ^ANTHROPIC_(BASE_URL|AUTH_TOKEN|API_KEY) \ | sed -E s/^(ANTHROPIC_(AUTH_TOKEN|API_KEY)).*/\1***masked***/如果你要把配置落到用户级settings.json建议先建目录并收紧权限mkdir -p ~/.claude chmod 700 ~/.claude然后编辑~/.claude/settings.json只在这个用户级文件里放环境变量。示例{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY } }保存后执行chmod 600 ~/.claude/settings.json但这里有一个取舍用户级settings.json虽然比项目级好但它仍然是明文文件。更好的长期做法是settings.json只放非敏感配置Key 由系统钥匙串、密码管理器或每次启动终端时从安全来源注入。如果你必须在settings.json里放 Key至少不要把它放到项目目录不要提交不要同步到公共云盘不要截图分享。Key 掩码对照可以按下面这张表执行场景推荐存法是否明文可提交到 Git说明本地临时验证export当前 shell进程环境内可见否关闭终端后失效残留最低个人长期使用用户级~/.claude/settings.json权限 600文件明文否不要放项目级目录团队项目项目级只放 Base URL成员本地注入 Key否否避免 CI 和仓库泄露CI/CD平台 Secret 变量平台托管否命令中加set x禁止 echoCodexconfig.toml写env_keyKey 走环境变量Key 不明文进配置config.toml可提交不要写ANTHROPIC_*CC Switch面板保存供应商三件套取决于工具否Base URL、Key、模型分开管理演示/录屏只显示YOUR_API_KEY或掩码否否先unset或替换为假值安全边界还要看几个容易被忽略的地方。第一命令历史。不要把真实 Key 直接写进export ANTHROPIC_AUTH_TOKENsk-...然后回车因为很多 shell 会把它记进历史。可以用read -s或密码管理器注入。第二终端复用。tmux、screen、IDE 内置终端、远程开发容器会继承环境变量退出时不一定清理。第三日志采集。Claude Code、IDE 插件、CI runner 在报错时可能打印环境变量必须配合掩码。第四轮换成本。如果所有工具共用一个 Key泄露后要改很多地方建议按机器、按项目、按用途拆 Key。3. 在 Claude Code 中配置 TaoTokensettings.json、ANTHROPIC_* 与会话级注入配置 Claude Code 时先确认你拿到的 Key 来自 TaoToken 官网。打开 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_rfc_key 创建或选择一个专用 Key不要把所有权限和所有项目塞进同一个 Key。然后在本地终端设置 Base URLhttps://taotoken.net/api。注意Base URL 不需要加 UTM 参数工具配置里只填纯 API 地址避免路径被额外查询参数干扰。如果你使用 shell 会话可以用下面的启动脚本模板。建议把真实 Key 放在密码管理器里而不是直接写在脚本文件里#!/usr/bin/env bash set -euo pipefail # 从密码管理器或安全输入中获取不要硬编码到脚本 if [ -z ${TAOTOKEN_API_KEY_FROM_SECRET:-} ]; then printf 请输入 TaoToken Key: read -r -s KEY echo export TAOTOKEN_API_KEY_FROM_SECRET$KEY unset KEY fi export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKEN$TAOTOKEN_API_KEY_FROM_SECRET # 可选兼容部分工具链 export ANTHROPIC_API_KEY$ANTHROPIC_AUTH_TOKEN # 打印掩码确认变量已设置 printf ANTHROPIC_BASE_URL%s\n $ANTHROPIC_BASE_URL printf ANTHROPIC_AUTH_TOKEN%s...%s\n \ ${ANTHROPIC_AUTH_TOKEN:0:6} \ ${ANTHROPIC_AUTH_TOKEN: -4}如果你已经在~/.claude/settings.json中配置了env可以用以下方式检查文件权限和 Git 状态ls -l ~/.claude/settings.json chmod 600 ~/.claude/settings.json # 如果你在项目目录里也有 .claude/settings.json检查它是否被 Git 追踪 git ls-files .claude/settings.json .claude/settings.local.json 2/dev/null || true git check-ignore -v .claude/settings.local.json 2/dev/null || true项目级.claude/settings.json更适合放团队共享的非敏感项例如默认模型、允许的工具、Base URL 的说明。不要把ANTHROPIC_AUTH_TOKEN写进项目级文件。如果团队需要统一 Base URL可以只写{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api } }成员各自在本地注入ANTHROPIC_AUTH_TOKEN。这样即使项目仓库被公开也不会直接泄露 Key。配置完成后进入一个真实仓库测试 Claude Code 是否能启动。不要用生产数据库连接串、生产云账号或生产 Token 做验证先用只读仓库和文档目录。4. 用 Claude Docs 写 RFC、Claude Slides 做评审、Claude Design 出原型可复现调用链当 Claude Code 已经指向 TaoToken 后就可以在仓库里调用 Claude Design、Claude Slides、Claude Docs 相关能力。建议先进入代码仓库根目录cd ~/workspace/your-service claude在 Claude Code 会话中不要一上来就让它改文件先让它读取 RFC、设计文档和仓库结构生成草稿。下面是 Claude Docs 调用命令模板可以直接作为会话输入请只读取以下内容不要修改文件 - docs/rfc/2025-auth-refactor.md - docs/design/review-notes.md - src/auth/ 目录下的接口与类型定义 基于这些材料用 Claude Docs 生成一份 RFC 草稿包含 1. 背景、目标、非目标 2. 现状与问题 3. 接口/数据模型变更 4. 迁移步骤与回滚方案 5. 风险、依赖和未决问题 6. 需要设计评审确认的问题清单 要求每个关键结论都标注引用的仓库文件路径和 RFC 小节编号。 输出 Markdown先给草稿不要改仓库文件。生成草稿后可以让 Claude Slides 把 RFC 转成设计评审幻灯片。提示词可以这样写基于刚生成的 RFC 草稿用 Claude Slides 生成 8 页设计评审幻灯片 1. 背景与目标 2. 当前问题与影响面 3. 方案对比 4. 架构与流程变化 5. API/数据模型变更 6. 迁移与回滚计划 7. 风险与未决问题 8. 评审决策项 每页控制在 5 个要点以内引用对应 RFC 章节。 生成后保留可继续编辑和分享的链接。如果还需要 UI 原型说明可以继续用 Claude Design 补页面结构和状态用 Claude Design 根据 docs/rfc/2025-auth-refactor.md 中的登录与授权流程 生成 UI 原型说明包括 - 页面列表 - 核心组件 - 正常态、空态、错误态、加载态 - 与 RFC 章节的对应关系 不要编造后端接口只引用仓库中已有的类型和文件路径。实际使用中建议把“读取仓库”和“写入仓库”分开。第一阶段只让 Claude Docs、Claude Slides、Claude Design 生成草稿、链接和评审材料第二阶段你再人工确认哪些文件需要修改。涉及 SQL、数据库变更、部署命令时让工具输出建议文本由你在本地终端逐条执行。不要配置文档生成流程直连生产库也不要让任何自动流程拿到生产写权限。5. Codex config.toml 与 CC Switch 三件套不要把 ANTHROPIC_* 混进 Codex很多同学同时用 Claude Code 和 Codex配置时最容易犯的错误是把 Claude Code 的ANTHROPIC_BASE_URL、ANTHROPIC_AUTH_TOKEN直接复制到 Codex 的config.toml。两者变量体系不同。Claude Code 侧使用ANTHROPIC_*Codex 侧应在config.toml中声明 provider并通过独立的env_key读取环境变量。Codex 的 Base URL 同样是https://taotoken.net/api但不要把这个地址写成ANTHROPIC_BASE_URL。一个 Codex 配置示例可以这样组织。模型名按你在 TaoToken 控制台或 Coding Plan 中实际可用的模型填写model YOUR_MODEL model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY然后在 shell 中为 Codex 单独设置环境变量export TAOTOKEN_API_KEYYOUR_API_KEY注意config.toml里只写env_key TAOTOKEN_API_KEY不要写真实 Key。这样config.toml可以进版本库真实 Key 留在环境变量或系统钥匙串中。Claude Code 和 Codex 可以同时使用但建议分别使用不同 Key至少不要把一个 Key 同时塞进ANTHROPIC_AUTH_TOKEN和TAOTOKEN_API_KEY后到处复制。如果你用 CC Switch 管理多套配置按“三件套”填Base URL、API Key、模型。Base URL 填https://taotoken.net/apiAPI Key 填YOUR_API_KEY或从面板的安全输入中读取模型按 TaoToken 控制台可用列表选择。供应商信息可以从 TaoToken 官网核对https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_rfc_ccswitch 。切换后重启终端或 Claude Code/Codex 会话避免旧环境变量残留。检查时用掩码命令不要直接env | grep KEY后把完整值贴到聊天窗口。CC Switch 的便利性带来一个安全提醒面板保存 Key 的存储方式取决于工具实现。如果它把 Key 写在本地明文配置里你要像保护~/.claude/settings.json一样保护它。共享电脑、录屏、远程协助前先切到假 Key 或清空面板。团队协作时只共享 Base URL 和模型名不共享个人 Key。6. 泄露面排查与轮换history、Git、CI、日志、共享终端配置完成后建议做一次密钥泄露面排查。以下命令只在本机执行输出到终端前先确认没有完整 Key# 1. 检查 shell 历史中是否出现疑似 Key history | grep -Ei ANTHROPIC_(AUTH_TOKEN|API_KEY)|TAOTOKEN_API_KEY|YOUR_API_KEY || true # 2. 检查 Git 追踪文件是否包含敏感变量名或真实 Key git grep -n -E ANTHROPIC_(AUTH_TOKEN|API_KEY)|TAOTOKEN_API_KEY || true # 3. 检查本地 Claude/Codex 配置是否被 Git 追踪 git ls-files | grep -E (^|/)\.claude/|(^|/)config\.toml$ || true # 4. 检查环境变量时只输出掩码 env | grep -E ^(ANTHROPIC_(AUTH_TOKEN|API_KEY)|TAOTOKEN_API_KEY) \ | sed -E s/^(.*).*/\1***masked***/如果发现 Key 已经进入 Git 历史只在最新提交里删除并不够因为历史提交仍可能被拉取。此时应立即到 TaoToken API Keys 页面创建新 Key撤销旧 Key再清理本地和远端历史。创建和轮换入口建议走https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_rfc_rotate 。如果 Key 出现在 CI 日志除了轮换还要把 CI 命令改成set x并使用平台 Secret 注入set x export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_AUTH_TOKEN$TAOTOKEN_API_KEY # 不要在 CI 中 echo 变量日常建议一个项目一个 Key一个用途一个 Key泄露后影响面小。定期轮换尤其是团队成员变化、电脑送修、录屏发布后。不把 Key 写进 issue、聊天记录、截图、录屏、临时文本文件。不在公共终端、共享跳板机、公共 IDE 远程环境中保留长期 Key。出现异常调用量、异常模型消耗时先停用相关 Key再排查日志。重要仓库开启提交前检查至少用正则拦截ANTHROPIC_AUTH_TOKEN、TAOTOKEN_API_KEY、sk-等模式。这些措施不能让环境变量变成绝对保险箱但能把风险从“一直明文暴露”压到“可控、可发现、可轮换”。对于 Claude Code 内调 Claude Docs、Claude Slides、Claude Design 这类研发文档工作流密钥安全的核心不是把 Key 藏得多深而是让 Key 有边界、有掩码、有轮换、有最小权限。7. 文末 CTA按“模型对话 → Coding Plan → 创建 Key → Claude Code 文档”走一遍如果你准备把 Claude Code 内的 Claude Docs、Claude Slides、Claude Design 工作流跑起来可以按下面顺序完成接入先到模型对话页确认模型和调用方式https://taotoken.net/models/detail/chat?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_rfc_chat如果准备长期在 Claude Code、Codex、CC Switch 里使用查看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_rfc_plan创建或轮换专用 API Key不要把真实 Key 贴进项目文件https://taotoken.net/console/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_rfc_key按 Claude Code 文档把 Base URL 配为https://taotoken.net/api并用YOUR_API_KEY占位符先跑通环境变量https://taotoken.net/doc/ClaudeCodeAnthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_code_rfc_docs配置时记住三条Claude Code 用ANTHROPIC_*Codex 用config.toml加独立env_keyCC Switch 用 Base URL、API Key、模型三件套分开管理。先临时环境变量验证再落用户级配置先掩码、再截屏先轮换、再排查。这样让 Claude Docs 写 RFC、让 Claude Slides 出设计评审页、让 Claude Design 补 UI 原型时密钥不会成为工作流里最薄弱的一环。