跳到正文
HopBase 文檔
登入控制台

Codex App

讓 OpenAI 的 Codex 桌面應用程式透過 HopBase 呼叫 GPT 模型。

Codex App 是 OpenAI 的 Codex 桌面應用程式，和 Codex CLI 讀同一套使用者設定 ~/.codex/config.toml。設定好這份檔案和金鑰，重新開啟應用程式即可使用 HopBase。

項目值
設定檔~/.codex/config.toml 與 ~/.codex/auth.json
Base URLhttps://api.hop-base.com/v1
協定wire_api = "responses"
金鑰Codex Plus 或 Codex Pro 分組的金鑰

推薦：一鍵接入或 CC Switch

兩種方式都會寫好 config.toml 和 auth.json，Codex App 可直接使用。

寫入設定

在控制台「API 金鑰」頁找到 Codex 分組的金鑰，任選一種：點「一鍵接入」選 Codex CLI，把命令複製到終端機執行；或依 CC Switch 指南點「導入 CCS」，同樣選 Codex CLI。

完全結束並重新開啟 Codex App

結束整個應用程式再重新開啟，macOS 可按 Cmd+Q。只關視窗時，應用程式不會重新讀取設定。

新建任務驗證

新建一個任務，請它只回一個詞。成功後到控制台「使用記錄」能看到這次請求。

手動設定

Codex App 從圖形介面啟動，不一定讀得到終端機裡設定的環境變數。因此手動設定時用 auth.json 存放金鑰，不用 env_key。

系統設定目錄
macOS / Linux~/.codex/
WindowsC:\Users\你的使用者名稱\.codex\

檔案不存在就新建。

config.toml：

model_provider = "hopbase"
model = "gpt-6-astra"
model_reasoning_effort = "high"

[model_providers.hopbase]
name = "HopBase"
base_url = "https://api.hop-base.com/v1"
wire_api = "responses"
requires_openai_auth = true

auth.json：

{
  "OPENAI_API_KEY": "sk-你的金鑰"
}
兩種金鑰寫法不要混用：

requires_openai_auth = true 搭配 auth.json，env_key 搭配環境變數，只選一種。兩者寫進同一份設定時，Codex 0.153 實測不送出金鑰，閘道回傳 401 missing_api_key。

切換模型

修改 config.toml 裡的 model 和 model_reasoning_effort，完全結束並重新開啟 Codex App，再新建任務。既有任務可能沿用建立時的模型。

Codex 分組可用的模型 ID 和推理檔位見 Codex CLI；以目前金鑰呼叫 GET /v1/models 的回傳為準。

更多細節

下一步

本頁目錄

推薦：一鍵接入或 CC Switch寫入設定完全結束並重新開啟 Codex App新建任務驗證手動設定切換模型更多細節下一步