1. 为什么你需要 CC-switch多 CLI 工具配置切换的真实痛点如果你同时用 Claude Code 写后端、Codex 补测试、Gemini Cli 做长上下文分析那你大概率经历过这种场景Claude Code 的额度跑完了得手动打开~/.claude/settings.json把ANTHROPIC_BASE_URL和ANTHROPIC_AUTH_TOKEN换成另一个渠道改完保存重启终端敲一句claude确认生效结果发现 JSON 少了个逗号工具直接起不来。一天切三次半小时就没了。CC-switch 就是冲着这个场景来的。它本质上是一个「配置档案管理器」你把不同供应商的 API 地址、Key、模型名提前存成一份份配置需要哪套就点哪套它负责把对应的字段写进 Claude Code、Codex、Gemini Cli 各自的配置文件里。你不用再手改 JSON也不用记每个工具配置文件叫什么名字。这篇教程面向的是同时使用多个 CLI 编程助手的开发者重点讲三件事CC-switch 的安装与全局设置、settings.json与config.toml的可复制骨架、以及用 TaoToken 统一 Key 接入 Gemini Cli 并验证切换是否真的生效。全程给命令、给配置、给排查动作跟着做就能跑通。2. 前置准备TaoToken 统一 Key 与 API 通道在装 CC-switch 之前先把「钥匙」准备好。TaoToken 的作用是提供一个统一的 API 通道和 Key让你在 Claude Code、Codex、Gemini Cli 里用同一套凭证省去每个工具单独申请、单独记 Key 的麻烦。第一步打开官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 注册并登录账号。第二步进入控制台创建 API Key。地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 在 API Keys 页面点新建复制生成的 Key形如sk-xxxxxxxx。这个 Key 后面会同时填进 CC-switch 的多个供应商档案里。第三步确认你要用的模型名。Gemini Cli 走的是 Gemini 系列模型Claude Code 走 Claude 系列Codex 走 OpenAI 系列。TaoToken 的模型列表可以在模型对话页确认https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 先记下你打算用的模型标识比如gemini-2.5-pro。第四步记下 API 基础地址。TaoToken 的 API 入口是https://taotoken.net/api注意这个地址不带任何查询参数填配置时直接用它作为 base URL。提示Key 只显示一次复制后先粘到本地临时文本里别直接关页面。后面 CC-switch 里三个供应商档案都要用同一个 Key。到这里前置就完成了一个 Key、一个 base URL、若干模型名。接下来装工具。3. CC-switch 安装与全局设置CC-switch 是开源工具发布在 GitHub Releases 页面。打开 https://github.com/farion1231/cc-switch/releases 滚动到页面底部找到最新版本的 Assets 区域。Windows 用户推荐下载.msi后缀的安装包双击按向导装完即可如果你不想装也可以下.zip解压后直接运行里面的可执行文件。macOS 用户下载.dmg拖进 Applications 就行。装完首次打开先别急着加供应商去左上角点「齿轮」图标进全局设置。在「通用」选项卡里找到「应用到 XXX 插件」这类开关把你实际要用的工具对应的开关打开——比如你主要用 Gemini Cli就打开 Gemini Cli 那一项。这个开关决定了 CC-switch 切换供应商时会不会真的把配置写进对应工具的配置文件。顺手把「开机自启」也打开省得每次手动启动。回到主界面点右上角「」新建供应商配置。这里有个关键选择如果你只想给单个工具用就在弹窗里选对应的工具类型如果你想一套配置同时喂给 Claude Code、Gemini Cli、Codex就选「统一供应商」模式。统一模式下你填一次 base URL 和 KeyCC-switch 会分别写进三个工具各自的配置文件。填的时候注意几个字段字段填什么说明名称自定义如taotoken-gemini仅用于在 CC-switch 里区分档案Base URLhttps://taotoken.net/api不带斜杠结尾不带查询参数API Key你复制的sk-xxxx三个工具共用同一个模型如gemini-2.5-pro按工具类型填对应系列填完保存这个档案就出现在主界面列表里了。你可以再建第二个档案比如把模型换成gemini-3.1-pro-preview用来做 A/B 切换测试。4. 可复制配置骨架settings.json 与 config.tomlCC-switch 帮你写配置但你得知道它写进去的是什么出问题时才能自己查。下面给出两个核心文件的骨架你可以直接对照。Claude Code 的配置文件在~/.claude/settings.jsonCC-switch 切换后会写成类似这样{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: sk-你的Key, ANTHROPIC_MODEL: claude-sonnet-4-5 } }注意ANTHROPIC_AUTH_TOKEN填的是你的 TaoToken Key不是 Anthropic 官方 Key。JSON 里不能有多余逗号字符串必须双引号这是最常见的翻车点。Gemini Cli 的配置走的是~/.gemini/settings.json部分版本在~/.config/gemini/下骨架如下{ selectedAuthType: gemini-api-key, apiKey: sk-你的Key, baseUrl: https://taotoken.net/api, model: gemini-2.5-pro }Codex 用的是 TOML 格式路径通常在~/.codex/config.tomlmodel gpt-5 model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEYTOML 里字符串用双引号[model_providers.xxx]是表头别写成 JSON 的花括号。env_key指的是环境变量名你需要在 shell 里export TAOTOKEN_API_KEYsk-你的Key或者在 CC-switch 里让它帮你注入。注意三个文件的路径和字段名会随工具版本变化。如果你发现 CC-switch 切换后工具没反应第一件事就是打开对应文件确认字段名和当前版本文档一致。5. 用 TaoToken 接入 Gemini Cli 并验证切换现在做一次完整演练。假设你在 CC-switch 里建了两个档案taotoken-gemini-25用gemini-2.5-protaotoken-gemini-31用gemini-3.1-pro-preview。先选中taotoken-gemini-25点启用。CC-switch 会把配置写进 Gemini Cli 的 settings.json。打开终端输入gemini进入交互界面后问一句你当前使用的模型是什么。如果返回里出现gemini-2.5-pro说明第一套配置生效了。接着在 CC-switch 里切到taotoken-gemini-31点启用。回到终端先按两下CtrlC退出当前 Gemini Cli 进程——这一步很多人漏掉导致旧进程还挂着旧配置。然后重新输入gemini再问一次模型名这次应该返回gemini-3.1-pro-preview。如果两次返回的模型名确实变了说明 CC-switch 的切换链路是通的它改文件 → 你重启进程 → 新配置加载。Claude Code 和 Codex 的验证逻辑一样切换档案 → 退出进程 → 重启 → 用一句简单提问确认模型或渠道变了。区别只是配置文件路径和字段名不同操作动作完全一致。6. 本篇常见报错与排查动作报错一切换后工具仍用旧模型。九成是进程没重启。CLI 工具启动时读一次配置运行中不会热加载。动作CtrlC退出确认进程真的没了ps aux | grep gemini再重新启动。报错二JSON 解析失败工具起不来。打开~/.claude/settings.json或 Gemini 的 settings.json用python -m json.tool settings.json校验格式。常见原因是尾随逗号、单引号、中文引号。CC-switch 正常写入不会出这种问题但如果你手动改过就要查。报错三401 或鉴权失败。检查 Key 是否复制完整、有没有多余空格检查 base URL 是不是https://taotoken.net/api别多加/v1或结尾斜杠。如果 Key 在控制台被删过重新生成一个再填。报错四CC-switch 切换了但文件没变。回全局设置确认「应用到 XXX 插件」的开关是打开的。这个开关关着的时候CC-switch 只切换自己界面里的选中状态不会写文件。报错五Codex 读不到 Key。TOML 里写的是env_key TAOTOKEN_API_KEY这是环境变量名不是 Key 本身。你需要在 shell 配置里export TAOTOKEN_API_KEYsk-xxxx或者让 CC-switch 帮你注入环境变量。排查顺序建议固定成先看文件内容对不对 → 再看进程有没有重启 → 最后看 Key 和 URL 有没有错。按这个顺序走大部分问题三分钟内能定位。如果你在接入过程中卡在鉴权或配置字段上可以直接去 API Keys 页面重新生成 Key 并对照接入文档核对字段https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi-keysutm_campaignrewrite 文档入口在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。想先确认模型能不能正常对话用模型对话页试一句最快https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。如果你打算长期用 Claude Code 或 Codex 跑编码任务Coding Plan 更适合按量长期跑https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding-planutm_campaignrewrite 。