本文檔用于說明如何把 ApexAPI 網(wǎng)頁端提供的 Codex CLI 配置同步到本機 Codex App / Codex CLI，讓 App 注入和網(wǎng)頁端配置保持一致。

重點：需要修改 Codex 配置目錄下的兩個文件：config.toml 和 auth.json。

配置截圖

上圖對應(yīng) ApexAPI 網(wǎng)頁端的 Codex CLI 配置頁。Markdown 中已引用圖片文件 apexapi-codex-cli-config.png，建議和本文檔放在同一目錄。

文件路徑

macOS / Linux：

~/.codex/config.toml
~/.codex/auth.json

Windows：

%USERPROFILE%\.codex\config.toml
%USERPROFILE%\.codex\auth.json

其中 %USERPROFILE% 會自動指向當(dāng)前登錄用戶的用戶目錄。

例如本文檔所在電腦的 Windows 用戶名是 hh，所以當(dāng)前這臺機器對應(yīng)路徑是：

C:\Users\hh\.codex\config.toml
C:\Users\hh\.codex\auth.json

如果你的 Windows 用戶名不是 hh，不要照抄 C:\Users\hh，需要改成自己本機的用戶名。例如用戶名是 zhangsan，路徑就是：

C:\Users\zhangsan\.codex\config.toml
C:\Users\zhangsan\.codex\auth.json

第一步：修改 config.toml

打開：

C:\Users\hh\.codex\config.toml

把下面這段配置放到 config.toml 文件開頭，保持和 ApexAPI 網(wǎng)頁端一致：

model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://apexapi.roixw.com"
wire_api = "responses"
requires_openai_auth = true

關(guān)鍵要求

model_provider 必須和下面的 provider 表名一致：

model_provider = "OpenAI"
[model_providers.OpenAI]
name = "OpenAI"

不要寫成下面這種前后不一致的形式：

model_provider = "OpenAI"
[model_providers.apexapi]
name = "apexapi"

也不要寫成：

model_provider = "apexapi"
[model_providers.OpenAI]
name = "OpenAI"

如果 provider 名稱不一致，Codex App 可能找不到正確的 provider，表現(xiàn)出來就像模型、接口或 key 對不上。

第二步：修改 auth.json

打開：

C:\Users\hh\.codex\auth.json

寫入下面格式：

{
  "OPENAI_API_KEY": "sk-替換成你的ApexAPI-Key"
}

注意事項：

• OPENAI_API_KEY 這個字段名不要改。
• key 只填寫 ApexAPI 后臺提供的 sk-...，不要加 Bearer 前綴。
• JSON 里只能使用英文雙引號。
• JSON 最后一項后面不要加逗號。
• 不要把真實 key 發(fā)給別人，也不要提交到 Git 倉庫。

為什么 ApexAPI 也使用 OPENAI_API_KEY

雖然實際請求地址是 ApexAPI：

base_url = "https://apexapi.域名.com"

但配置中有：

requires_openai_auth = true

這表示 Codex 會按 OpenAI 兼容方式讀取認證信息，也就是從 auth.json 里的 OPENAI_API_KEY 取 key，然后請求 ApexAPI 的兼容接口。

所以這里不是填寫 APEXAPI_KEY，也不是填寫 API_KEY，而是固定使用：

"OPENAI_API_KEY": "sk-..."

App 注入時的檢查順序

配置完成后，建議按下面順序檢查：

1. 確認 config.toml 開頭存在 ApexAPI 網(wǎng)頁端給出的配置。
2. 確認 model_provider 和 [model_providers.OpenAI] 名稱完全一致。
3. 確認 base_url 是 https://apexapi.roixw.com。
4. 確認 wire_api 是 responses。
5. 確認 auth.json 中只有正確的 OPENAI_API_KEY。
6. 重啟 Codex App，讓 App 重新讀取配置文件。

常見問題

1. 為什么提示 key 對不上

常見原因如下：

• auth.json 里的 key 不是 ApexAPI 后臺生成的 key。
• key 前面多寫了 Bearer 。
• auth.json 不是合法 JSON，例如用了中文引號或多了尾逗號。
• config.toml 里的 model_provider 和 [model_providers.xxx] 名稱不一致。
• 本機有多個 Codex 配置目錄，App 讀取的不是你剛修改的那個目錄。
• ApexAPI 網(wǎng)頁端配置已經(jīng)更新，但本機文件還是舊配置。
• ApexAPI 后臺 key 已失效、余額不足、權(quán)限不足或模型未開通。

2. 為什么用 OpenAI 這個名字

ApexAPI 提供的是 OpenAI 兼容接口。網(wǎng)頁端示例使用：

model_provider = "OpenAI"
[model_providers.OpenAI]
name = "OpenAI"

為了和網(wǎng)頁端保持一致，建議本機也直接使用 OpenAI 這個 provider 名。這樣 App 注入、CLI 配置和網(wǎng)頁端示例最不容易出現(xiàn)差異。

3. 能不能把 provider 名改成 apexapi

可以，但必須全局一致。例如：

model_provider = "apexapi"
[model_providers.apexapi]
name = "apexapi"
base_url = "https://apexapi.roixw.com"
wire_api = "responses"
requires_openai_auth = true

不過如果目標(biāo)是“跟網(wǎng)頁端保持一致”，建議不要改名，直接使用網(wǎng)頁端給出的 OpenAI。

4. 503 Service Unavailable 是不是 key 錯

不一定。

503 Service Unavailable 通常表示 ApexAPI 服務(wù)端、上游模型接口或中轉(zhuǎn)服務(wù)臨時不可用。key 錯誤更常見的是 401 Unauthorized、403 Forbidden 或帶有認證失敗信息的錯誤。

如果配置確認無誤但仍然出現(xiàn) 503，可以等待幾分鐘后重試，或者把報錯里的 request id、cf-ray 發(fā)給 ApexAPI 服務(wù)方排查。

最終推薦配置

config.toml 推薦保持：

model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://apexapi.roixw.com"
wire_api = "responses"
requires_openai_auth = true

auth.json 推薦保持：

{
  "OPENAI_API_KEY": "sk-替換成你的ApexAPI-Key"
}

修改完成后重啟 Codex App，再重新發(fā)起一次請求驗證。

到此這篇關(guān)于codexAPP的key注入使用的方法步驟的文章就介紹到這了,更多相關(guān)codexAPP的key注入使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論