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 是否正確。可參考 模型名稱列表。