Codex 接入

快速接入

控制台提供一键快速接入功能，可自动生成或写入 Codex 配置：打开快速接入。

Codex 使用配置文件连接 OpenAI 兼容模型。下面示例会创建 ~/.codex/config.toml 和 ~/.codex/auth.json。

安装

npm install -g @openai/codex@latest
codex --version

配置文件

将 YOUR_API_KEY 替换为在 控制台 中复制的 API Key。模型 ID 可以使用 provider/model-id 格式，也可以使用纯 model-id 格式，例如 openai/gpt-5.5 或 gpt-5.5。

macOS / Linux

rm -rf ~/.codex && mkdir -p ~/.codex

cat > ~/.codex/config.toml << 'EOF'
model_provider = "codyrouter"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.codyrouter]
name = "codyrouter"
base_url = "https://api.codyrouter.com"
wire_api = "responses"
requires_openai_auth = true
EOF

cat > ~/.codex/auth.json << 'EOF'
{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}
EOF

Windows PowerShell

if (Test-Path "$env:USERPROFILE\.codex") {
  Remove-Item -Recurse -Force "$env:USERPROFILE\.codex"
}
mkdir "$env:USERPROFILE\.codex"

@"
model_provider = "codyrouter"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"

[model_providers.codyrouter]
name = "codyrouter"
base_url = "https://api.codyrouter.com"
wire_api = "responses"
requires_openai_auth = true
"@ | Out-File -FilePath "$env:USERPROFILE\.codex\config.toml" -Encoding utf8

@"
{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}
"@ | Out-File -FilePath "$env:USERPROFILE\.codex\auth.json" -Encoding utf8

启动

进入项目目录后运行：

codex

如果模型不可用，先确认模型名称、API Key 和 Base URL 是否正确。可参考 模型名称列表。