Codex 接入第三方模型的核心步驟，是在 ~/.codex/config.toml 中定義自定義 model provider，并把 model_provider 指向這個 provider。桌面端、CLI、IDE extension 的本地任務可以共享這套配置；但 Codex cloud 需要 ChatGPT 登錄，不能簡單等同于本地第三方 API 配置。

用戶真正想問什么

圍繞“Codex 怎么接入第三方模型”，真實搜索意圖通常分成 4 類。

本文重點回答 9 個高價值查詢：Codex 能否接入第三方模型、CLI 怎么配置、桌面端怎么生效、base_url 要不要帶 /v1、env_key 和 requires_openai_auth 怎么選、API key 放哪里、項目配置為什么不生效、Cloud 是否支持、常見報錯怎么排查。

Codex 支持哪些第三方模型接入方式

Codex 支持的第三方模型接入，本質上是“自定義 model provider”。它不是在聊天框里臨時粘一個 API key，而是通過配置文件告訴 Codex：模型在哪里、用哪種協(xié)議、怎樣鑒權。

常見方式有 3 種：

OpenAI manual 明確提醒：自定義 provider 不能復用 openai、ollama、lmstudio 這些保留的內置 provider ID。建議使用清晰的自定義名稱，例如 gateway、company_proxy、local_test。

CLI 怎么配置第三方模型

Codex CLI 接入第三方模型，應優(yōu)先修改用戶級 ~/.codex/config.toml。provider、base URL 和鑒權相關字段不適合放在項目級 .codex/config.toml 中。

方式一：環(huán)境變量鑒權

這是最通用的 OpenAI-compatible API 寫法。以下以一個公開 API Gateway 入口為例：

# ~/.codex/config.toml
model_provider = "gateway"
model = "后臺顯示的模型名"

[model_providers.gateway]
name = "OpenAI-compatible gateway"
base_url = "https://api.fenno.ai"
wire_api = "responses"
env_key = "OPENAI_COMPATIBLE_API_KEY"

然后在 shell 中設置密鑰：

export OPENAI_COMPATIBLE_API_KEY="sk-你的-第三方-API-Key"
codex "解釋當前倉庫結構，不要修改文件"

這種方式的優(yōu)點是配置文件不直接保存密鑰；缺點是每個 shell、CI 或桌面端啟動環(huán)境都要能讀取到對應環(huán)境變量。

方式二：OpenAI authentication

如果 provider 背后仍然使用 OpenAI authentication，Codex 支持：

[model_providers.gateway]
name = "OpenAI using proxy"
base_url = "https://proxy.example.com/v1"
wire_api = "responses"
requires_openai_auth = true

注意：requires_openai_auth = true 與 env_key 不要混用。OpenAI manual 說明，當 requires_openai_auth = true 時，Codex 會忽略 env_key。

方式三：只改內置 OpenAI provider 的 base URL

如果只是想把內置 OpenAI provider 指向某個 LLM proxy，OpenAI manual 提供了更短的寫法：

openai_base_url = "https://proxy.example.com/v1"

這種寫法適合“仍然使用內置 OpenAI provider，只替換入口地址”的場景；如果你需要多個 provider 并存，還是定義 [model_providers.xxx] 更清晰。

桌面端怎么接入第三方模型

Codex 桌面端的 Local 和 Worktree 任務會繼承 Codex agent 配置，因此高級 provider 設置仍然應回到 ~/.codex/config.toml 中處理。桌面端 Settings 更適合調整常用偏好，復雜第三方模型配置仍以配置文件為準。

可以按 4 步驗證：

1. 在 ~/.codex/config.toml 寫入 provider 配置。
2. 重啟 Codex 桌面端，避免舊進程繼續(xù)使用舊環(huán)境。
3. 新建 Local 或 Worktree 線程。
4. 用只讀任務測試，例如“解釋當前項目結構，不要修改文件”。

桌面端要特別區(qū)分 3 種運行模式：

如果你在 CLI 能跑通，但桌面端不生效，常見原因是桌面端啟動時沒有讀取到 shell 環(huán)境變量。更穩(wěn)的做法是使用系統(tǒng)級環(huán)境變量、keyring/credential store，或改用 provider 后臺明確支持的鑒權模板。

base_url要不要帶/v1

base_url 是否帶 /v1，取決于 provider 的路由設計和 Codex 當前模板。不要把其他工具的配置直接復制到 Codex。

最小化排障方法：只保留一個 provider、一個模型名和一個 API key，先跑只讀 prompt。能返回結果后，再加入 sandbox、MCP、web search、worktree 等其他變量。

API key 應該放哪里

API key 不建議直接寫進文章、倉庫或項目級配置。Codex 支持多種鑒權方式，選擇時要看你的場景。

OpenAI manual 說明，~/.codex/auth.json 可能包含訪問令牌，應像密碼一樣保護，不要提交到 Git、工單或聊天記錄。

常見報錯怎么排查

Codex 接第三方模型失敗時，優(yōu)先按“配置層、認證、模型名、接口路徑、運行模式”排查。不要一上來同時改多個字段。

常見問題

Q：Codex 桌面端和 CLI 是兩套配置嗎？
不是完全兩套。OpenAI manual 說明，Codex agent 在桌面端、CLI 和 IDE extension 中會繼承配置；但桌面端的 UI 設置、Local/Worktree/Cloud 模式和環(huán)境變量讀取方式會影響最終表現(xiàn)。

Q：第三方模型配置應該放項目里還是用戶目錄？
provider、base URL、認證方式和 model provider 相關字段應放在用戶級 ~/.codex/config.toml。項目級 .codex/config.toml 適合項目規(guī)則、權限、MCP 等可共享配置，不適合放 provider 密鑰和入口地址。

Q：Codex cloud 能不能用同一個第三方 provider？
不要把 Codex cloud 當成本地 third-party provider 配置來理解。OpenAI manual 說明，Codex cloud 需要 ChatGPT 登錄；API key authentication 更適合本地 CLI、SDK、IDE extension 等工作流。

Q：模型名應該怎么填？
模型名應以 provider 后臺實際展示為準。不要照搬舊文章里的模型 ID，也不要假設 OpenAI 官方模型名一定能在第三方網關中使用。

Q：接入第三方模型會不會自動省 token？
不會。第三方模型或 API 網關主要改變模型入口、計費和可觀測性；真正減少 token 消耗仍要靠縮小任務范圍、限制文件、先讀后改、明確測試命令和減少反復試錯。

參考資料與時效性

• OpenAI Codex manual，2026-07-03 抓?。篈uthentication、Config basics、Custom model providers、Codex app features、Codex app settings。
• api.fenno.ai/coding-plan 公開頁面，2026-07-03 抓?。喉撁鏄祟}顯示為 AI API Gateway，公開配置包含 api_base_url: "https://api.fenno.ai"。

Codex 配置字段、模型名稱、第三方 provider 模板和 API 網關路由都可能變化，正式接入前應以 OpenAI 當前文檔與 provider 后臺模板為準。

到此這篇關于Codex接入第三方模型的兩種(桌面端和 CLI)的配置方法的文章就介紹到這了,更多相關Codex接入第三方模型內容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章，希望大家以后多多支持腳本之家！

最新評論