Grok Build 配置 LuminAI API 教程
Grok Build 是 xAI 推出的终端 AI 编程助手，支持在 config.toml 中添加自定义模型。本教程介绍如何将 Grok Build 接入 LuminAI 的 OpenAI Responses 兼容接口。
开始前需要准备
Section titled “开始前需要准备”请先准备：
- 一个可用的 LuminAI API Key
- API Key 已绑定支持目标模型的令牌分组
- 当前分组在模型广场中显示的完整模型名称
如果还不会选择分组和模型，请先阅读 LuminAI 新手入门 和 模型列表与价格查询。
一、安装 Grok Build
Section titled “一、安装 Grok Build”Windows
Section titled “Windows”打开 PowerShell，执行官方安装命令：
irm https://x.ai/cli/install.ps1 | iexmacOS、Linux 或 WSL
Section titled “macOS、Linux 或 WSL”打开终端，执行：
curl -fsSL https://x.ai/cli/install.sh | bash安装完成后重新打开终端，并检查版本：
grok version二、找到用户配置文件
Section titled “二、找到用户配置文件”Grok Build 的用户级配置文件是：
~/.grok/config.tomlWindows
Section titled “Windows”按 Win + R，输入以下路径并回车：
%USERPROFILE%\.grok也可以在 PowerShell 中运行：
Start-Process "$HOME\.grok"如果文件夹或 config.toml 不存在，请手动创建。
macOS、Linux 或 WSL
Section titled “macOS、Linux 或 WSL”在终端中运行：
mkdir -p ~/.groknano ~/.grok/config.toml三、配置 LuminAI 模型
Section titled “三、配置 LuminAI 模型”打开 ~/.grok/config.toml，写入以下配置：
[models]default = "grok-4.5"web_search = "grok-4.5"
[endpoints]models_base_url = "https://ai.luminai.cc/v1"
[model."grok-4.5"]model = "grok-4.5"name = "Grok 4.5"description = "Grok 4.5 via LuminAI"api_key = "xxx"api_backend = "responses"context_window = 500000需要根据实际情况修改的是：
api_key = "xxx"：将xxx替换为你的 LuminAI API Key。models_base_url：固定填写https://ai.luminai.cc/v1。grok-4.5：如果当前令牌分组使用其他 Grok 模型，请将配置中出现的模型名称全部同步替换。
四、配置项说明
Section titled “四、配置项说明”| 配置项 | 作用 |
|---|---|
[models] default |
新会话默认使用的模型 |
[models] web_search |
Web Search 使用的模型 |
[endpoints] models_base_url |
LuminAI API 接口地址 |
[model."grok-4.5"] |
Grok 4.5 的模型配置 |
model |
实际发送给接口的模型名称 |
name |
模型选择器中显示的名称 |
description |
模型说明 |
api_key |
LuminAI API Key |
api_backend |
请求协议，LuminAI OpenAI Responses 接口填写 responses |
context_window |
模型上下文窗口大小 |
五、检查并测试配置
Section titled “五、检查并测试配置”检查 Grok Build 读取到的配置：
grok inspect查看可选模型：
grok models发送最小测试请求：
grok -p "只回复 OK" -m grok-4.5如果返回 OK，说明配置已经生效。进入交互界面后，也可以使用以下命令切换模型：
/model grok-4.5测试完成后，可以前往 LuminAI 控制台的使用日志确认请求记录。
grok inspect 没有显示自定义模型
Section titled “grok inspect 没有显示自定义模型”请确认文件位置是用户目录下的 ~/.grok/config.toml，而不是项目中的 .grok/config.toml。同时检查 TOML 引号、表名和换行格式。
提示 401 或 API Key 无效
Section titled “提示 401 或 API Key 无效”确认配置项名称是 api_key，并检查 API Key 是否复制完整、已经被禁用或已经过期。请勿填写 env_key。
提示 403、模型不存在或无权限
Section titled “提示 403、模型不存在或无权限”当前 API Key 绑定的分组不支持 model 中填写的模型。请回到模型广场，从当前分组的列表中复制完整模型名称。
提示 404 Not Found
Section titled “提示 404 Not Found”检查 [endpoints] 中的 models_base_url 是否为：
https://ai.luminai.cc/v1并确认 api_backend = "responses"。地址不要重复添加 /v1 或 /responses。
修改配置后没有生效
Section titled “修改配置后没有生效”完全退出 Grok Build，关闭当前终端，重新打开后再次运行 grok inspect。
Web Search 无法使用
Section titled “Web Search 无法使用”web_search 是否可用取决于所选模型、接口能力和客户端配置。如果普通对话正常但 Web Search 失败，可以先删除 [models] 中的 web_search 行，只保留默认模型进行排查。