Codex 接 OpenAI 兼容中轉站 Base URL 配置教程

安裝和啟動

Codex CLI 是 OpenAI 的本地編程代理,官方安裝方式是:

npm i -g @openai/codex
codex

第一次運行時,Codex 會讓你登錄 ChatGPT 賬號或使用 API Key。用中轉站時,通常走 API Key 和 OpenAI 兼容接口。

先確認服務商支持什麼

Codex 不是普通聊天殼。它會讀代碼、改文件、跑命令,所以中轉站最好明確支持 OpenAI Responses API 或 Codex 可用的 OpenAI 兼容接口。

你需要向服務商確認:

• Base URL 是不是 OpenAI 兼容地址
• 是否支持 Responses API
• 模型名應該填什麼
• 是否支持流式輸出和工具調用
• 是否有特殊 Header 或 query 參數

如果你還沒選好服務商，可以先看 Codex 中轉服務對比。想擴大到所有 OpenAI 兼容接口，再看 OpenAI API 中轉服務商 對比頁。對價格敏感的配置，也可以參考 便宜 OpenAI API 服務商，或直接瀏覽完整的 AI API 服務商目錄。

配置方式

臨時測試時,可以優先用環境變量:

export OPENAI_API_KEY="你的中轉站 API Key"
export OPENAI_BASE_URL="https://你的中轉站地址/v1"
codex

長期使用時,再考慮寫進 ~/.codex/config.toml,用不同 profile 區分官方 OpenAI、中轉站、本地模型或團隊網關。

排障順序

1. 先確認 codex --version 是最新版。
2. 再確認 OPENAI_API_KEY 和 OPENAI_BASE_URL 當前終端確實生效。
3. 讓服務商確認 Codex 需要的接口類型,不要只問“支不支持 OpenAI 格式”。
4. 如果你用了 config.toml,先回到環境變量臨時配置排查,減少變量。

Codex 版本變化比較快,配置項也會繼續演進。寫教程時最好把“可驗證的最小配置”和“高級 profile 配置”分開,避免讀者照抄一段複雜 TOML 後不知道錯在哪裡。