国内开发者如何一键配置 OpenAI Codex CLI？Windows/macOS/Linux 全流程

适合：想在终端里使用 Codex CLI、但卡在 API Key / Base URL / 环境变量配置的开发者。

很多人安装 OpenAI Codex CLI 后，第一步不是卡在模型能力，而是卡在配置：

• API Key 应该填哪里？
• Base URL 为什么一定要带 /v1？
• Windows 用 setx 之后为什么还不生效？
• wire_api = "chat" is no longer supported 怎么办？
• 能不能用 OpenAI-compatible API 接 Codex CLI？

这篇直接给一个可用方案：用脚本把 Codex CLI 配到 Crazyrouter 的 OpenAI-compatible endpoint。

GitHub 仓库：

https://github.com/xujfcn/crazyrouter-codex-cli

---

1. Codex CLI 是什么？

Codex CLI 是一个可以在终端里辅助你读代码、解释项目、修改文件、执行开发任务的 AI coding 工具。

它适合：

• 在项目目录里快速理解代码结构；
• 让 AI 帮你改小功能；
• 生成测试；
• 排查报错；
• 做代码审查前的初步分析。

如果你已经习惯命令行开发，Codex CLI 会比网页聊天更贴近开发流。

---

2. 为什么很多人配置失败？

常见坑主要有 5 个。

坑 1：Base URL 少了 /v1

错误：

https://cn.crazyrouter.com

正确：

https://cn.crazyrouter.com/v1

OpenAI-compatible SDK 通常需要 /v1。

坑 2：API Key 和 Base URL 不是同一个平台

如果你使用 Crazyrouter 的 Base URL，就要使用 Crazyrouter 控制台里的 API Key。

坑 3：Windows 环境变量设置后没重开终端

PowerShell 里用 setx 后，需要关闭当前终端，重新打开。

坑 4：Codex 新版本不支持旧 wire_api

如果你看到：

wire_api = "chat" is no longer supported

把配置改成：

wire_api = "responses"

坑 5：把 UTM 参数加到了 API endpoint

网页链接可以加 UTM，但 API endpoint 不行。

错误：

export OPENAI_BASE_URL=https://cn.crazyrouter.com/v1?utm_source=csdn

正确：

export OPENAI_BASE_URL=https://cn.crazyrouter.com/v1

---

3. 一键安装方式

Windows

用普通用户身份打开 PowerShell，运行：

iwr -UseB https://raw.githubusercontent.com/xujfcn/crazyrouter-codex-cli/main/install-crazyrouter-codex.ps1 | iex

或者下载后双击：

install-crazyrouter-codex.bat

macOS / Linux

curl -fsSL https://raw.githubusercontent.com/xujfcn/crazyrouter-codex-cli/main/install-crazyrouter-codex.sh | bash

脚本会自动：

• 询问你的 Crazyrouter API Key；
• 写入环境变量；
• 配置 Codex CLI 使用 https://cn.crazyrouter.com/v1；
• 备份已有 Codex 配置；
• 使用新版 Codex 推荐的 wire_api = "responses"。

---

4. 手动配置方式

如果你不想跑脚本，也可以手动配置。

4.1 安装 Codex CLI

npm install -g @openai/codex

建议 Node.js 22+。

如果你用 nvm：

nvm install 22
nvm use 22

4.2 设置环境变量

macOS / Linux：

export OPENAI_API_KEY=sk-your-crazyrouter-key
export OPENAI_BASE_URL=https://cn.crazyrouter.com/v1

Windows PowerShell：

setx OPENAI_API_KEY "sk-your-crazyrouter-key"
setx OPENAI_BASE_URL "https://cn.crazyrouter.com/v1"

Windows 设置后重开终端。

4.3 启动 Codex

codex

或者指定模型：

codex --model gpt-5.5

---

5. config.toml 配置方式

部分 Codex CLI 版本支持配置文件。

路径：

• Windows：%USERPROFILE%\.codex\config.toml
• macOS / Linux：~/.codex/config.toml

示例：

model = "gpt-5.5"
model_provider = "crazyrouter"

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

[model_providers.crazyrouter.query_params]

重点是这几行：

base_url = "https://cn.crazyrouter.com/v1"
env_key = "OPENAI_API_KEY"
wire_api = "responses"

---

6. 常用模型示例

codex                              # 使用默认模型
codex --model gpt-5.5              # 推荐默认模型
codex --model gpt-4o-mini          # 低成本模型
codex --model claude-sonnet-4-6    # Claude 路线，取决于账户/模型可用性

模型可用性会随账户、供应商线路、模型状态变化。

建议先看模型列表：

https://crazyrouter.com/models?utm_source=csdn&utm_medium=article&utm_campaign=dev_community

---

7. 常见错误排查

7.1 Codex 找不到命令

npm list -g @openai/codex

如果没装：

npm install -g @openai/codex

7.2 API Key 不生效

macOS / Linux：

echo $OPENAI_API_KEY
echo $OPENAI_BASE_URL

Windows PowerShell：

echo $env:OPENAI_API_KEY
echo $env:OPENAI_BASE_URL

确认：

• API Key 是 Crazyrouter 控制台里的 key；
• Base URL 包含 /v1；
• 终端已经重启；
• 账户余额充足。

7.3 500 / 502 / 524 错误

这类错误通常和线路波动、上游模型、超时、长上下文有关。

建议：

1. 重试一次；
2. 换一个相近模型；
3. 缩短 prompt；
4. 检查 Base URL；
5. 如果持续出现，把模型名、错误码、请求时间发给支持。

参考：

https://crazyrouter.com/blog/how-to-fix-ai-api-500-502-524-errors?utm_source=csdn&utm_medium=article&utm_campaign=dev_community

---

8. 相关链接

• GitHub 脚本：
  https://github.com/xujfcn/crazyrouter-codex-cli

• Crazyrouter：
  https://crazyrouter.com?utm_source=csdn&utm_medium=article&utm_campaign=dev_community

• 模型列表：
  https://crazyrouter.com/models?utm_source=csdn&utm_medium=article&utm_campaign=dev_community

• Base URL 详解：
  https://crazyrouter.com/blog/openai-compatible-api-base-url-explained?utm_source=csdn&utm_medium=article&utm_campaign=dev_community

---

总结

Codex CLI 配置 OpenAI-compatible API，核心就是三件事：

1. API Key 用对；
2. Base URL 带 /v1；
3. Codex config 里使用 wire_api = "responses"。

如果你想省事，直接用这个仓库的一键脚本：

https://github.com/xujfcn/crazyrouter-codex-cli