Codex 从入门到专精小白也能看懂的 AI 手册

第 16 章 · 进阶玩法

CC Switch:多个账号、多个 AI 工具,一键切换

当你既用官方账号、又接第三方接口,或者电脑上装了好几个 AI 命令行工具时,"改配置"会变成一件很烦的事。CC Switch 就是专门收拾这个烂摊子的。

约 13 分钟读完 属于「进阶玩法」 本页 6 个小节

先把身份说清楚:它是第三方工具,不是官方产品

CC Switch 是社区开发者做的桌面小工具,不是 OpenAI、Anthropic、Google 出的。它能帮你省很多事,但它要读写你的密钥和配置文件——所以这一章的后半段"安全须知",比前半段"怎么点按钮"更重要。

它到底解决什么问题

在多个供应商之间来回换

官方账号用完了额度,想临时切到第三方接口;或者手上攒了好几个不同服务商的密钥,想按任务挑便宜的用。手动改配置文件很折磨人,它把这个动作变成一个点击。

同时用好几个 AI 命令行工具

Codex、Claude Code、Gemini CLI、Grok 这类工具各有各的配置文件格式。它把这些放在一个窗口里统一管理,不用记住每家的路径和写法。

想看清自己花了多少钱

它会定时扫描本机留下的会话记录,统计每天用了多少 token,再按内置价格表折算成大概的花费。对按量付费的用户来说,这个比月底看账单心里有底。

技能和 MCP 不想配好几遍

同一个技能、同一个 MCP 服务器,几个客户端各配一遍很烦。它可以集中管理、同步分发。

一句话判断你要不要装

只有一个官方账号、只用一个客户端 —— 用不上,别折腾。
要切两个以上账号/供应商,或者同时用好几个 AI 工具 —— 值得装,能省下大量改配置的时间。

它的原理:其实就是"帮你改配置文件"

这是本章最值钱的一段。理解了它做了什么,出问题时你就知道去哪里看,而不是干着急。它没有任何魔法,只是把下面这些文件按你的选择写好了:

它动的东西在哪儿干什么用的
Codex 的配置文件~/.codex/config.toml写入"用哪个供应商、接口地址是什么、用哪个模型"这些设置
Codex 的登录凭据~/.codex/auth.json保存登录状态和密钥。切换供应商时会改写它
模型目录~/.codex/cc-switch-model-catalog.json给客户端一份可选的模型清单
Claude Code 的配置~/.claude/settings.json同样的思路,只是换了个工具
它自己的数据~/.cc-switch/数据库、设置、日志、备份、价格表都在这个文件夹里

Windows 上,~ 就是 C:\Users\你的用户名。所以 Codex 的配置文件完整路径是 C:\Users\你的用户名\.codex\config.toml。

它自带"后悔药",这点做得不错

它会在第一次写入之前,把你原本的 config.toml 和 auth.json 原样备份到 ~/.cc-switch/backups/live-first-write/;自己的数据库也会每 24 小时自动备份一次。

万一配置被写乱了,这就是你的救命稻草。但我还是建议你自己先把 .codex 文件夹复制一份——两个人的保险,比别人一个人的保险可靠(这条习惯见第 8 章)。

动画演示点一下"切换",实际发生了什么
① 你在 CC Switch 里点切换选中某个供应商
② 它改写配置文件config.toml / auth.json
③ 重启客户端才生效Codex 启动时重新读配置
真正重要的不是界面,而是它写进了哪两个文件。出问题时照着本章的排错清单去看那两处,比反复点按钮有用得多。

怎么用:四步走

  1. 打开后先选客户端

    界面里通常按客户端分组(Codex、Claude Code、Gemini、Grok 这几类),先选你这次要管的那一个。

  2. 看供应商列表

    里面已经预置了几个官方项(OpenAI 官方、Claude 官方、Google 官方、Grok 官方之类)。这些是"用账号登录"的路线,一般不需要你填什么。


    要加第三方接口,就新建一个,通常填三样东西:起个名字、接口地址(服务商给你的那个网址)、密钥。有的还要选接口协议类型或填模型名——按服务商给的说明抄。

  3. 点切换,然后重启客户端

    点完它就把这份配置写进真正的配置文件里了。注意:Codex 是在启动时读配置的,所以已经开着的窗口不会立刻变。关掉重开一次才算真正生效。

  4. 验证一下

    重新打开 Codex,随便问一句简单的问题。能正常回答,说明切换成功;报错说认证失败或找不到模型,就说明供应商信息填错了——回去检查接口地址和密钥,别急着怀疑人生。

