現(xiàn)在很多開發(fā)者已經(jīng)不滿足于“和 AI 聊代碼”了，而是希望 AI 能直接進(jìn)入項(xiàng)目目錄，讀文件、改代碼、跑命令、解釋報(bào)錯(cuò)。Codex CLI 就是這類工具：它運(yùn)行在終端里，可以理解你的項(xiàng)目結(jié)構(gòu)，并在你的確認(rèn)下完成真實(shí)開發(fā)任務(wù)。

這篇文章面向已經(jīng)拿到第三方 API 配置的用戶。你手里通常會(huì)有三樣?xùn)|西：Base URL、API Key、模型名。把這三項(xiàng)正確填進(jìn) Codex 后，Codex 就可以通過中轉(zhuǎn)站調(diào)用對應(yīng)的 OpenAI 模型。

本文以 147AI的API 接口文檔 的接入流程為例說明：先在控制臺充值、創(chuàng)建令牌、選擇模型分組，再把 API 地址、密鑰和模型名填入 Codex 配置。具體模型端點(diǎn)、可用模型和計(jì)費(fèi)規(guī)則，請以模型廣場展示為準(zhǔn)。

開始前先確認(rèn)一件事

Codex 和普通聊天客戶端不完全一樣。Chatbox、Cherry Studio 這類客戶端常見的是 OpenAI Chat Completions 接口，也就是 /v1/chat/completions；而 Codex 當(dāng)前更適合走 OpenAI Responses API，也就是 /v1/responses 這一類接口。

所以在配置前先確認(rèn)：

• 中轉(zhuǎn)站是否支持 Codex 所需的 OpenAI Responses API
• 你選的模型是否支持 Codex / Responses API 調(diào)用
• 令牌分組是否支持這個(gè)模型
• Base URL 是否是 OpenAI 兼容地址，例如 https://147ai.com/v1

如果一個(gè)網(wǎng)關(guān)只支持普通聊天接口 /v1/chat/completions，它不一定能直接跑通 Codex。模型名和 Key 都正確，也可能因?yàn)榻涌趨f(xié)議不匹配而失敗。

安裝前準(zhǔn)備

在安裝 Codex CLI 前，先準(zhǔn)備好這些內(nèi)容：

• Node.js 和 npm，建議使用當(dāng)前 LTS 版本
• 穩(wěn)定網(wǎng)絡(luò)連接
• 第三方 API 賬戶余額大于 0
• 控制臺生成的 API Key
• 模型廣場復(fù)制的完整模型名
• 平臺提供的 Base URL，例如 https://147ai.com/v1

Windows 用戶額外注意：Codex 可以在 PowerShell 里運(yùn)行；如果遇到路徑、權(quán)限、腳本或依賴問題，也可以使用 WSL2。

安裝 Codex CLI

Windows

1. 安裝 Node.js，建議選擇當(dāng)前 LTS 版本。
2. 打開 PowerShell。
3. 執(zhí)行安裝命令：

npm i -g @openai/codex

安裝完成后驗(yàn)證：

codex --version

如果能看到版本號，說明命令已經(jīng)可用。

macOS

macOS 可以用 npm 安裝：

npm i -g @openai/codex
codex --version

如果你習(xí)慣 Homebrew，也可以按 Codex 官方頁面里的 Homebrew 方式安裝。安裝后同樣用下面命令驗(yàn)證：

codex --version

Linux

Linux 先安裝 Node.js 和 npm，不同發(fā)行版命令略有差異。準(zhǔn)備好后執(zhí)行：

npm i -g @openai/codex
codex --version

如果安裝時(shí)報(bào)權(quán)限錯(cuò)誤，再考慮使用 sudo 或調(diào)整 npm 全局安裝目錄。

配置思路

Codex 的配置文件通常在用戶目錄下：

~/.codex/config.toml

Windows 下通常是：

C:\Users\你的用戶名\.codex\config.toml

登錄憑據(jù)會(huì)緩存在本機(jī)。根據(jù)你的配置和系統(tǒng)環(huán)境，可能存到：

~/.codex/auth.json

也可能存到系統(tǒng)鑰匙串或憑據(jù)管理器里。新手不需要先理解所有細(xì)節(jié)，只要記?。?code>config.toml 放模型和 Base URL，API Key 用登錄命令或環(huán)境變量提供。

方案一：使用內(nèi)置 OpenAI Provider

這是最適合普通用戶的寫法。中轉(zhuǎn)站提供 OpenAI 兼容入口時(shí)，可以繼續(xù)使用 Codex 內(nèi)置的 openai provider，只把 Base URL 改成中轉(zhuǎn)站地址。

第一步：創(chuàng)建配置目錄

macOS / Linux：

mkdir -p ~/.codex

Windows 可以手動(dòng)進(jìn)入用戶目錄，新建 .codex 文件夾。如果看不到 .codex，記得在資源管理器里打開“顯示隱藏的項(xiàng)目”。

