OpenAI Codex 设置

本指南介绍如何配置 OpenAI Codex CLI 使用 TopRouter 作为 API 代理。

前置条件

• 已安装 OpenAI Codex CLI
• 已注册 TopRouter 账号并获取 API Key
• 已完成 充值

配置步骤

设置环境变量

OpenAI Codex 使用标准的 OpenAI 环境变量。将 OPENAI_BASE_URL 指向 TopRouter 即可：

export OPENAI_BASE_URL="https://toprouter.cc"
export OPENAI_API_KEY="your-api-key"

💡 持久化配置

添加到 Shell 配置文件中：

Zsh 用户：

echo 'export OPENAI_BASE_URL="https://toprouter.cc"' >> ~/.zshrc
echo 'export OPENAI_API_KEY="your-api-key"' >> ~/.zshrc
source ~/.zshrc

Bash 用户：

echo 'export OPENAI_BASE_URL="https://toprouter.cc"' >> ~/.bashrc
echo 'export OPENAI_API_KEY="your-api-key"' >> ~/.bashrc
source ~/.bashrc

启动 Codex

配置完成后，正常启动 Codex 即可：

codex

Codex 将自动使用 TopRouter API 进行模型调用。

可用模型

通过 TopRouter，您可以在 Codex 中使用多种模型：

模型	模型 ID	推荐场景
GPT-5.5	gpt-5.5	通用编程辅助
GPT-5.5 Thinking	gpt-4.1	最新编程能力
openai/o3	openai/o3	复杂推理任务
GPT-5.4 Thinking	openai/gpt-5.4-thinking	轻量级推理
Claude 4.6 Sonnet	anthropic/claude-4.6-sonnet	代码理解与生成

验证配置

运行以下命令确认环境变量已设置：

echo $OPENAI_BASE_URL
# 应输出：https://toprouter.cc

echo $OPENAI_API_KEY
# 应输出您的 API Key

常见问题

Codex 无法连接？

1. 确认 OPENAI_BASE_URL 设置为 https://toprouter.cc（不带 /v1）
2. 确认 API Key 正确
3. 检查网络连接

如何切换模型？

在 Codex 中使用模型切换命令或配置文件指定所需模型。

与直接使用 OpenAI 有什么区别？

通过 TopRouter 使用 Codex，功能完全一致，同时还可以访问 Claude、Gemini 等非 OpenAI 模型。

📖 相关文档

• Claude Code 接入 — 配置 Claude Code CLI
• Cursor / Windsurf 配置 — IDE 插件配置
• API 密钥 — API Key 管理