在 Codex CLI 中接入

改 ~/.codex/config.toml，新增一個指向本平臺的 provider。

本文介紹如何把 Codex CLI 接到本平臺，用同一個令牌呼叫 Claude、GPT、Gemini 等模型。全程只需要三個值：接入地址、令牌、模型名。

開始之前請先在控制台建立一個令牌（sk- 開頭），並確認帳戶裡有餘額。還沒有令牌的話，先看 5 分鐘發出第一個請求。

配置

編輯 ~/.codex/config.toml，加一個自定義 provider 並把它設為預設；金鑰從環境變數讀，不要寫進配置檔案。

填哪裡	填什麼
base_url	`https://api.router.ai/v1`
env_key	`ROUTER_API_KEY`
model	`gpt-5.5`

model = "gpt-5.5"
model_provider = "router"

[model_providers.router]
name = "Router AI"
base_url = "https://api.router.ai/v1"
env_key = "ROUTER_API_KEY"
wire_api = "chat"

# 然後: export ROUTER_API_KEY=sk-你的令牌

驗證

配置完先別急著跑複雜任務。讓它回答一句「你好」，能正常回話就說明鏈路通了。想單獨確認令牌本身有沒有問題，可以在終端直接調一次介面：

curl https://api.router.ai/v1/chat/completions \
  -H "Authorization: Bearer sk-你的令牌" \
  -H "Content-Type: application/json" \
  -d '{"model":"gpt-5.5","messages":[{"role":"user","content":"你好"}]}'

返回 JSON 裡有 choices 就是正常的。之後在控制台的計費流水裡能看到這筆呼叫。

常見問題

wire_api 填 chat 或 responses 都能用，本平臺兩條協議都支援。遇到「不支援 tools + reasoning_effort」這類報錯時，優先試 responses。

報 401

令牌填錯、多了空格，或者複製時漏了開頭的 sk-。重新複製一次完整令牌。

報 404

九成是地址結尾對不上：OpenAI 相容格式要 /v1 結尾，Anthropic 和 Gemini 原生格式則不要帶 /v1。對照上面表格再核一次。

報 402 / 提示餘額不足

帳戶餘額不夠。見充值方式與到帳時間。

模型不存在

模型名必須和平臺目錄裡完全一致（大小寫、連字元都算）。在模型廣場頁可以直接複製準確的名字。

部落格