quill-pen-ai-fill

Pursuit of freedom and democracy

Go Back

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

最后编辑: 2026-05-31 17:57

原文链接：https://x.com/canghe/status/2060376680896799094

大家好，我是苍何。

前天 CodexGuide 上线后，后台直接炸了。

正文图片 01

问得最多的一个问题就是：国内怎么用 Codex？能不能不充 Plus？

说实话，我理解这个痛。

充值 Plus 本身就有门槛，还得搞定支付方式，折腾半天人都麻了。

所以我花了两天时间，把网上能找到的方案全试了一遍，踩了不少坑，最终总结出三种最靠谱的接入方法。

今天一次性分享给你，照着做就行。

  • 教程也同步上线 CodexGuide 了，随时可以查阅。
正文图片 02
  • 看在这么努力肝的份上，star 走起，哈哈哈。
正文图片 03

先说个前提，Codex 默认最稳的用法还是官方 GPT 账号登录。

接第三方 API 属于进阶操作，你得知道 config.toml、API Key、Base URL 这些东西是啥。

不懂也没关系，跟着下面一步步来就行。

三种方案怎么选

先给你一张表，对号入座：

方案

适合谁

优点

需要注意

手动配置

想理解底层原理的人

透明、可控、方便排障

要自己维护 config.toml，写错就不生效

Codex++

用桌面 App，想图形化管理的人

有管理界面，配置一键写入

第三方工具，Codex 更新后可能需要适配

CCX + CC Switch

有多个供应商、需要协议转换的人

网关路由 + 一键切换供应商

组件多，需要理解端口和代理链路

讲真的，如果你是小白，直接看方案二就行，最省心。

如果你刚开始学 Codex，建议先看看我之前的 Codex 入门教程，再回来折腾第三方 API。

方案一：手动配置

这种方式有个缺点，没办法用 Codex APP 的插件功能。

想用插件的直接跳到方案二。

正文图片 04

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

text 
~/.codex/config.toml

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

正文图片 05

两类登录思路

思路

怎么理解

适合场景

GPT 登录

保留官方登录态，只改请求转发地址

想保留官方账号能力，同时用中转

API Key 登录

用环境变量里的 Key，直接请求第三方

用 OpenAI API Key 或自建兼容服务

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

正文图片 06

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 表示不走官方登录态。

正文图片 07：https://pbs.twimg.com/media/HJftZRYagAAM7k2?format=jpg&name=large

正文图片 07

第二步，设置环境变量

打开终端，输入：

text 
export OPENAI_API_KEY="这里填你的key"
正文图片 08

第三步，从终端启动 Codex APP

这里有个坑，Mac 用户必须从终端启动，直接点图标可能读不到模型。

启动前先彻底关掉 Codex APP，然后终端输入：

text 
open -a Codex

第四步，验证效果

打开 Codex APP，你就能看到模型已经切换成功了：

正文图片 09

好家伙，直接起飞。

API Key 登录示例

如果你用的是 API Key 方式，记住一个原则：密钥放环境变量里，别写死在配置文件。

text 
export OPENAI_API_KEY="sk-your-api-key"

对应的 config.toml 配置：

有一点要注意：如果你的上游只支持 Chat Completions，不支持 Responses API，光改配置是搞不定的，得用 CCX 这类网关做协议转换，后面方案三会讲。

修改鉴权文件

打开 ~/.codex/auth.json，把 OPENAI_API_KEY 改成你模型服务商的 Key：

正文图片 10

怎么验证配置成功

配完之后别急，先验证一下：

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

方案二：Codex++

如果你觉得手动改配置太折腾，Codex++ 了解一下。

它是一个图形化的管理工具，帮你一键搞定中转配置，不用手写 toml 文件。

而且，它支持插件功能，这是方案一做不到的。

正文图片 11

适合这些人：

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

安装步骤

  • 打开 Codex++ Releases，下载安装包。
正文图片 12

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

正文图片 13
  • 安装后打开「Codex++ 管理工具」。
    首次打开如果弹这个错误，别慌：

正文图片 14：https://pbs.twimg.com/media/HJftdM0b0AAUd8s?format=png&name=large

正文图片 14

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

正文图片 15

打开后进入管理界面：

正文图片 16

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

正文图片 17

确认检测到 GPT 登录状态。

  • 添加中转配置。
    选「供应商配置」- 添加供应商，填写你的 Base URL 和 Key。

注意，接入方式选「纯 API」：

正文图片 18

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

正文图片 19

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

正文图片 20

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

正文图片 21
  • 从 Codex++ 入口启动 Codex。
    注意，要从 Codex++ 启动，不是原版 Codex：
正文图片 22

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

正文图片 23

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

正文图片 24

你还别说，这个方案是我目前用下来最丝滑的，强烈推荐。

如果想回滚怎么办

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

方案三：CCX + CC Switch

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

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

什么时候用这个方案？你有多个国产模型 API、多个中转服务、多个 Key，或者上游只支持 Chat Completions 需要转换成 Responses API 的时候。

第 1 步：部署 CCX

用 Docker 一行命令搞定：

启动后浏览器打就能看到了。

第 2 步：添加上游渠道

在 CCX 管理界面里添加你的渠道：

  • 选择上游服务类型。
  • 填 API Key 和 Base URL。
  • 配置模型映射和路由规则。
  • 用自带的测试功能确认能通。
    这里有个关键点：Codex 需要 Responses API 入口。如果上游只有 Chat Completions，CCX 会帮你做协议转换，这也是用它的核心原因。

第 3 步：安装 CC Switch

命令行安装：

text 
npm install -g cc-switch

初始化：

text 
cc-switch init

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

第 4 步：切换配置并启动

一行命令切换供应商：

text 
cc-switch use <配置名>

然后重启 Codex 就生效了。

切换后建议打开 ~/.codex/config.toml 核对一下：

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

常见踩坑汇总

最后放一张排错表，遇到问题先对照看：

现象

先检查什么

切换后没生效

是否完全重启了 Codex，model_provider 名称是否一致

报认证错误

API Key 是否有效，环境变量是否被当前 shell 继承

报接口路径错误

base_url

是否只写到 /v1，别重复拼 /responses

国产模型无响应

上游是否支持 Responses API，不支持就得用 CCX 转换

插件配置不见了

切换工具是否覆盖了配置，有没有提前备份

说实话，三种方案我都跑通了，日常用的最多的还是方案二 Codex++，省心。

如果你是那种手里有好几个 Key、好几个供应商的重度用户，方案三更适合你。

好了，今天的分享就到这里。

如果这篇教程帮到你了，点个赞让我知道，我后续会继续更新更多 Codex 的实战玩法。

有问题直接评论区问，我看到都会回。