【保姆级教程】Codex 国内也能畅快用，亲测有效

问得最多的一个问题就是：国内怎么用 Codex？能不能不充 Plus？说实话，我理解这个痛。充值 Plus 本身就有门槛，还得搞定支付方式，折腾半天人都麻了。所以我花了两天时间，把网上能找到的方案全试了一遍，踩了不少坑，最终总结出三种最靠谱的接入方法。今天一次性分享给你，照着做就行。

教程也同步上线 CodexGuide 了，随时可以查阅。

看在这么努力肝的份上，star 走起，哈哈哈。

先说个前提，Codex 默认最稳的用法还是官方 GPT 账号登录。接第三方 API 属于进阶操作，你得知道config.toml、API Key、Base URL 这些东西是啥。不懂也没关系，跟着下面一步步来就行。三种方案怎么选先给你一张表，对号入座：

讲真的，如果你是小白，直接看方案二就行，最省心。如果你刚开始学 Codex，建议先看看我之前的 Codex 入门教程，再回来折腾第三方 API。方案一：手动配置这种方式有个缺点，没办法用 Codex APP 的插件功能。想用插件的直接跳到方案二。

手动配置的核心就是改一个文件：

改之前，先备份，养成好习惯：

两类登录思路

一个建议：别一次改太多东西。先只加一个 provider，跑通了再折腾多套配置。

GPT 登录态示例也就是说，你的 Codex 得先登录 GPT 账号。第一步，改配置文件：打开~/.codex/config.toml，加入下面的配置。注意，字段和值要按你实际的服务来填：

几个容易踩坑的点：

• model_provider要和[model_providers.xxx]里的xxx完全一致，差一个字母都不行。
• base_url只写到/v1，千万别把/v1/responses整段写进去。
• wire_api = "responses"表示用 Responses API 形态请求，别改。
• requires_openai_auth = false表示不走官方登录态。

第二步，设置环境变量打开终端，输入：

第三步，从终端启动 Codex APP这里有个坑，Mac 用户必须从终端启动，直接点图标可能读不到模型。启动前先彻底关掉 Codex APP，然后终端输入：

第四步，验证效果打开 Codex APP，你就能看到模型已经切换成功了：

好家伙，直接起飞。API Key 登录示例如果你用的是 API Key 方式，记住一个原则：密钥放环境变量里，别写死在配置文件。

对应的config.toml配置：

有一点要注意：如果你的上游只支持 Chat Completions，不支持 Responses API，光改配置是搞不定的，得用 CCX 这类网关做协议转换，后面方案三会讲。修改鉴权文件打开~/.codex/auth.json，把 OPENAI_API_KEY 改成你模型服务商的 Key：

怎么验证配置成功配完之后别急，先验证一下：

1. 完全退出 Codex，重新打开。
2. 让它执行一个只读任务，比如总结当前目录结构。
3. 如果报错，先检查model_provider名称、base_url、环境变量这几个地方。
4. 出现认证错误，先切回备份配置，别慌。

方案二：Codex++如果你觉得手动改配置太折腾，Codex++ 了解一下。它是一个图形化的管理工具，帮你一键搞定中转配置，不用手写 toml 文件。而且，它支持插件功能，这是方案一做不到的。

适合这些人：

• 主要用 Codex 桌面 App 的。
• 不想手写配置文件的。
• 想随时切回官方模式的。

安装步骤

1. 打开 Codex++ Releases，下载安装包。

你会看到两个安装包：「Codex++ 管理工具」和「Codex++ app」，都要装。

2. 安装后打开「Codex++ 管理工具」。

首次打开如果弹这个错误，别慌：

去「系统设置」-「隐私与安全性」，点「仍要打开」就行：

打开后进入管理界面：

同样的方式装好 Codex++ app，管理工具检测全绿就对了：

确认检测到 GPT 登录状态。

3. 添加中转配置。

选「供应商配置」- 添加供应商，填写你的 Base URL 和 Key。注意，接入方式选「纯API」：

模型列表可以从上游自动获取，如果你配的是中转站，这里能选的模型就很多了：

本质上这个工具就是帮你更方便地写入配置，省得手动改文件：

保存后测试一下联通情况，没问题就直接用：

4. 从 Codex++ 入口启动 Codex。

注意，要从 Codex++ 启动，不是原版 Codex：

重启后，你就能看到 Codex 已经用上了自定义的模型供应商，可选模型一下子多了起来：

插件也能直接用了，这才是完整体验：

你还别说，这个方案是我目前用下来最丝滑的，强烈推荐。如果想回滚怎么办

• 在管理工具里清除 API 模式，切回官方配置就行。
• 如果 Codex 更新后 Codex++ 不好使了，等它适配就行，不影响原版使用。

方案三：CCX + CC Switch这个方案适合重度玩家，把「网关」和「切换工具」拆开了：

• CCX：API 代理网关，负责协议转换和路由。支持 Claude、OpenAI、Codex、Gemini 等多种入口。
• CC Switch：桌面管理工具，一键切换不同供应商配置。

什么时候用这个方案？你有多个国产模型 API、多个中转服务、多个 Key，或者上游只支持 Chat Completions 需要转换成 Responses API 的时候。第 1 步：部署 CCX用 Docker 一行命令搞定：

启动后浏览器打就能看到了。第 2 步：添加上游渠道在 CCX 管理界面里添加你的渠道：

1. 选择上游服务类型。
2. 填 API Key 和 Base URL。
3. 配置模型映射和路由规则。
4. 用自带的测试功能确认能通。

这里有个关键点：Codex 需要 Responses API 入口。如果上游只有 Chat Completions，CCX 会帮你做协议转换，这也是用它的核心原因。第 3 步：安装 CC Switch命令行安装：

初始化：

初始化时填入 CCX 的地址作为中转入口。

第 4 步：切换配置并启动一行命令切换供应商：

然后重启 Codex 就生效了。切换后建议打开~/.codex/config.toml核对一下：

• model_provider是不是你刚选的。
• base_url是不是指向 CCX。
• Key 有没有不小心写进公开仓库（这个很重要）。

常见踩坑汇总最后放一张排错表，遇到问题先对照看：

说实话，三种方案我都跑通了，日常用的最多的还是方案二 Codex++，省心。如果你是那种手里有好几个 Key、好几个供应商的重度用户，方案三更适合你。好了，今天的分享就到这里。如果这篇教程帮到你了，点个赞让我知道，我后续会继续更新更多 Codex 的实战玩法。有问题直接评论区问，我看到都会回。