在问 OneAPI 文档中心

Appearance

接入 Grok Build ​

Grok Build（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 查看用量。

配置说明

  • 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