---
description: "将 xAI Grok Build 接入在问 OpenAI Responses 协议，开箱使用 grok-4.7。"
---

# 接入 Grok Build

> [Grok Build](https://docs.x.ai/build/overview)（`grok`）是 xAI 出品的终端编程 Agent（Rust 编写）：全屏 TUI 可交互运行，也支持 `grok -p` 无头脚本与 ACP 协议接入 IDE。API Key 直写配置文件，不污染环境变量，自定义模型走在问 OpenAI Responses 协议，开箱即用 `grok-4.7`。

## 安装

官方脚本安装（macOS / Linux / WSL）：

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

也可以用 npm 全局安装：

```bash
npm install -g @xai-official/grok
```

安装后可用 `grok --version` 验证。

## 配置步骤

打开 `~/.grok/config.toml`（文件不存在则创建），写入以下内容（将 `sk-你的在问APIKEY` 替换为实际 Key）：

```toml
# ~/.grok/config.toml
[models]
default = "grok-4.7"

[model."grok-4.7"]
model = "grok-4.7"
base_url = "https://oneapi.zaiwenai.com/v1"
name = "在问 AI / grok-4.7"
api_backend = "responses"
context_window = 256000
api_key = "sk-你的在问APIKEY"
```

如果该文件已有其他自定义模型配置，请先备份，再手动合并 `[models]` 与 `[model.*]` 节点。

也可以使用以下辅助命令自动备份并写入（macOS、Linux 或 WSL）：

```bash
mkdir -p "$HOME/.grok"
[ ! -f "$HOME/.grok/config.toml" ] || cp "$HOME/.grok/config.toml" "$HOME/.grok/config.toml.bak"
cat > "$HOME/.grok/config.toml" << 'GROK_EOF'
# ~/.grok/config.toml
[models]
default = "grok-4.7"

[model."grok-4.7"]
model = "grok-4.7"
base_url = "https://oneapi.zaiwenai.com/v1"
name = "在问 AI / grok-4.7"
api_backend = "responses"
context_window = 256000
api_key = "sk-你的在问APIKEY"
GROK_EOF
```

Windows PowerShell：

```powershell
$grokDir = Join-Path $HOME ".grok"
$configPath = Join-Path $grokDir "config.toml"
New-Item -ItemType Directory -Force -Path $grokDir | Out-Null
if (Test-Path $configPath) { Copy-Item $configPath "$configPath.bak" -Force }
@'
# ~/.grok/config.toml
[models]
default = "grok-4.7"

[model."grok-4.7"]
model = "grok-4.7"
base_url = "https://oneapi.zaiwenai.com/v1"
name = "在问 AI / grok-4.7"
api_backend = "responses"
context_window = 256000
api_key = "sk-你的在问APIKEY"
'@ | Set-Content -Encoding utf8 $configPath
```

## 验证

在项目目录启动交互式 TUI：

```bash
cd your-project
grok
```

或无头模式跑一条指令验证连通性：

```bash
grok -p "用一句话介绍你自己"
```

TUI 内可用 `/model` 切换模型（`grok-4.7` 为默认），`/usage` 查看用量。

::: tip 配置说明
- `api_key` 直写 `config.toml`，不污染环境变量；换 Key 时直接改该字段即可
- `[model."grok-4.7"]` 表头必须带引号：key 含点号，裸写会被 TOML 解析为嵌套表
- `api_backend = "responses"`：走在问 OpenAI Responses 协议（`/v1/responses`），与 Codex 的 `wire_api = "responses"` 一致
- `context_window = 256000`：上下文窗口配置为 256K，低于 OpenAI 短上下文计费阈值（272K），避免触发长上下文倍率计费
- `model = "grok-4.7"`：实际调用的在问侧模型 ID；如需切换在问其他模型，改该字段即可
- 辅助命令会在覆盖前将已有配置文件备份为 `~/.grok/config.toml.bak`
:::