Grok Build 設定教學：連接 NextHub API

Grok Build 是 xAI 推出的終端機編碼助手。依照官方文件，它的主要設定檔是 ~/.grok/config.toml，可以把模型請求接到 NextHub 的 Grok 分組（0.55x，官方通道）。

連線步驟

1. 安裝 Grok Build

Windows (PowerShell)

irm https://x.ai/cli/install.ps1 | iex

macOS / Linux / WSL

curl -fsSL https://x.ai/cli/install.sh | bash

安裝完成後重新開啟終端機，執行以下指令確認可用：

grok --version

2. 開啟設定目錄

Windows (CMD)

start "" "%USERPROFILE%\.grok"

macOS / Linux

mkdir -p ~/.grok

目錄中沒有 config.toml 就手動建立一個同名檔案。

3. 寫入設定

將以下內容寫入 config.toml：

[models]
default = "grok-4.6"
web_search = "grok-4.6"

[endpoints]
models_base_url = "https://api.nexthub.cc/v1"

[model."grok-4.6"]
model = "grok-4.6"
name = "Grok 4.6"
description = "Grok 4.6 via NextHub"
api_key = "你的 NextHub ApiKey"
api_backend = "responses"
context_window = 500000
supports_backend_search = false

兩個相容性開關

supports_backend_search = false 會關閉 Grok 後端搜尋（閘道不提供此能力，不關閉可能因請求被附加後端搜尋參數而報錯）；若想使用 /effort 命令與 --effort 參數調整思考等級，請在同一設定區塊中新增一行 supports_reasoning_effort = true。修改設定後需重新啟動 Grok Build 才會重新載入。

Base URL 記得帶 /v1

models_base_url 填 NextHub 的 OpenAI 相容端點 https://api.nexthub.cc/v1。API Key 使用 Grok 分組 的金鑰；目前 Grok 分組提供 grok-4.5、grok-4.6、grok-4.3、grok-4.20 系列與 grok-build-0.1 等模型，完整清單以模型廣場即時資料為準。

不想把金鑰直接寫進設定檔的話，把 api_key = "..." 一行換成 env_key = "NEXTHUB_API_KEY"，再在系統環境變數裡設定 NEXTHUB_API_KEY。注意 env_key 填的是環境變數名稱，不是金鑰本身。

4. 驗證設定

grok inspect
grok -p "只回复 ok" -m grok-4.6

grok inspect 能讀取到設定、測試指令能收到 ok 回覆，即連線成功。

常見問題

/effort 調整思考等級不生效

模型未宣告 supports_reasoning_effort = true（見上方「兩個相容性開關」），/effort 命令與 --effort 參數就不會對該模型生效。

提示模型不存在或無權限

請依序檢查：ApiKey 是否為 Grok 分組、models_base_url 是否為 https://api.nexthub.cc/v1、model 是否與模型清單中的 ID 一致、金鑰是否完整（前後不含多餘空格）。