Grok Build

Grok Build 是 xAI 的终端编程工具，可通过自定义 Responses 端点接入。配置格式可能随版本演进，修改前建议先运行 grok inspect 查看当前配置。

安装

macOS、Linux：

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

安装后检查：

grok --version

设置令牌

export COFFEECAT_API_KEY="sk-你的令牌"

配置文件

用户配置目录通常是：

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

[models]
default = "控制台中的 Responses 模型 ID"
web_search = "控制台中的 Responses 模型 ID"

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

[model."控制台中的 Responses 模型 ID"]
model = "控制台中的 Responses 模型 ID"
name = "猫咖啡编程模型"
description = "通过猫咖啡 API 使用"
env_key = "COFFEECAT_API_KEY"
api_backend = "responses"
context_window = 128000

请把 context_window 改成模型真实上下文长度。

使用 Responses 渠道

api_backend = "responses" 要求模型和渠道支持 /v1/responses。只支持 Chat Completions 的模型不适合此配置。

检查与测试

grok inspect

最小测试：

grok -p "只回复 OK" -m "控制台中的 Responses 模型 ID"

修改配置后退出并重新启动 Grok Build。

常见问题

• 环境变量缺失：确认 env_key 填的是变量名，不是令牌本身。
• 模型不存在：复制控制台的准确模型 ID，并确认令牌权限。
• Responses 错误：当前模型渠道不支持 Responses，换用对应编程模型。
• 配置字段报错：升级 Grok Build，并以当前版本 grok inspect 输出为准。