Big Router × Codex 快速开始指南
前置条件：安装 Node.js 环境
Codex 依赖 Node.js 运行环境，请先参考 Node.js 环境安装指南 完成安装并验证。
更省事的方式：自动配置
如果你不想手动安装和逐项写配置，推荐直接使用 自动配置工具。
macOS / Linux：
curl -fsSL https://big-router.example.com/auto-config/install.sh | bash -s -- --tools codex
Windows PowerShell：
irm https://big-router.example.com/auto-config/install.ps1 | iex --% --tools codex
1. 安装 Codex
# Windows
npm install -g @openai/codex@latest
# macOS / Linux
sudo npm install -g @openai/codex@latest
验证安装：
codex --version
输出版本号即表示安装成功。
2. 创建 API Key
登录 Big Router 控制台，进入 API 密钥 页面，点击 创建密钥。
填写密钥名称，选择Codex分组（模型和倍率），按需配置 IP 限制、额度限制、速率限制和有效期。新手建议直接使用默认配置。
安全提示：API Key 等同于账号凭证，请妥善保管，切勿提交到代码仓库或公开分享。
3. 导入密钥到 Codex
推荐使用 CC Switch 工具进行一键配置，也可手动创建配置文件。
方式一：CC Switch（推荐）
前往 CC Switch Release 下载安装后，点击 导入到 CCS 完成一键导入：
导入后点击 启用 即可。
方式二：手动配置文件
创建配置目录
# Windows (PowerShell)
if (Test-Path "$env:USERPROFILE\.codex") { Remove-Item -Recurse -Force "$env:USERPROFILE\.codex" }mkdir "$env:USERPROFILE\.codex"
# macOS / Linux
rm -rf ~/.codex && mkdir -p ~/.codex
创建 config.toml
在 ~/.codex/（Windows 为 %USERPROFILE%\.codex\）目录下创建 config.toml：
model_provider = "big-router"
model = "gpt-5.3-codex"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.big-router]
name = "big-router"
base_url = "https://big-router.example.com"
wire_api = "responses"
requires_openai_auth = true
创建 auth.json
点击密钥旁的 复制 按钮获取 API Key：
在同一目录下创建 auth.json，将 YOUR_API_KEY 替换为你在控制台创建的密钥：
{"OPENAI_API_KEY": "YOUR_API_KEY"
}
4. 开始使用
进入任意项目目录，运行：
codex
Codex 会自动分析当前目录的代码并提供智能编程辅助。更多用法请参考 OpenAI 官方文档。