OpenAI Codex CLI 自訂 API 設定：安裝、設定和使用 TokenHub

什麼是 Codex CLI？

Codex CLI 是 OpenAI 的編碼代理，用於從終端處理儲存庫、編輯檔案、運行命令以及完成開發任務。

本指南介紹如何使用 TokenHub 自訂 API 提供者設定 Codex CLI。它保留了 Codex 工作流程，同時在 TokenHub 中集中 API 金鑰、相容模型、請求日誌和令牌使用情況。 Codex 自訂提供者使用 OpenAI 回應 API，而不是普通的聊天完成，因此模型選擇必須考慮回應、串流和工具呼叫行為。在非生產儲存庫中驗證提供程序，從檢查和解釋任務開始，然後才允許編輯或 shell 命令。

Codex 可以透過 TokenHub 的 OpenAI compatible 相容 API 中轉模型請求。本文保留官方安裝方式，並只替換 API key、Base URL 和模型 ID。

本指南使用的 TokenHub endpoint 是 https://us-api.tokenhub.com/v1/responses。

何時使用

適合先在小型倉庫或測試專案中驗證。先讓工具讀檔、解釋程式碼或產生方案，再逐步開啟修改和自動化任務。

安裝或開啟工具

先依照 Codex 官方文件安裝或開啟工具。版本不同時，請以官方文件目前的入口為準。

對於 CLI 工具，先確認可執行檔可用，再加入 TokenHub 憑證：

codex --version

準備 TokenHub 憑證

建立 TokenHub API key，並在 TokenHub 模型列表中選擇一個適合這個工具的模型。

export TOKENHUB_API_KEY="sk-..."

請將金鑰保存在本機 shell、IDE 的密鑰儲存或工具的安全 API key 欄位中，不要提交到程式碼倉庫。

設定 TokenHub 服務商

在工具的模型、供應商、API Keys 或 OpenAI Compatible 設定頁面中填入下列值。

服務商填寫值

欄位	填寫值
供應商	OpenAI Compatible 或 Custom
Base URL	`https://us-api.tokenhub.com/v1`
API Key	`TOKENHUB_API_KEY` 的值
模型	`gpt-4.1` 或其他 TokenHub 模型 ID

設定檔位置

欄位	填寫值
User config	`~/.codex/config.toml`
Provider section	`model_providers.tokenhub`
Secret source	`env_key = "TOKENHUB_API_KEY"`

model = "gpt-4.1"
model_provider = "tokenhub"

[model_providers.tokenhub]
name = "TokenHub"
base_url = "__API_BASE_URL__/v1"
env_key = "TOKENHUB_API_KEY"
wire_api = "responses"

Codex uses the Responses wire API for this provider, so choose a TokenHub model that supports https://us-api.tokenhub.com/v1/responses.

如果你安裝的版本寫出的 schema 略有不同，先用互動式設定產生一次，再保留相同的 TokenHub 值：Base URL、API key 和模型 ID。

如果工具將 chat、edit、apply 和 fast model 分開，第一次測試先全部使用同一個 TokenHub 模型。確認可用後，再依成本、延遲和推理能力拆分。

臨時環境變數只用於排錯

臨時變數適合確認 Key、網路和模型名。驗證通過後，請把同樣的值寫回上方的持久設定。

export TOKENHUB_API_KEY="sk-..."

驗證連線

先使用唯讀提示測試，確認模型能讀取上下文且不會改動檔案。成功後再測試編輯、Apply 或 Agent 任務。

閱讀目前專案的 README，請用三句話總結。不要修改任何檔案。

提示成功後，回到 TokenHub 請求記錄確認模型名稱、endpoint、token 用量和計費分組。

常見問題

現象	處理方式
401 或驗證失敗	確認 `TOKENHUB_API_KEY` 有效，且保存在同一個 terminal、IDE 或用戶端設定檔中。
404 或找不到模型	使用 TokenHub 工作區中存在，且符合所選協議的模型 ID。
endpoint 不正確	Base URL 必須與上方一致。OpenAI 相容工具通常需要 `/v1`；Claude 相容工具通常不需要。
請求逾時	檢查到 `https://us-api.tokenhub.com` 的網路、代理設定，以及工作區 allowlist。
工具使用了其他模型	重新檢查 chat、edit、apply、fast 或 autocomplete 等所有模型欄位。

如何選擇推薦模型？

工作負載模型選擇適合原因

Interactive repository workResponses-compatible model with reliable tool useCodex routes custom providers through the Responses API and needs tools to inspect, edit, and verify a repository task.

Deep review or long-running tasksHigher-context reasoning model, verified with CodexValidate the actual Responses route, streaming, and tool behavior before using it for multi-step work.

Fast iterationsLower-cost Responses-compatible modelUse it only after confirming it completes the same tool loop reliably; Chat Completions support alone is not a substitute.

前往模型廣場比較價格和能力

Codex CLI 自訂 API 常見問題解答

為什麼 Codex 基本 URL 需要 /v1？

Codex 將回應路徑附加到提供者的 base_url，因此 TokenHub 提供者應使用 API 根後跟 /v1。

我可以將wire_api更改為chat_completions嗎？

保留目前 Codex 自訂提供者的wire_api =「responses」。如果模型不支援回應，請選擇其他模型，而不是使用未經驗證的協定值。

為什麼 Codex 仍然會報告缺少 API 金鑰？

檢查 config.toml 中的 env_key 是否與 TOKENHUB_API_KEY 完全匹配，並從包含變數的新終端啟動 Codex。

Codex CLI 與 Claude Code 有何不同？

兩者都是編碼代理，但它們的客製化提供者協議有所不同：Codex 使用 OpenAI Responses，而 Claude Code 使用 Anthropic Messages。比較工作流程、工具可靠性、情境、延遲和成本。

Codex 使用量如何透過 TokenHub 計費？

TokenHub 對所選模型的輸入、輸出和適用的快取使用情況進行計費。 Codex CLI 型號沒有單一價格，因此在使用前請檢查當前型號詳細資訊頁面。

什麼是 Codex CLI？

如何選擇推薦模型？

Codex CLI 自訂 API 常見問題解答

參考資料

相關 App