OpenAI Codex CLI 設定教程

📋 前置準備

在開始之前，請確保你已經：

• 註冊了 Koze 帳號並登入
• 在 API 管理 頁面創建了一把 API Key
• 已安裝 Codex CLI（npm install -g @openai/codex）

🚀 步驟一：設定 Codex 設定檔

在 ~/.codex/config.toml 檔案開頭新增以下設定：

model_provider = "koze"
model = "gpt-4.1"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
[model_providers.koze]
name = "koze"
base_url = "https://api.kozeai.com/v1"
wire_api = "responses"
requires_openai_auth = true

💡 提示：將 https://api.kozeai.com/v1 替換為你的實際 Koze 代理程式位址。 model 字段可以根據你的套餐選擇不同模型。

🔑 步驟二：設定 API 金鑰

在 ~/.codex/auth.json 檔案中設定你的 API 金鑰：

{
  "OPENAI_API_KEY": "你的Koze API金鑰"
}

🎯 步驟三：啟動 Codex

配置完成後，直接在終端機啟動：

codex

Codex CLI 會自動使用 Koze 代理程式進行 API 請求。

📌 可用模型

你可以在設定檔的 model 欄位中使用以下模型（取決於你的 Koze 套餐）：

模型名稱	說明
gpt-5.3-codex	gpt-5.3-codex，適合日常程式設計任務
gpt-5.4-mini	GPT-4.1 Mini，性價比更高
gpt-5.4	GPT-5.4 多模態模型

⚠️ 常見問題

問題	解決方案
提示 "Authentication failed"	檢查 auth.json 中的 API Key 是否正確
config.toml 不生效	確保設定寫在檔案開頭，且 model_provider 名稱與 [model_providers.xxx] 一致
使用 Nginx 反代時失效	在 Nginx http 區塊中新增 underscores_in_headers on;，否則 Nginx 預設丟棄帶底線的請求頭