在 WSL 里装 cc-switch下载 deb 文件只是第一步真正麻烦的是装完之后Codex 和 Claude Code 各要一套 Key。我把两边的供应商都指向 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 上创建的一把 TaoToken Key之后在 cc-switch 里点一下就能从 Codex 切到 Claude Code再也不用同时维护两套密钥。这篇文章顺着原来的安装路径写先解决 deb 依赖再处理 WSL 启动乱码最后才是「一个 Key 喂两家」的供应商配置。每一步都是实际执行过的顺序也按真实操作来方便你照着抄如果你已经装好 cc-switch 只是切换不顺直接从第 3 节开始看。文中所有命令都基于 WSL Ubuntu其他发行版命令略有差异但思路一样。1. WSL 里装 cc-switch先把 deb 的依赖坑填上1.1 从 releases 下载 deb进 WSL 直接装大概率报错cc-switch 的安装包在 GitHub releases 页面文件命名一般是 CC-Switch-v3.5.1-Linux.deb 这种版本号以后续 release 为准。下载时注意别下成 Windows 的 exeLinux 版才对应 WSL 环境。下载完成后在 WSL 里先确认文件所在目录cd /mnt/c/Users/你的用户名/Downloads ls -l CC-Switch-*.deb这里有个 WSL 的细节从 Windows 浏览器下载的文件默认放在 /mnt/c 下的 Windows 目录直接cd过去安装没问题但如果遇到权限相关报错把文件先拷回 WSL 的 home 目录再装cp CC-Switch-*.deb ~/ cd ~/随后执行安装命令sudo dpkg -i CC-Switch-v3.5.1-Linux.deb这一步大概率会报「dependency problems」或「依赖关系不满足」之类的提示原因不是安装包损坏而是系统里缺少 cc-switch 运行所依赖的几个基础库。1.2 用 --fix-broken install 收尾再重跑 dpkg修依赖不需要你手动去找缺了哪些包apt 会自动补齐sudo apt --fix-broken install这条命令会检查当前系统里所有未完成的依赖安装把缺的包装好顺带把刚才 dpkg -i 留下的半安装状态处理掉。等它跑完再执行一次安装sudo dpkg -i CC-Switch-v3.5.1-Linux.deb这次不会再有依赖报错安装输出最后会出现 done 之类的提示。启动命令也简单cc-switch如果此时窗口弹出来了但界面全是方块说明你提前遇到了下面这段乱码问题。2. 启动乱码补字体别让界面挡住后续配置2.1 中文界面变方块原因多半在字体cc-switch 的界面是中文的而 WSL 默认不带任何中文字体。缺少字体时文字渲染不出字形界面上就是一排排方块或问号选项看不清后续供应商配置根本没法操作。这属于启动阶段最影响体验的一个坑我在第一次启动时也碰到过。2.2 给 WSL 补一套中文字体在 Ubuntu 里装中文字体最常见的选择是 Noto CJK安装命令sudo apt install fonts-noto-cjk也可以选文泉驿微米黑sudo apt install fonts-wqy-microhei装完字体后退出 cc-switch 再重新启动界面文字就能正常显示了。如果还是乱码先确认终端本身有没有关闭自定义字体WSL 的 Windows Terminal 一般不用额外设置但老版本终端可能需要把字体改成支持中文的字体比如「等距更纱黑体」或「微软雅黑」。字体搞定后cc-switch 的主界面能看清楚接下来才轮到配置供应商。3. 切供应商前先到 TaoToken 拿一把 Key3.1 注册、创建 API Key 一气呵成打开 TaoToken 的落地页注册账号后进控制台在 API Keys 界面点创建按钮生成一把以 sk- 开头的密钥。创建后先复制保存后续填进 cc-switch 需要用到页面关闭后密钥不会再完整显示。这里创建的 Key 就是之后 Codex 和 Claude Code 共同使用的那一把所以复制时留意别多带空格或换行。3.2 在 cc-switch 里新增供应商Base URL 填 https://taotoken.net/api打开 cc-switch找到供应商管理入口新增一条记录。需要填写的字段并不复杂关键信息如下配置项填写内容供应商名称自己起一个比如 TaoTokenAPI Base URLhttps://taotoken.net/apiAPI KeyYOUR_API_KEY模型 ID以 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型广场为准Base URL 这一项特别容易写错注意两点一是末尾不要加 /v1二是不要把官网首页地址填进去。官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 只用来注册和看用量工具真正请求的接口是 https://taotoken.net/api两者各司其职。模型 ID 不要凭记忆填以 TaoToken 官网模型广场当时展示的 ID 为准。不同模型的路由、生效逻辑可能不同选好之后记下来Codex 和 Claude Code 两侧用同一个模型 ID 即可。3.3 一把 Key 喂两家的原理cc-switch 切换供应商时会往 Codex 和 Claude Code 各自的配置文件里写入对应配置Codex 读 ~/.codex/config.toml 里的 model_providerClaude Code 读 ~/.claude/settings.json 里的 env。两者请求的地址和密钥都来自同一条 TaoToken 供应商记录所以切换模型只发生在 cc-switch 这一层Key 始终是同一把。这也是用 cc-switch 而不是手动改配置的原因——手动改很容易漏改一半切来切去就乱了。4. 从 Codex 切到 Claude Code验证同一把 Key 生效4.1 先让 Codex 跑一条测试消息在 cc-switch 里选中刚创建的供应商点击应用或切换。然后打开终端运行codexcodex输入任意一条开发相关的问题比如「解释一下这段代码的时间复杂度」让 Codex 正常回答一轮。回答成功后先别急着切走去官网控制台的用量页面看一眼刚刚这次请求有没有被记录。能查到记录说明 Codex 侧已经成功走上 TaoToken 通道。4.2 切到 Claude Code 再跑一条回到 cc-switch把供应商切换记录切到刚才那条记录再在项目目录里运行claudeClaude Code 启动后同样问一个问题例如「当前项目的文件结构是怎样的」。注意 Claude Code 是对话式工具它会先读取项目上下文再回答所以建议在测试目录里跑避免它扫描整个磁盘。回答完成后再次去控制台核对这次应该能看到 Claude Code 产生的第二条调用记录两条记录挂在同一把 Key 下。4.3 两边的配置文件长什么样cc-switch 不会让你手动去编辑这些文件但了解它在改什么排查问题时更有方向。Codex 侧的 ~/.codex/config.toml 会写入类似下面的 providermodel_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/apiClaude Code 侧的 ~/.claude/settings.json 会写入{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_AUTH_TOKEN: YOUR_API_KEY, ANTHROPIC_MODEL: YOUR_MODEL_ID } }其中 ANTHROPIC_MODEL 的取值以模型广场实际选择为准不要照抄成字面字符串。手动改过这两个文件的话再切一次 cc-switch 会覆盖回来所以来回横跳逻辑以 cc-switch 当前选中的供应商为准。5. 切换报错排查401、/v1 和没生效5.1 401Key 复制出了问题如果 Codex 或 Claude Code 在切换后返回 401 认证失败大概率是 API Key 粘贴时带了空格或换行。去 TaoToken 控制台重新复制一次粘贴到 cc-switch 的 Key 输入框确认首尾没有多余字符。另一种情况是 Key 在创建后已经被删除或重置去控制台重新生成一把再试。5.2 model not found模型 ID 没按模型广场选返回 404 或提示模型不存在基本是模型 ID 填错了。在 3.2 里我们就强调模型 ID 必须以模型广场为准这里单独拿出来说是因为排障时最容易被忽略报错信息里提示的模型名和你填进去的 ID 往往只有细微差别比如大小写、连接符、日期后缀。如果你在 Codex 或 Claude Code 的报错里看到「model not found」或「unknown model」先回官网模型广场复制准确 ID再回 cc-switch 粘贴避免手打。手打很容易把短横线或点号打错。5.3 Base URL 多了 /v1接口返回 404很多工具默认习惯在 Base URL 后补 /v1但 https://taotoken.net/api 已经包含了路由前缀末尾再加 /v1 会拼出不存在且多冗余的路径请求就会失败。这也是切换后最容易遇到的一类问题先检查这一项再去动其他配置。5.4 切了没生效cc-switch 是否真正应用在 cc-switch 的供应商列表里选中状态高亮不等于配置已生效有些版本需要再点一次应用按钮才会覆盖配置文件。应用后可以打开 ~/.claude/settings.json 或 ~/.codex/config.toml 确认内容确实被替换。如果文件被其他工具或手动编辑过程覆盖重新切一遍供应商即可恢复。6. 回控制台对账顺手把文档收藏6.1 用同一把 Key 发一条测试消息热身配置保存后先在 TaoToken 模型对话 里用你刚创建的 Key 发一条测试消息确认模型 ID 和 Base URL 没填错。这一步能帮你把「配置问题」和「用量问题」快速分开网页对话能通说明 Key 和模型没问题网页对话不通赶紧回 cc-switch 检查配置。6.2 去控制台看这次切换是否记上账刚才 Codex 和 Claude Code 各跑了一轮测试现在打开 控制台 API Keys查看这把 Key 的调用记录应该能看到两条来自不同工具的请求。以后用量、计费相关的细节以这里实时展示的数据为准。6.3 再留一份 Claude Code 接入文档如果后续要用到 Claude Code 的更多环境变量或高级参数可以对照 Claude Code 接入文档 里的说明调整。日常使用其实只需要 cc-switch 里那条供应商配置就够文档是给你查漏补缺用的别一上来就把环境变量堆满。到这一步cc-switch 的价值才真正体现出来Key 还是同一把 TaoToken KeyCodex 和 Claude Code 却能在各自的入口自由切换互不干扰。以后新增模型或调整套餐也只需要在控制台操作工具这边不用再动。