LinkexLinkex Docs
整合指南

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
額度不足錯誤充值:購買額度

本頁內容