這是蒼何的第 540 篇原創！

大家好，我是蒼何。

前天 CodexGuide 上線后，后臺直接炸了。

問得最多的一個問題就是：國內怎么用 Codex？能不能不充 Plus？

說實話，我理解這個痛。

充值 Plus 本身就有門檻，還得搞定支付方式，折騰半天人都麻了。

所以我花了兩天時間，把網上能找到的方案全試了一遍，踩了不少坑，最終總結出三種最靠譜的接入方法。

今天一次性分享給你，照著做就行。

教程也同步上線 CodexGuide 了，隨時可以查閱。

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

先說個前提，Codex 默認最穩的用法還是官方 GPT 賬號登錄。

接第三方 API 屬于進階操作，你得知道 config.toml、API Key、Base URL 這些東西是啥。

不懂也沒關系，跟著下面一步步來就行。

三種方案怎么選

先給你一張表，對號入座：

方案

適合誰

優點

需要注意

手動配置

想理解底層原理的人

透明、可控、方便排障

要自己維護 config.toml ，寫錯就不生效

Codex++

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

有管理界面，配置一鍵寫入

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

CCX + CC Switch

有多個供應商、需要協議轉換的人

網關路由 + 一鍵切換供應商

組件多，需要理解端口和代理鏈路

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

如果你剛開始學 Codex，建議先看看我之前的 Codex 入門教程，再回來折騰第三方 API。

方案一：手動配置

這種方式有個缺點，沒辦法用 Codex APP 的插件功能。

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

手動配置的核心就是改一個文件：

●●●~/.codex/config.toml

改之前，先備份，養成好習慣：

●●●cp ~/.codex/config.toml ~/.codex/config.toml.backupcp ~/.codex/auth.json ~/.codex/auth.json.backup

思路

怎么理解

適合場景

GPT 登錄

保留官方登錄態，只改請求轉發地址

想保留官方賬號能力，同時用中轉

API Key 登錄

用環境變量里的 Key，直接請求第三方

用 OpenAI API Key 或自建兼容服務

一個建議：別一次改太多東西。先只加一個 provider，跑通了再折騰多套配置。

GPT 登錄態示例

也就是說，你的 Codex 得先登錄 GPT 賬號。

第一步，改配置文件：

打開 ~/.codex/config.toml，加入下面的配置。

注意，字段和值要按你實際的服務來填：

●●●model = "gpt-5-codex" #這里填你想要的模型model_reasoning_effort = "high"disable_response_storage = truepreferred_auth_method = "apikey"

[model_providers.ciyuan]name = "ciyuan" # 填你的模型提供商名字或者中轉站名字，這里以詞元為例base_url = "https://ciyuan.today/v1" # 填你的模型提供商的請求 URLwire_api = "responses" # 這里不要變env_key = "OPENAI_API_KEY" # 這里將會通過環境變量的方式注入并啟動Codex APPrequires_openai_auth = false

幾個容易踩坑的點：

• model_provider 要和 [model_providers.xxx] 里的 xxx 完全一致，差一個字母都不行。

• base_url 只寫到 /v1 ，千萬別把 /v1/responses 整段寫進去。

• wire_api = "responses" 表示用 Responses API 形態請求，別改。

• requires_openai_auth = false 表示不走官方登錄態。

第二步，設置環境變量

打開終端，輸入：

●●●export OPENAI_API_KEY="這里填你的key"

第三步，從終端啟動 Codex APP

這里有個坑，Mac 用戶必須從終端啟動，直接點圖標可能讀不到模型。

啟動前先徹底關掉 Codex APP，然后終端輸入：

●●●open -a Codex

第四步，驗證效果

打開 Codex APP，你就能看到模型已經切換成功了：

好家伙，直接起飛。

API Key 登錄示例

如果你用的是 API Key 方式，記住一個原則：密鑰放環境變量里，別寫死在配置文件。

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

對應的 config.toml 配置：

●●●model = "gpt-5.1-codex-max"model_provider = "my-api-provider"
[model_providers.my-api-provider]name = "My API Provider"base_url = "https://example.com/v1"wire_api = "responses"env_key = "OPENAI_API_KEY"requires_openai_auth = false

