Codex

Codex 只會說 OpenAI 的 Responses 協定。把 Codex 的模型供應商指到 Hakila 後， Hakila 提供的模型清單只列 ChatGPT（OpenAI GPT）模型與 hakila/auto，GPT 模型原樣轉發給 OpenAI； hakila/auto 在 Codex 裡也只會自動選 ChatGPT 模型（見第三方工具只挑自家模型）。

設定

1. 到 Hakila Console 建立 API Key，設定環境變數 HAKILA_API_KEY。
2. 把 Hakila 提供的 config.toml 放到 Codex 設定目錄（CODEX_HOME，預設 ~/.codex；Windows 為 %USERPROFILE%\.codex）， 並在同一個目錄下載模型清單（先依這把 API Key 的允許清單，再套用所屬組織的第三方工具模型清單）：

   curl -H "Authorization: Bearer $HAKILA_API_KEY" https://api.hakila.ai/v1/clients/codex/models -o hakila-models.json

3. 把 model_catalog_json 改成 hakila-models.json 的實際絕對路徑。

Windows 可以改用 Hakila Switcher 一鍵設定；之後每次開啟 Switcher 都會重新下載清單，有新模型時自動更新並提示你重新開啟 Codex。

model_provider = "hakila"
model = "openai/gpt-6-sol"
model_reasoning_effort = "medium"
model_catalog_json = 'C:\Users\<使用者名稱>\.codex\hakila-models.json'

[model_providers.hakila]
name = "Hakila"
base_url = "https://api.hakila.ai/v1"
env_key = "HAKILA_API_KEY"
wire_api = "responses"
requires_openai_auth = true

hakila-models.json 會完全取代 Codex 內建的模型清單，/model 選單與 Codex App 只會列出 Hakila 的模型。

可選的模型

清單只包含 ChatGPT（OpenAI GPT）模型與 hakila/auto；Claude、Gemini、Grok 等模型與 OpenAI 的開放權重模型 gpt-oss 不會列出。 選單預設列出以下模型，其餘模型在清單裡設為隱藏，仍可在 config.toml 的 model 或 codex -m <slug> 直接指定。

API Key 的允許清單以外的模型不會出現在下載的清單裡；組織管理員可以在 Console →「第三方工具模型清單」的 Codex 分頁 選擇要列出哪些模型。清單順序依平台模型目錄的排序。Hakila 新上架、還沒調校選單設定的 GPT 模型會以隱藏條目出現，可以直接用 slug 指定。

生圖

Codex 的 image_gen 工具（imagegen 技能用的就是它）由 Codex 在本機執行，呼叫供應商的 /v1/images/generations 與 /v1/images/edits，圖片存到 $CODEX_HOME/generated_images。Codex 只對 OpenAI 供應商或設了 requires_openai_auth = true 的供應商註冊這個工具，所以上面的設定必須加這一行，否則 Codex 會回答「沒有可用的圖片生成工具」， 並建議改用需要 OPENAI_API_KEY 的 CLI 備用方式。

• 設了 env_key 時請求仍帶 HAKILA_API_KEY，不會改用 ChatGPT 登入的憑證；生圖照 Hakila 的生圖計價與每日張數上限計費。
• Codex 固定送 gpt-image-2，Hakila 會改用同價位的最新一代 openai/gpt-image-2.5-flare （回應標頭 X-Hakila-Adjusted-Params: model=openai/gpt-image-2.5-flare），去背（透明背景）也由它處理。
• openai/gpt-image-2.5-flare 不在 API Key 的允許清單內時維持 openai/gpt-image-2，這時去背會回「不支援透明背景」； 兩個都不在允許清單內時無法生圖。
• 其他 Responses 客戶端：Hakila 會替 GPT 模型的請求補上 OpenAI 內建的 image_generation 工具（回應標頭 X-Hakila-Added-Tools: image_generation）， 生圖模型為 openai/gpt-image-2.5-flare，費用依尺寸與品質另外加在該次請求上。 請求已帶自己的 image_gen 工具（例如 Codex）時不會補，OpenAI 不接受兩者出現在同一個請求。

Hakila Auto

• 候選：Hakila 從 originator header 與 Codex 的系統指示認出 Codex，hakila/auto 只在 ChatGPT 模型候選中挑選； 沒有可用的 ChatGPT 候選時回 400。
• Context window：以 200K 計，避免改道到較小的模型時超出上限。
• 壓縮：自訂供應商由 Codex 在本機壓縮歷史，不使用 OpenAI 的伺服器端壓縮。
• 快速模式：fast 服務層級不會出現在 Hakila Auto 的選單。