从零跑通 Codex:装 CLI、接中转,再让 cc-switch 替你管配置

写给第一次上手 Codex 的人:从安装 CLI、手动接上 Dlow 中转,到用 cc-switch 一键管理多套配置,把每一步容易翻车的地方提前讲清楚。

最近后台问得最多的问题,不是模型好不好用,而是更靠前的:Codex 装完之后那两个文件到底怎么改,改完为什么还是跑不通。

这事确实劝退了不少人。官方文档默认你用 ChatGPT 订阅登录,一路下一步就好;但走中转的话,登录这一步是绕过去的,配置要自己落盘,一个引号打错,终端里就是一行看不懂的红字。

所以这篇不聊原理,就干三件事:装好 Codex CLI、接上 Dlow 的中转、最后装个 cc-switch,以后这些配置文件你就不用再碰了。每一步里容易翻车的位置,我都单独拎出来说。

先花两分钟,搞懂 Codex 的"登录"

Codex CLI 有两种身份可以用。

一是 ChatGPT 账号登录,Plus/Pro 订阅用户直接授权,用订阅自带的额度。二是 API Key,任何兼容 OpenAI 接口的服务都能接,中转站走的就是这条路。

两种身份最终都会落到你用户目录下的 .codex 文件夹里——Windows 是 %userprofile%\.codex,macOS 和 Linux 是 ~/.codex。核心就两个文件:

  • auth.json:存钥匙,也就是你的 API Key
  • config.toml:存"电话号码",请求打到哪个地址、用哪个模型

所谓配置 Codex,翻来覆去就是改这两个文件。手动改一次不难,麻烦在后面:你想同时留着订阅和中转,或者接了两家中转比着用,每次切换都得手动来回复制粘贴,早晚出错。这就是第三步要装 cc-switch 的原因。

第一步:装 Codex CLI

macOS 用 Homebrew 一行搞定:

1
brew install codex

没有装 Homebrew 的,或者 Windows 用户,走 npm(前提是先装好 Node.js,建议 22 以上版本):

1
npm install -g @openai/codex

装完敲 codex --version,能吐出版本号就说明装上了。然后直接运行 codex,第一次会弹一个登录方式的选择界面:

第一次运行 codex,会先让你选登录方式

第一次运行 codex,会先让你选登录方式

打算用 ChatGPT 订阅的,这一步直接登录就完事,后面你只需要看 cc-switch 的部分。打算走中转的,先别登录,退出(Ctrl+C 或输入 /exit),我们手动把配置放进去。

第二步:接上 Dlow 的中转

先去 Dlow 控制台创建一个 Codex 分组的令牌。分组一定不要选错,选错了模型调不通,不清楚各个分组区别的看这篇介绍。

然后打开你的 .codex 目录(路径在上面),新建两个文件。

config.toml 写入:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
model_provider = "dlowapi"
model = "gpt-5.6-sol"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.dlowapi]
name = "dlowapi"
base_url = "https://www.dlowapi.me/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json 写入:

1
2
3
{
  "OPENAI_API_KEY": "你在 Dlow 创建的令牌"
}

两个容易出错的地方:模型名要以你令牌分组实际可用的为准,去控制台的「模型广场」把名字原样抄过来;wire_api 保持 responses 不要动,新版本 Codex 走的就是这个协议。

保存后重新运行 codex,随便发一句话试试:

能正常回话,说明中转已经接通

能正常回话,说明中转已经接通

它肯回话,中转就算接通了。想折腾更多配置(全局提示词、联网搜索这些),去Codex CLI 配置,这里不展开。

到这里其实你已经可以正常用了。但相信我,用不了几天你就会想换模型、换中转,或者把订阅号和中转来回切——继续往下看。

第三步:cc-switch 登场,把配置文件交给它

cc-switch 是一个开源的桌面工具,专门干一件事:管理 Claude Code、Codex、Gemini CLI 这类工具的"供应商",把切换做成点一下按钮的事。数据全部存在本地,没有账号体系,卸载了也不影响你原来的工具。

安装不复杂。macOS 推荐用 Homebrew:

1
brew install --cask cc-switch

Windows 去它的 Releases 页面下载 .msi 安装包(也有免安装的 Portable 版),Linux 提供 .deb 和 .AppImage。

装好打开,点工具栏的「+」添加供应商,应用选 Codex,然后填这几样:

  • 名称:随意,比如「Dlow 中转」
  • API 地址:https://www.dlowapi.me/v1
  • API Key:还是那个 sk- 开头的令牌
  • 模型:gpt-5.6-sol,或者你分组里的其他模型
  • 协议:选 OpenAI Responses,对应配置文件里的 wire_api = "responses"
添加供应商,把地址、Key、模型、协议填齐

添加供应商,把地址、Key、模型、协议填齐

保存之后回到供应商列表,在这条配置上点一下,它就生效了:

列表里点一下就是切换,不用再碰配置文件

列表里点一下就是切换,不用再碰配置文件

重新打开 codex,输入 /status 看一眼,当前的供应商和模型应该已经变成你刚配的这条:

/status 确认当前走的是 Dlow 中转

/status 确认当前走的是 Dlow 中转

它比手改文件好在哪

三个点,都是实打实的。

切换是外科手术式的。 它只替换地址、Key、模型名这几个关键字段,你在 config.toml 里自己加的 MCP、注释、权限设置统统保留。第一次改写前还会自动备份一份到 ~/.cc-switch/ 下面,手抖了有得后悔。

官方登录不会丢。 如果你用订阅登录过、又切到第三方中转,cc-switch 会把官方登录先收进一个临时文件里存着;哪天想切回订阅,点一下就原样恢复。两套身份互不打架。

一份配置可以多处用。 同时玩 Claude Code 和 Codex 的话,可以用它的通用供应商,一份地址和 Key 同步写进两个工具,不用配两遍。

装完之后,我日常是这么用的

重度干活的时候走中转,模型随便挑、按量计费心里有数;想试试官方最新模型的时段,托盘点一下切回订阅,用完再切回来。cc-switch 常驻系统托盘,切换这个动作基本零成本,这就是它最值钱的地方——省的不是时间,是不打断心流。

Codex 里几个高频操作顺便提一下:/model 换模型,/resume 接着上次的会话继续,/review 让它自己检查工作区改动。完整的命令表在 Codex 相关问题里。

三个大概率会撞上的报错

提前打个预防针,真撞上了不至于慌。

401 Unauthorized:九成是 Key 的问题。检查 auth.json 里的令牌有没有复制完整;有些机器上残留的 OPENAI_API_KEY 环境变量也会捣乱,清理步骤见 FAQ 的 401 一节。

Model not found / 模型不可用:要么模型名抄错了,要么令牌分组选错了。去模型广场核对名字,确认你的分组里确实有这个模型。

Stream disconnected / Connection failed:网络的事,先把代理关掉试试,还不行看 FAQ 里的连接排查和 MTU 那两条。

写在最后

回头看,整个流程就三段:装 CLI,两个文件接上中转,然后 cc-switch 接管切换。第一次手配那两个文件不算多余动作——正是亲手改过一遍,你才知道 cc-switch 每次替你干了什么。

下一篇打算写 cc-switch 的进阶玩法(MCP 管理、用量统计),以及 AGENTS.md 怎么写才能真正约束住 Codex。有问题群里喊我。