编程与智能体

Grok Build CLI 接入 API 教程

Grok Build 接入 NineClaw API 教程

通过本教程，可以将本机 Grok Build CLI 接入 NineClaw API，使用 NineClaw 提供的 Grok 模型能力进行 AI 编程和 Agent 工作流。

开始前，请先创建一个可用的 NineClaw API Key。

1. 安装 Grok Build

macOS / Linux

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

Windows PowerShell

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

安装完成后重新打开终端：

grok --version

可以正常显示版本信息即可。

2. 创建配置文件

Grok Build 配置文件：

~/.grok/config.toml

macOS / Linux

创建目录：

mkdir -p ~/.grok

Windows

配置目录：

%USERPROFILE%\.grok

配置文件名称必须为：

config.toml

不要保存为：

config.toml.txt

3. 配置 API

打开配置文件：

~/.grok/config.toml

Windows 用户请对应修改：

%USERPROFILE%\.grok\config.toml

填写以下内容：

[cli]
installer = "internal"

[models]
default = "grok-4.6"
default_reasoning_effort = "high"

[model.nineclaw]
model = "grok-4.6"
base_url = "https://api.nineclaw.cc/v1"
name = "Grok 4.6"
api_key = "YOUR_nineclaw_API_KEY"
context_window = 500000

参数说明：

参数	说明
model	Grok 模型 ID
base_url	API 接口地址
api_key	NineClaw API Key
context_window	上下文长度

4. 启动 Grok Build

进入项目目录：

cd your-project

执行启动命令：

grok

正常进入交互界面并获得回复，即表示配置完成。

修改配置后：

请完全退出 Grok Build，然后重新启动。

常见问题

401 Unauthorized

原因：

API Key 错误
Key 已失效
复制时包含空格

解决：

重新复制 NineClaw API Key。

model not found

原因：

模型名称不存在。

解决：

检查模型 ID 是否正确，并使用模型列表中的实际名称。

404 Not Found

检查 API 地址。

错误：

https://api.nineclaw.cc

正确：

https://api.nineclaw.cc/v1

可以聊天但是无法编程

检查当前模型是否为文本推理模型。