接入 Grok Build

Grok Build 是 xAI 推出的终端智能开发工具，能够在项目目录中理解代码、执行开发任务，并通过自定义模型连接外部服务。

Grok Build 支持 Windows、macOS 和 Linux。更多产品信息，请查看 xAI 官网；官方安装脚本由 x.ai 域名提供。

Grok Build 可通过 Better Gate 客户端或手动配置接入 Better Gate。请选择其中一种方式，不要同时使用，以免配置相互覆盖。

1 安装 Grok Build

1.1 Windows

打开 PowerShell，运行：

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

脚本安装后如果提示找不到 grok，请确认 %USERPROFILE%\.grok\bin 已加入用户 PATH。

1.2 macOS

打开终端，运行：

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

1.3 Linux

打开终端，运行：

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

安装完成后，请重新打开终端并运行：

grok --version

开始配置 Better Gate 前，请退出所有正在运行的 Grok Build 会话。

2 准备 Better Gate 配置

1. 登录 Better Gate 控制台。
2. 确认账户有可用余额（组织成员需确认自己的成员额度够用）。
3. 打开“API Keys”，点击“创建 Key”。
4. 填写 Key 名称，路由方式保持默认的“智能路由”就行，它会自动挑可用渠道；只有需要固定渠道时才选“指定渠道分组”。组织管理员为成员创建 Key，记得勾选“分配给成员”。
5. 点击创建，复制并保存好完整的 API Key。
6. 打开“模型列表”，复制准备使用的模型 ID。

3 选择接入方式

3.1 通过 Better Gate 客户端接入 Grok Build (推荐)

下载并安装 Better Gate 客户端：

1. 安装并启动客户端，点击“登录”。
2. 浏览器打开授权页面后，确认当前账号并点击“授权并继续”，随后返回客户端。

通过客户端接入 Grok Build：

1. 完整退出 Grok Build。
2. 找到 Grok Build 卡片，点击“一键接入”（已接入过时按钮显示“配置接入”，打开的是同一个弹窗）。
3. 在弹窗中选择用于 Grok Build 的 API Key；如果列表未更新，点击“刷新密钥”。
4. 按提示选择模型，然后点击“接入”，等待配置完成。
5. 重新打开 Grok Build，发送一条简短消息进行测试，然后前往 Better Gate 控制台的用量页面，确认是否出现对应的请求记录。

不再需要 Better Gate 时，可以在弹窗中点击对应密钥旁的“取消接入”：客户端会恢复 Grok Build 的原有配置，工作区的 API Key 不会被删除。

3.2 手动配置 Grok Build

Grok Build 的用户级配置文件路径如下：

• macOS、Linux：~/.grok/config.toml
• Windows：%USERPROFILE%\.grok\config.toml

先根据操作系统设置 BETTER_GATE_API_KEY 环境变量。

macOS zsh

echo 'export BETTER_GATE_API_KEY="YOUR_BETTER_GATE_API_KEY"' >> ~/.zshrc
source ~/.zshrc

Linux bash

echo 'export BETTER_GATE_API_KEY="YOUR_BETTER_GATE_API_KEY"' >> ~/.bashrc
source ~/.bashrc

Windows PowerShell

[Environment]::SetEnvironmentVariable(
  "BETTER_GATE_API_KEY",
  "YOUR_BETTER_GATE_API_KEY",
  "User"
)

Windows 环境变量设置完成后，请关闭所有终端窗口，然后重新打开 PowerShell。

创建或编辑 config.toml，写入以下内容：

[model.better-gate]
model = "YOUR_MODEL_ID"
base_url = "https://gateway.better-gate.com/v1"
name = "Better Gate"
env_key = "BETTER_GATE_API_KEY"

[models]
default = "better-gate"

如果文件中已有 Skills、Plugins、Hooks 或其他模型配置，请合并以上两个表，不要覆盖无关内容；同一个 [models] 表只能保留一份。

保存后运行 grok inspect 检查配置，再运行 grok 启动 Grok Build。如果当前模型不是 Better Gate，可在交互界面中执行 /model better-gate。

发送一条简短消息，再前往 Better Gate 控制台的用量页面，确认是否出现对应的请求记录。如果提示缺少 API Key，请确认新终端能够读取 BETTER_GATE_API_KEY；如果提示找不到模型，请重新核对模型 ID。