OpenAI Codex CLI 配置教程

通过 CERouter API 接入 Codex CLI，支持 GPT-4o、o 系列等模型。

前提条件

验证 Node.js

Codex CLI 基于 Node.js 运行，请先确认已安装（建议 LTS 版本）。

如果没有显示版本号，请参考 Node.js 安装教程进行安装。

安装 Codex CLI

Windows（PowerShell，无需 sudo）

npm install -g @openai/codex

macOS / Linux / WSL2

如果使用 nvm 管理 Node.js，可以不加 sudo。

验证安装：

创建配置文件

如果使用 CC Switch，可以跳转 CC Switch 配置。

Codex CLI 通过配置文件指定模型提供商和认证方式。

配置文件路径

系统	路径
Windows	`%USERPROFILE%\.codex\config.toml`
macOS / Linux	`~/.codex/config.toml`

创建目录

Windows

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex"

macOS / Linux / WSL2

写入配置文件

将以下内容写入 config.toml：

model_provider = "cerouter"
model = "gpt-4o"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.cerouter]
name     = "cerouter"
base_url = "https://cerouter.com/v1"
wire_api = "responses"
env_key  = "OPENAI_API_KEY"

⚠️ 注意： base_url 末尾不要加斜杠，否则可能导致路径拼接出现双斜杠。

配置 API Key

将 API Key 设置为环境变量，供 Codex CLI 读取。

Windows（PowerShell）

临时生效（仅当前终端会话有效）：

$env:OPENAI_API_KEY = "YOUR_API_KEY"

永久生效（推荐）：

[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", "User")

设置后需重新打开终端窗口。

macOS / Linux / WSL2

将以下内容追加到 ~/.bashrc 或 ~/.zshrc：

然后使配置立即生效：

验证配置

验证环境变量：

启动 Codex CLI：

常见问题

问题	解决方案
环境变量设置后不生效	重新打开一个终端窗口，或执行 `source ~/.bashrc`
Windows 安装时提示权限错误	以管理员身份运行 PowerShell 后重试
启动后提示找不到模型提供商	检查 `config.toml` 中 `base_url` 是否填写正确，路径末尾不要带多余的斜杠

Codex配置

OpenAI Codex CLI 配置教程#

目录#

前提条件#

验证 Node.js#

安装 Codex CLI#

Windows（PowerShell，无需 sudo）#

macOS / Linux / WSL2#

创建配置文件#

配置文件路径#

创建目录#

写入配置文件#

配置 API Key#

Windows（PowerShell）#

macOS / Linux / WSL2#

验证配置#

常见问题#

OpenAI Codex CLI 配置教程

目录

前提条件

验证 Node.js

安装 Codex CLI

Windows（PowerShell，无需 sudo）

macOS / Linux / WSL2

创建配置文件

配置文件路径

创建目录

写入配置文件

配置 API Key

Windows（PowerShell）

macOS / Linux / WSL2

验证配置

常见问题