第二步：寫入模型和 Base URL

打開 ~/.codex/config.toml，寫入：

model = "從模型廣場復(fù)制的模型名"
model_provider = "openai"
openai_base_url = "https://147ai.com/v1"

這里最容易錯(cuò)的是三項(xiàng)：

• model：不要手打，去模型廣場復(fù)制完整模型名。
• model_provider：這里保持 openai，表示使用 Codex 內(nèi)置 OpenAI provider。
• openai_base_url：填中轉(zhuǎn)站提供的 Base URL，通常到 /v1 為止。

不要把完整接口路徑寫進(jìn) openai_base_url。也就是說，不要寫成：

https://147ai.com/v1/chat/completions
https://147ai.com/v1/responses

Codex 要的是 Base URL，它會(huì)根據(jù)自己的協(xié)議去拼接具體路徑。

第三步：寫入 API Key

推薦用 Codex 登錄命令緩存 API Key。macOS / Linux：

export OPENAI_API_KEY="替換成平臺生成的完整 API Key"
printenv OPENAI_API_KEY | codex login --with-api-key

Windows PowerShell：

$env:OPENAI_API_KEY="替換成平臺生成的完整 API Key"
$env:OPENAI_API_KEY | codex login --with-api-key

這里的 Key 來自控制臺「密鑰管理」。不要改大小寫，不要手動(dòng)補(bǔ)前綴，不要只復(fù)制前幾位。

如果你明確想讓 Codex 把憑據(jù)存到 auth.json，可以在 config.toml 里加：

cli_auth_credentials_store = "file"

然后重新執(zhí)行登錄命令。auth.json 里包含密鑰或登錄憑據(jù)，不要提交到 Git 倉庫，也不要發(fā)到群聊或工單里。

第四步：驗(yàn)證登錄和配置

先看登錄狀態(tài)：

codex login status

再進(jìn)入一個(gè)項(xiàng)目目錄：

cd your-project-folder
codex "請只回復(fù) OK"

如果能正常返回，再做一個(gè)只讀測試：

codex "先閱讀這個(gè)項(xiàng)目結(jié)構(gòu)，不要修改文件，只告訴我主要目錄分別做什么"

方案二：使用自定義 Provider

如果你不想把中轉(zhuǎn)站 Key 放進(jìn) Codex 的 OpenAI 登錄緩存，或者你需要同時(shí)配置多個(gè)網(wǎng)關(guān)，可以使用自定義 provider。

先設(shè)置環(huán)境變量。macOS / Linux：

export CODEX_PROXY_API_KEY="替換成平臺生成的完整 API Key"

Windows PowerShell：

$env:CODEX_PROXY_API_KEY="替換成平臺生成的完整 API Key"

然后在 ~/.codex/config.toml 里寫：

model = "從模型廣場復(fù)制的模型名"
model_provider = "third_party"

[model_providers.third_party]
name = "Third Party API"
base_url = "https://147ai.com/v1"
env_key = "CODEX_PROXY_API_KEY"
wire_api = "responses"

這幾個(gè)字段分別表示：

• model_provider = "third_party"：告訴 Codex 使用下面定義的 provider。
• [model_providers.third_party]：provider 的具體配置，名字要和上面一致。
• base_url：中轉(zhuǎn)站提供的 Base URL，通常到 /v1。
• env_key：從哪個(gè)環(huán)境變量讀取 API Key。
• wire_api = "responses"：Codex 使用 Responses 協(xié)議。

如果你只是配置一個(gè)中轉(zhuǎn)站，新手優(yōu)先用方案一。方案二更適合多網(wǎng)關(guān)、多 Key 或團(tuán)隊(duì)腳本場景。

啟動(dòng)與基本使用

進(jìn)入你的項(xiàng)目目錄：

cd your-project-folder
codex

也可以在命令后直接跟一個(gè)初始任務(wù)：

codex "先閱讀這個(gè)項(xiàng)目結(jié)構(gòu)，告訴我主要目錄分別做什么"

第一次使用時(shí)，不建議馬上讓 Codex 大范圍改代碼。更穩(wěn)的方式是先讓它只讀項(xiàng)目、輸出計(jì)劃，再?zèng)Q定是否讓它動(dòng)手。

推薦的使用習(xí)慣

先讀項(xiàng)目，再改代碼

可以這樣問：

先掃描項(xiàng)目結(jié)構(gòu)，列出你會(huì)讀取哪些文件、準(zhǔn)備修改哪些文件，等我確認(rèn)后再動(dòng)手。

這樣你能先看到它的判斷，避免它一上來就改錯(cuò)方向。

一次只交給它一件事

不要一條指令里同時(shí)讓它“重構(gòu)登錄、修復(fù)支付、順便優(yōu)化頁面”。更合適的做法是：

• 修一個(gè)明確 bug
• 加一個(gè)小功能
• 解釋一段代碼
• 寫一組測試

