Codex CLI 安裝教學

如果你準備使用 GPT / Codex 系列模型，也可以提前把 Codex CLI 安裝好。裝完後同樣可以透過 CC-Switch 連線 NextHub。

安裝步驟

1. 確認 Node.js 環境

Codex CLI 同樣需要 Node.js 環境，建議先檢查版本：

node -v
npm -v

2. 全域安裝 Codex CLI

在終端機執行以下命令安裝 Codex：

npm install -g @openai/codex

3. 驗證 Codex 是否安裝成功

執行下面命令，能正常輸出版本號或啟動 Codex 即可：

codex --version
codex

連線方式一：CC-Switch（推薦）

安裝完成後，直接繼續 CC-Switch 教學即可。在 CC-Switch 裡選擇 Codex，請求網址填 https://api.nexthub.cc/v1（OpenAI Responses 協定需帶 /v1），再填入你的 ApiKey，就能使用 GPT-Azure 分組（0.47x）。

連線方式二：手動設定

不想用設定工具的話，手動編輯 Codex 的兩個設定檔即可。

1. 開啟 Codex 設定目錄

Windows (CMD)

start "" "%USERPROFILE%\.codex"

macOS (Terminal)

open "$HOME/.codex"

目錄裡沒有對應檔案就手動建立。

2. 設定 config.toml

將以下內容寫入 ~/.codex/config.toml：

model = "gpt-5.6"
model_provider = "nexthub"
model_reasoning_effort = "high"
disable_response_storage = true

[model_providers.nexthub]
name = "nexthub"
base_url = "https://api.nexthub.cc/v1"
wire_api = "responses"
requires_openai_auth = true

請求網址要帶 /v1

Codex 走 OpenAI Responses 協定（/v1/responses），base_url 需要帶 /v1。model 依需求填寫 GPT-Azure / GPT-Pro 分組提供的模型 ID（如 gpt-5.6、gpt-6-astra），以模型廣場即時資料為準。

3. 設定 auth.json

將 ApiKey 寫入 ~/.codex/auth.json（GPT-Azure 或 GPT-Pro 分組的金鑰）：

{
  "OPENAI_API_KEY": "你的 NextHub ApiKey"
}

4. 驗證

在終端機執行 codex 並傳送一則測試訊息，介面頂部顯示所選模型且能正常回覆，即連線成功。

全域提示詞

~/.codex/AGENTS.md 是 Codex 的全域提示詞檔案，沒有會自動建立，可依需求寫入你的工作約定。