它默认会缩到右下角托盘常驻,所以不用每次找图标启动:右键托盘里那个小图标,通常就能快速切换供应商。

顺带能用的几件事

用量与花费统计

它按分钟扫描本机的会话记录,算出你每天的 token 用量,配合内置的价格表估算花费。每个供应商还能单独设成本倍率、每日上限、每月上限——给自己设个天花板,防止手一滑把额度用光。

技能(Skills)统一管理

内置了几个公开的技能仓库作为来源,可以看有哪些技能、有没有更新,然后同步到你用的各个客户端。省得每个工具单独折腾一遍。

MCP 服务器集中管理

你原来在各个客户端里配好的 MCP 服务器,它能读进来统一管理,再分发出去。加一个新的外部服务时,只用在它这里配一次。

会话历史与会话同步

设置里有"统一会话历史""切换时保留官方登录态"这类开关:前者让不同供应商下的对话记录汇总在一起,后者让你切到第三方时官方账号的登录状态不被清掉,切回来不用重新登录。

设置里还会看到几个更进阶的开关(比如本地代理、故障转移、配置切换器)。这些先别急着开——打开应用里对应的说明看一遍,确认自己需要它、也明白它做了什么,再动手。

安全须知:这一段请务必看完

用第三方接口,等于把内容交给第三方

官方服务的数据怎么处理,条款写得比较明确。而第三方中转服务本质上是一台别人的服务器:你的对话内容、你的密钥,都要经过它。

所以选之前要问清楚这三件事:① 会不会留存我的数据?② 会不会拿去训练?③ 计费规则是什么、有没有隐藏的模型降级? 说不清楚的,别把重要内容往里放。

  • 密钥只用你自己的。 别用来路不明、别人分享的 key——那等于把你的对话内容白送给一个你不知道是谁的人,而且额度随时可能消失。
  • 这几个文件夹别分享、别上传: ~/.cc-switch/、~/.codex/auth.json、~/.codex/config.toml。它们里面可能有明文密钥。有人让你截图发过去"帮你看看",先想一秒再说。
  • 切换前,先关掉正在运行的 Codex。 一边跑一边改配置文件,轻则不生效,重则文件写坏。
  • 公司设备、公司数据要格外小心。 把工作内容通过第三方接口发出去,可能直接违反公司规定。这种事没有"应该没事"。
  • 省钱的诱惑要警惕。 便宜的第三方服务有可能把请求"偷偷换成更小的模型"。如果你发现回答质量突然变差,先怀疑这一点。

出问题了怎么办

切换了,但 Codex 还是用旧的

九成是因为它只在启动时读配置。把正在运行的 Codex 窗口(包括终端里那个)完全关掉再重开。还不行就重启一次终端程序。如果是编辑器插件,重启编辑器。

提示写入失败、权限不足

通常是配置文件正被别的程序占用:先彻底退出 Codex 再切一次。如果还报错,检查那个文件是不是被设成了"只读",或者你的账号有没有权限改它。

它说找不到配置文件

说明这个客户端还没被初始化过。先在命令行里跑一次对应的工具(比如 codex),让它自己生成初始配置文件,然后再让 CC Switch 接管。

用量数据跟实际对不上

它的统计来源是本机留下的会话记录。所以:换过电脑、换过配置目录、用网页版或者别的客户端跑的对话,都不会被算进去。它给的是"这台机器上大概花了多少",不是账单,别拿它对账。

想彻底回到官方状态

两步:先在界面里切回官方那个供应商,重启客户端验证能正常用;如果配置已经被改乱,就退出 CC Switch,从 ~/.cc-switch/backups/live-first-write/ 里找到 config.toml 和 auth.json 的备份,复制回去覆盖。做这种覆盖之前,先把你现在这份也复制一份留底。

我该不该开那些进阶开关?

判断标准很简单:你能不能用自己的话讲清楚它是干什么的。 讲不清楚就先别开。这些开关大多和网络转发、故障转移有关,作用范围可能超出你预期——出问题时你也很难判断是它引起的还是别的原因。

回头看:这一章其实是第 6 章和第 8 章的应用

它做的所有事情,本质就是替你维护"工作区之外的配置文件"——所以更需要权限边界(第 8 章)和搞清它到底改了什么(第 6 章)这两个基本功。工具越方便,越要清楚它在替你做什么决定。

提示:用键盘 ← → 可以翻到上一章 / 下一章