任務(wù)越清楚，結(jié)果越容易驗(yàn)收。

用 Git 做檢查點(diǎn)

Codex 會(huì)改文件，所以每次開始前最好先確認(rèn)工作區(qū)狀態(tài)：

git status

重要任務(wù)前可以先提交一次，或至少保證你知道哪些文件已經(jīng)被修改。這樣就算結(jié)果不理想，也能回滾。

VS Code 里怎么用 Codex

如果你使用 VS Code、Cursor 或 Windsurf，可以安裝 Codex IDE 擴(kuò)展。一般流程是：

1. 先在終端里完成 Codex CLI 配置。
2. 安裝 Codex IDE 擴(kuò)展。
3. 打開項(xiàng)目目錄。
4. 從側(cè)邊欄啟動(dòng) Codex。

如果側(cè)邊欄里無法正常問答，先回到終端執(zhí)行：

codex "請只回復(fù) OK"

終端能跑通，說明 API、Base URL 和模型配置大概率沒問題；插件側(cè)再排查登錄狀態(tài)、權(quán)限或擴(kuò)展版本。

常見問題與排查

Q1：codex: command not found

通常是 npm 全局安裝路徑?jīng)]有加入 PATH，或安裝失敗。先運(yùn)行：

codex --version

如果仍找不到，重新安裝：

npm i -g @openai/codex

Q2：安裝時(shí)報(bào)權(quán)限錯(cuò)誤

macOS / Linux 可以臨時(shí)使用：

sudo npm i -g @openai/codex

更長期的做法是把 npm 全局目錄改到用戶目錄，但這屬于 Node.js 環(huán)境配置，不是 Codex 專屬問題。

Q3：配置了 Key 但仍提示未認(rèn)證或 401

按順序檢查：

1. API Key 是否復(fù)制完整。
2. Key 是否仍然有效。
3. 賬戶余額是否大于 0。
4. 令牌分組是否支持當(dāng)前模型。
5. 方案一是否已經(jīng)執(zhí)行 codex login --with-api-key。
6. 方案二的環(huán)境變量名是否和 env_key 完全一致。

Q4：404、接口不存在或請求路徑錯(cuò)誤

重點(diǎn)看 Base URL 和接口協(xié)議：

• openai_base_url / base_url 通常填到 https://147ai.com/v1
• 不要填 /v1/chat/completions
• 不要填 /v1/responses
• 確認(rèn)中轉(zhuǎn)站支持 Responses API

如果中轉(zhuǎn)站只支持 Chat Completions，普通聊天客戶端可能能用，但 Codex 不一定能用。

Q5：報(bào)model not found

這通常不是 Codex 本身壞了，而是模型名不匹配。去模型廣場復(fù)制完整模型名，不要用自己猜的簡稱。

同時(shí)確認(rèn)你的令牌分組支持該模型。不同分組對應(yīng)的資源渠道、穩(wěn)定性、質(zhì)量和價(jià)格可能不同。

Q6：config.toml寫了但沒有生效

常見原因有四個(gè)：

• 文件不在 ~/.codex/config.toml
• TOML 格式寫錯(cuò)
• 修改后沒有重新打開終端
• 自定義 provider 的名字不一致

如果用了自定義 provider，要確認(rèn)：

model_provider = "third_party"

和：

[model_providers.third_party]

這兩個(gè)名字必須一致。

Q7：一直超時(shí)或返回很慢

可能原因包括：

• 當(dāng)前模型本身較慢
• 分組資源繁忙
• 網(wǎng)絡(luò)代理不穩(wěn)定
• 上下文太長
• 中轉(zhuǎn)站對流式響應(yīng)或 Responses API 支持不完整

先用 請只回復(fù) OK 這種短請求測試。如果短請求都慢，再考慮換模型、換分組或檢查網(wǎng)絡(luò)。

Q8：怎么升級 Codex CLI？

執(zhí)行：

npm i -g @openai/codex@latest

升級后再運(yùn)行：

codex --version

總結(jié)

Codex 通過中轉(zhuǎn)站調(diào)用 OpenAI 模型，本質(zhì)上還是三件事：Base URL 指向中轉(zhuǎn)站，API Key 用來鑒權(quán)，模型名決定實(shí)際調(diào)用哪個(gè)模型。

和普通聊天客戶端相比，Codex 更需要注意接口協(xié)議。配置時(shí)不要只看有沒有 /v1/chat/completions，還要確認(rèn)中轉(zhuǎn)站是否支持 Codex 所需的 Responses API。新手優(yōu)先使用內(nèi)置 openai provider 加 openai_base_url 的方案；需要多網(wǎng)關(guān)或獨(dú)立環(huán)境變量時(shí)，再使用自定義 provider。

以上就是2026最新Codex配置第三方API的實(shí)戰(zhàn)教程的詳細(xì)內(nèi)容，更多關(guān)于Codex配置第三方API的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論