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 配置，切换工具时也不需要重复设置。