Codex（安装与接入 SuperToken）
Codex 是 OpenAI 的终端编程代理，可以在本地仓库中进行代码阅读、修改、执行命令和审查。
这页负责接入
完成安装和网关配置后，继续阅读 Codex 中文使用手册；想直接看真实项目流程，可以进入 Codex 项目实战。
你需要准备
TIP
Codex 通过 OpenAI 兼容方式接入 SuperToken，地址使用 https://api.supertoken.cc/v1。
1. 安装 Codex
打开终端，运行：
bash
npm install -g @openai/codex验证安装：
bash
codex --version2. 配置 Codex（接入 SuperToken）
Codex 主要需要两部分配置：
OPENAI_API_KEY：你的 SuperToken API Key~/.codex/config.toml：指定 SuperToken 网关和默认模型
设置 API Key
将下面这段追加到 ~/.zshrc：
bash
{
echo ''
echo '# SuperToken for Codex'
echo 'export OPENAI_API_KEY="你的SuperToken API Key"'
} >> ~/.zshrc然后执行：
bash
source ~/.zshrc写入配置文件
bash
mkdir -p ~/.codex
cat > ~/.codex/config.toml <<'EOF'
model = "gpt-5.6"
model_provider = "supertoken"
[model_providers.supertoken]
name = "SuperToken"
base_url = "https://api.supertoken.cc/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"
EOF你必须将 你的SuperToken API Key 替换为真实 Key。默认模型写的是 gpt-5.6；OpenAI 当前将该别名指向 gpt-5.6-sol。接入 SuperToken 时仍要以模型广场实际显示的模型 ID 和分组权限为准。
3. 启动并验证
进入你的项目目录后，运行：
bash
codex能进入并对话只证明当前进程可用。关闭终端，重新打开后再启动 Codex，并在 SuperToken 控制台核对同一时间和模型的请求记录；同时确认 ~/.codex/config.toml 仍指向 SuperToken。遇到 401、403、404 或 429 时查看 统一错误决策表。