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

用戶真正想問什么

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

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

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

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

常見方式有 3 種：

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

CLI 怎么配置第三方模型

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

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

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

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

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

然后在 shell 中設(shè)置密鑰：

export OPENAI_COMPATIBLE_API_KEY="sk-你的-第三方-API-Key"
codex "解釋當(dāng)前倉(cāng)庫(kù)結(jié)構(gòu)，不要修改文件"

這種方式的優(yōu)點(diǎn)是配置文件不直接保存密鑰；缺點(diǎn)是每個(gè) shell、CI 或桌面端啟動(dòng)環(huán)境都要能讀取到對(duì)應(yīng)環(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 說(shuō)明，當(dāng) requires_openai_auth = true 時(shí)，Codex 會(huì)忽略 env_key。

方式三：只改內(nèi)置 OpenAI provider 的 base URL

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

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

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

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

Codex 桌面端的 Local 和 Worktree 任務(wù)會(huì)繼承 Codex agent 配置，因此高級(jí) provider 設(shè)置仍然應(yīng)回到 ~/.codex/config.toml 中處理。桌面端 Settings 更適合調(diào)整常用偏好，復(fù)雜第三方模型配置仍以配置文件為準(zhǔn)。

可以按 4 步驗(yàn)證：

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

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

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

base_url要不要帶/v1

base_url 是否帶 /v1，取決于 provider 的路由設(shè)計(jì)和 Codex 當(dāng)前模板。不要把其他工具的配置直接復(fù)制到 Codex。

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

API key 應(yīng)該放哪里

API key 不建議直接寫進(jìn)文章、倉(cāng)庫(kù)或項(xiàng)目級(jí)配置。Codex 支持多種鑒權(quán)方式，選擇時(shí)要看你的場(chǎng)景。

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

常見報(bào)錯(cuò)怎么排查

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

常見問題

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

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

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

Q：模型名應(yīng)該怎么填？
模型名應(yīng)以 provider 后臺(tái)實(shí)際展示為準(zhǔn)。不要照搬舊文章里的模型 ID，也不要假設(shè) OpenAI 官方模型名一定能在第三方網(wǎng)關(guān)中使用。

Q：接入第三方模型會(huì)不會(huì)自動(dòng)省 token？
不會(huì)。第三方模型或 API 網(wǎng)關(guān)主要改變模型入口、計(jì)費(fèi)和可觀測(cè)性；真正減少 token 消耗仍要靠縮小任務(wù)范圍、限制文件、先讀后改、明確測(cè)試命令和減少反復(fù)試錯(cuò)。

參考資料與時(shí)效性

• OpenAI Codex manual，2026-07-03 抓取：Authentication、Config basics、Custom model providers、Codex app features、Codex app settings。
• api.fenno.ai/coding-plan 公開頁(yè)面，2026-07-03 抓?。喉?yè)面標(biāo)題顯示為 AI API Gateway，公開配置包含 api_base_url: "https://api.fenno.ai"。

Codex 配置字段、模型名稱、第三方 provider 模板和 API 網(wǎng)關(guān)路由都可能變化，正式接入前應(yīng)以 OpenAI 當(dāng)前文檔與 provider 后臺(tái)模板為準(zhǔn)。

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

最新評(píng)論