Codex CLI 設定自訂 API 教學

快速設定

安裝命令

npm install -g @openai/codex

設定檔

~/.codex/config.toml

model_provider

qionggeme

base_url

https://qionggeme.com/v1

env_key

QIONGGEME_API_KEY

這是環境變數名稱，不是明文 API Key。

wire_api

responses

目前官方自訂 provider 應使用 Responses。

設定步驟

1. 1

   安裝 Codex CLI

   使用官方 npm 套件進行全域安裝：

   npm install -g @openai/codex

   安裝完成後可執行 codex 啟動命令列用戶端。

2. 2

   寫入 ~/.codex/config.toml

   建立或編輯 ~/.codex/config.toml，加入以下設定：

   model_provider = "qionggeme"
   model = "gpt-5.3-codex-spark"
   
   [model_providers.qionggeme]
   name = "穷哥么"
   base_url = "https://qionggeme.com/v1"
   env_key = "QIONGGEME_API_KEY"
   wire_api = "responses"

   env_key 的值是 Codex 要讀取的環境變數名稱，不是 API Key 本身；不要新增 api_key 欄位。

3. 3

   在 macOS / Linux 設定 API Key

   在要啟動 Codex 的終端機中設定環境變數：

   export QIONGGEME_API_KEY="你的穷哥么 API Key"

   若寫入 shell 設定檔，請重新載入該檔案或開啟新終端機，再啟動新的 Codex 工作階段。

4. 4

   在 Windows PowerShell 設定 API Key

   在 PowerShell 中執行：

   $env:QIONGGEME_API_KEY="你的穷哥么 API Key"

   此寫法只對目前的 PowerShell 工作階段生效。請在同一個視窗中啟動 codex；若修改了變數或 TOML 設定，必須結束舊 Codex 工作階段並重新啟動。

5. 5

   重新啟動 Codex 工作階段並驗證

   設定檔或環境變數變更後，結束正在執行的 Codex，再執行 codex 建立新工作階段。若範例模型不在目前權杖的可用模型清單中，請改用控制台實際回傳的 Codex 相容模型；模型價格頁 可作為主推模型參考。只需修改 TOML 頂部的 model 值。

設定範例

model_provider = "qionggeme"
model = "gpt-5.3-codex-spark"

[model_providers.qionggeme]
name = "穷哥么"
base_url = "https://qionggeme.com/v1"
env_key = "QIONGGEME_API_KEY"
wire_api = "responses"

# macOS / Linux
export QIONGGEME_API_KEY="你的穷哥么 API Key"

# Windows PowerShell
$env:QIONGGEME_API_KEY="你的穷哥么 API Key"

疑難排解

常見問題