Codex 配置

1. OpenAI Codex CLI 介紹與系統要求

OpenAI Codex CLI 是 OpenAI 提供的本地編碼代理，可在終端中理解倉庫、修改代碼、執行命令，也可以與 VS Code、Cursor、Windsurf 等編輯器配合使用。

開始之前，請先準備以下環境：

可正常使用的終端環境
Node.js 16 及以上版本
RouteAPI 控制台創建的 API 密鑰
RouteAPI 控制台中可用的 OpenAI 協議模型

2. 安裝 OpenAI Codex CLI

全局安裝

npm install -g @openai/codex

如果你使用 Homebrew，也可以安裝：

brew install --cask codex

驗證安裝

codex --version

輸出版本號即表示安裝成功。

3. 配置 RouteAPI

Codex 的用戶級配置文件默認為 ~/.codex/config.toml。在 Windows 中，通常對應 %USERPROFILE%\.codex\config.toml。

3.1 配置 API 密鑰環境變量

如果你使用的是 macOS / Linux / WSL 中的 bash、zsh 或 sh：

export ROUTEAPI_KEY="你的 RouteAPI 密鑰"

如果你使用的是 Windows PowerShell：

$env:ROUTEAPI_KEY="你的 RouteAPI 密鑰"

3.2 寫入 `config.toml`

model = "你的模型名稱"
model_provider = "routeapi"

[model_providers.routeapi]
name = "RouteAPI"
base_url = "https://www.routeapi.ai/v1"
env_key = "ROUTEAPI_KEY"
wire_api = "responses"

上面這段配置中：

model：填寫 RouteAPI 控制台中可用的 OpenAI 協議模型名稱
model_provider：指定當前會話使用自定義的 routeapi provider
base_url：固定填寫 https://www.routeapi.ai/v1
env_key：表示 Codex 從 ROUTEAPI_KEY 環境變量讀取密鑰

3.3 啟動 Codex

codex

如果你希望默認以更穩妥的方式運行，也可以繼續在 config.toml 中補充下面兩項：

approval_policy = "on-request"
sandbox_mode = "workspace-write"

4. IDE 集成配置

完成上面的 config.toml 後，Codex 的 IDE 擴展通常可以直接複用同一套配置，因此不需要在編輯器裡重複填寫 RouteAPI 地址和密鑰。

VS Code / Cursor / Windsurf

安裝 Codex 官方 IDE 擴展
重啟編輯器
打開項目並啟動 Codex
如果擴展沒有立即讀取到新配置，重新打開工作區或重啟一次編輯器

JetBrains IDE

如果你在 IntelliJ IDEA、PyCharm、WebStorm、GoLand 等 JetBrains IDE 中使用 Codex，建議先完成上面的 CLI 配置，再按 IDE 內的 Codex 嚮導完成綁定。這樣終端和 IDE 會使用同一份 RouteAPI 配置，切換工具時也不需要重複設置。