整合指南
Codex CLI
在 config.toml 裡新增自訂 model provider,讓 OpenAI 的 Codex CLI 指向 Linkex。
Codex CLI 只支援 OpenAI Responses API,而且無法直接覆寫內建 openai provider 的 base URL——因此要在 ~/.codex/config.toml 裡把 Linkex 加為一個獨立的自訂 provider。
前置條件: 已安裝 Codex CLI;一把 Linkex API Key。
配置
編輯 ~/.codex/config.toml(使用者層級設定檔——專案層級的 .codex/config.toml 不允許設定 provider):
model_provider = "linkex"
model = "gpt-5.1-codex"
[model_providers.linkex]
name = "Linkex"
base_url = "https://linkex.ai/v1"
env_key = "LINKEX_API_KEY"
wire_api = "responses"然後在啟動 Codex 的 shell 裡 export 這把 Key:
export LINKEX_API_KEY="sk-YOUR_LINKEX_KEY"wire_api = "responses" 是必填的——Codex 已不再支援舊版 Chat Completions 協議,而 Linkex 的 /v1/responses 端點原生支援 Responses API,不需要額外的轉換層。
選擇模型
從 linkex.ai/pricing 選一個 OpenAI 系列的模型 id——Codex 的工具呼叫行為是針對這個系列調校的。要切換模型,修改 config.toml 裡最上層的 model 值即可。
首次運行
codex
# 隨便問點什麼;到 控制台 → Usage Logs 確認用量已記錄排錯
| 症狀 | 處理 |
|---|---|
| 401 Unauthorized | 啟動 codex 的 shell 沒有 export LINKEX_API_KEY,或該 Key 已停用 |
啟動時報 wire_api 錯誤 | wire_api 缺漏或填錯——必須是 "responses" |
| Codex 仍走預設的 OpenAI 端點 | config.toml 缺少 model_provider = "linkex",或設定被寫進了專案層級的 .codex/config.toml(provider 設定僅使用者層級生效) |
| "model not found" | 該模型未提供——從定價頁複製精確的模型 id |
| 額度不足錯誤 | 充值:購買額度 |