有一點要注意：如果你的上游只支持 Chat Completions，不支持 Responses API，光改配置是搞不定的，得用 CCX 這類網關做協議轉換，后面方案三會講。

修改鑒權文件

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

怎么驗證配置成功

配完之后別急，先驗證一下：

1. 完全退出 Codex，重新打開。

2. 讓它執行一個只讀任務，比如總結當前目錄結構。

3. 如果報錯，先檢查 model_provider 名稱、 base_url 、環境變量這幾個地方。

4. 出現認證錯誤，先切回備份配置，別慌。

如果你覺得手動改配置太折騰，Codex++ 了解一下。

它是一個圖形化的管理工具，幫你一鍵搞定中轉配置，不用手寫 toml 文件。

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

適合這些人：

• 主要用 Codex 桌面 App 的。

• 不想手寫配置文件的。

• 想隨時切回官方模式的。

1. 打開 Codex++ Releases，下載安裝包。

你會看到兩個安裝包：「Codex++ 管理工具」和「Codex++ app」，都要裝。

1. 
   

   安裝后打開「Codex++ 管理工具」。

首次打開如果彈這個錯誤，別慌：

去「系統設置」-「隱私與安全性」，點「仍要打開」就行：

打開后進入管理界面：

同樣的方式裝好 Codex++ app，管理工具檢測全綠就對了：

確認檢測到 GPT 登錄狀態。

1. 添加中轉配置。

選「供應商配置」- 添加供應商，填寫你的 Base URL 和 Key。

注意，接入方式選「純API」：

模型列表可以從上游自動獲取，如果你配的是中轉站，這里能選的模型就很多了：

本質上這個工具就是幫你更方便地寫入配置，省得手動改文件：

保存后測試一下聯通情況，沒問題就直接用：

1. 
   

   從 Codex++ 入口啟動 Codex。

注意，要從 Codex++ 啟動，不是原版 Codex：

重啟后，你就能看到 Codex 已經用上了自定義的模型供應商，可選模型一下子多了起來：

插件也能直接用了，這才是完整體驗：

你還別說，這個方案是我目前用下來最絲滑的，強烈推薦。

如果想回滾怎么辦

• 在管理工具里清除 API 模式，切回官方配置就行。

• 如果 Codex 更新后 Codex++ 不好使了，等它適配就行，不影響原版使用。

這個方案適合重度玩家，把「網關」和「切換工具」拆開了：

• CCX：API 代理網關，負責協議轉換和路由。支持 Claude、OpenAI、Codex、Gemini 等多種入口。

• CC Switch：桌面管理工具，一鍵切換不同供應商配置。

什么時候用這個方案？你有多個國產模型 API、多個中轉服務、多個 Key，或者上游只支持 Chat Completions 需要轉換成 Responses API 的時候。

第 1 步：部署 CCX

用 Docker 一行命令搞定：

●●●docker run -d \  --name ccx \  -p 3000:3000 \  -e PROXY_ACCESS_KEY=your-proxy-access-key \  -e APP_UI_LANGUAGE=zh-CN \  -v $(pwd)/.config:/app/.config \  crpi-i19l8zl0ugidq97v.cn-hangzhou.personal.cr.aliyuncs.com/bene/ccx:latest

啟動后瀏覽器打就能看到了。

第 2 步：添加上游渠道

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

1. 選擇上游服務類型。

2. 填 API Key 和 Base URL。

3. 配置模型映射和路由規則。

4. 用自帶的測試功能確認能通。

這里有個關鍵點：Codex 需要 Responses API 入口。如果上游只有 Chat Completions，CCX 會幫你做協議轉換，這也是用它的核心原因。

第 3 步：安裝 CC Switch

命令行安裝：

●●●npm install -g cc-switch

初始化：

●●●cc-switch init

初始化時填入 CCX 的地址作為中轉入口。

第 4 步：切換配置并啟動

一行命令切換供應商：

●●●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 的實戰玩法。

有問題直接評論區問，我看到都會回。