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 一致、密钥是否完整（前后不带多余空格）。