使用指南
返回主页

外观

Grok Build CLI 配置 ​

Grok Build 是 xAI 官方的终端编程 Agent。这里配置的是 Grok Build CLI，不是 grok.com 或 X 中的聊天应用。它可以通过 OpenAI Responses 协议连接 custom 的第三方模型。

接入协议OpenAI Responses
打开安装说明

配置步骤

  1. 1

    按“打开安装说明”进入 xAI 官方页面，安装 Grok Build CLI；终端是用于输入命令的文字窗口。

  2. 2

    创建配置文件，在 macOS / Linux 打开 ~/.grok/config.toml；Windows 打开 %USERPROFILE%\.grok\config.toml。

  3. 3

    复制下方 config.toml 内容到配置文件。将其中的 sk-your-api-key 替换为你在本站后台创建的API Key

  4. 4

    运行 grok -m custom，或在 Grok 中输入 /model custom 切换模型。

复制配置

~/.grok/config.toml（Windows：%USERPROFILE%\.grok\config.toml）

[models]
default = "custom"

[model.custom]
model = "grok-4.5"
base_url = ""
name = "custom"
api_key = "sk-your-api-key"
api_backend = "responses"

将其中的 sk-your-api-key 替换为你在本站后台创建的API Key

当前终端启动

grok models
grok -m custom
看图操作

Grok Build CLI 配置流程图

Grok Build 通过 config.toml 读取自定义模型。先复制页面配置，再在真实 TUI 中确认模型名称和输入区。

截图中的供应商名称是示例，仅用于定位操作入口。实际供应商名称或 ID 统一填写 custom；地址、密钥和模型请使用本页复制区的值。

界面可能随版本变化
  1. 第 1 步

    把 custom 写入 Grok 配置文件

    打开 ~/.grok/config.toml（Windows 为 %USERPROFILE%\.grok\config.toml），完整粘贴页面复制区中的配置，将其中的 sk-your-api-key 替换为你在本站后台创建的 API Key 并保存。

    自行采集Grok Build 当前配置格式
  2. 第 2 步

    启动 Grok Build 并确认配置

    1. 1

      在底部输入框键入测试任务并按回车。

    2. 2

      这里会显示当前模型；应看到 custom 或实际模型名。

    运行 grok -m custom。界面打开后，从底部确认当前模型，再在输入框与模型打个招呼。

    官方仓库Grok Build 官方仓库当前界面查看来源 ↗

看不清时：点击图片可放大；配置值请复制页面中的文字，不要照着截图手工输入密钥或地址。

验证配置

在项目目录运行 grok -m custom，输入“hi”。能够看到模型回复且没有认证错误，即配置成功。

配置示例中如果出现 sk-your-api-key 必须替换为自己的完整密钥；不要把含密钥的配置提交到 Git。

配置文件在哪里 ​

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

如果 .grok 文件夹不存在，可以手动新建。以英文句点开头的文件夹可能默认隐藏；macOS Finder 可按 Command + Shift + . 显示隐藏文件，Windows 资源管理器可在“查看”中打开“隐藏的项目”。

常见错误 ​

  • model not found：配置中的 model 与服务端模型 ID 不一致，先运行 grok models 检查。
  • 401 或 Invalid token：环境变量没有在当前终端生效，或仍残留其他供应商的认证配置；关闭终端后重新设置密钥。
  • 404 /v1/v1/...：Base URL 重复添加了 /v1，直接复制本页动态地址。
  • 启动后仍是官方 Grok 模型：运行 grok -m custom，或在会话中输入 /model custom。

完整协议说明见 xAI 官方自定义模型文档。更多通用错误处理见常见问题。