為 GetAPI.ONE 設定 Codex CLI

適用範圍與準備工作

本指南只覆蓋終端中的 Codex CLI，不代表所有桌面用戶端、IDE 外掛、模型或 Codex 功能都相容。

• 一個有可用餘額或適用套餐的 GetAPI.ONE 帳號。
• 一個已私密儲存、有名稱且受限的 GetAPI.ONE 金鑰。
• 從目前目錄中選擇一個明確列出 Responses 端點的模型。
• 具有安裝 Codex CLI 和編輯使用者級 Codex 設定的權限。

• 建立受限金鑰
• 檢查端點相容模型

1. 安裝並確認 Codex CLI

請在目前官方 Codex CLI 頁面選擇與你的作業系統匹配的安裝方式。2026-09-07 核驗的官方 macOS/Linux 獨立安裝命令如下。Windows 使用者應按官方頁面的 Windows 標籤操作，不要盲目執行 Unix shell 命令。

curl -fsSL https://chatgpt.com/codex/install.sh | sh

codex --version

2. 在終端中載入金鑰

啟動 Codex 前，在目前 shell 中設定金鑰。以下範例明確使用佔位值。

export GETAPI_ONE_API_KEY="replace-with-your-private-key"

$env:GETAPI_ONE_API_KEY = "replace-with-your-private-key"

3. 設定 ONE Provider

開啟使用者級 Codex config.toml（通常位於使用者的 .codex 目錄），加入下面的 Provider。把 YOUR_RESPONSES_MODEL 替換為目前 GetAPI.ONE 目錄中明確宣告 Responses 端點的模型。

model_provider = "getapi_one"
model = "YOUR_RESPONSES_MODEL"

[model_providers.getapi_one]
name = "GetAPI One"
base_url = "https://www.getapi.one/v1"
env_key = "GETAPI_ONE_API_KEY"
wire_api = "responses"

4. 執行並驗證

1. 如果把環境變數設定為持久變數，請新開終端；否則繼續使用已設定變數的目前終端。
2. 進入專案目錄並執行 codex，確認顯示的 Provider/模型與預期設定一致。
3. 只有在接受可能產生計費時，才傳送一條最小提示詞。
4. 成功檢查必須同時有有效 CLI 回覆和 GetAPI.ONE 主控台中的對應請求/使用記錄。製作本指南時未發起模型呼叫。

按順序疑難排解

• 完整疑難排解指南
• 準備安全的求助材料