AI 工具选择指南

Grok Build

xAI 的终端编码 Agent（命令 grok）：全屏 TUI、无头脚本 / CI，或经 ACP 嵌进其他编辑器。它由 Grok 旗舰模型驱动（官网现写 Grok 4.6 / 4.7 可调），不是 grok.com 里的聊天窗口——这篇指南帮你5 分钟判断要不要把仓库交给这条 CLI。

4 大适用场景

4 套 Prompt 模板

30 秒决策框架

📌 安装：curl -fsSL https://x.ai/cli/install.sh | bash · 文档：docs.x.ai/build

30 秒决策框架

Grok Build 适合你吗？

对照以下链路，快速判断是否合适

工作面是终端 / CI，还是 GitHub 席位 / GUI IDE？

开终端进仓库就干、或要无头脚本 → Grok Build；已买 Copilot 席位要审 PR → GitHub Copilot；要可视化 IDE → Cursor。

✓ 终端或脚本是主路径 →

→

能否登录 xAI / 提供 API Key？

首次 grok 会开浏览器 OAuth；无浏览器环境用 XAI_API_KEY。国内网络与账号可用性以你本机为准，不要写成全球默认开通。

✓ 账号或 Key 能用 →

→

账单按模型 token，不是「无限本地」

Grok 4.7 文档价：提示不到 20 万 token 时输入 $2 / 输出 $6 每百万；达到或超过 20 万整单翻倍。另有 grok-build-0.1 API 档 $1/$2。以 docs.x.ai 价目为准。

✓ 接受按量 token →

→

只要聊天、不要改文件？

日常问答走 Grok 对话产品。Build 会读仓、改文件、跑命令——权限面更大。

⚠ 聊天用 Grok，改仓才用 Build

快速结论

步骤 1~3 全中 → Grok Build 很可能合适：TUI / 无头 / ACP 三条入口。
要 GitHub PR 策略 → GitHub Copilot。
只要聊天 → Grok。

适合的 4 大场景

这些时候，Grok Build 是合适的选择

核心洞察：Build 把 Grok 从「能聊」变成能在你电脑上改仓、跑测、进流水线

⬛

仓库内交互式 TUI

✦ grok 全屏终端

官方：cd 项目 && grok。读代码、改文件、执行 shell、联网搜索、管长任务。适合已经习惯终端、不想换 IDE 的人。

典型操作：安装 CLI → 登录 → 「Explain this repo」→ 再点名文件用 @ 引用。

心法：先 grok inspect 看它发现了哪些 config / skills / MCP，再开长任务。

⚙️

无头脚本与 CI

✦ grok -p / streaming-json

官方支持 grok -p "…" 与 --output-format streaming-json。适合在流水线里解释架构、跑固定检查，而不是人手盯 TUI。

典型操作：CI 注入 XAI_API_KEY → 对 PR diff 跑一条固定 prompt → 把 JSON 流接到机器人。

心法：无头模式密钥只放 CI secret，不要写进仓库。

🔌

ACP / 自定义模型嵌编辑器

✦ Agent Client Protocol

可嵌进支持 ACP 的应用；~/.grok/config.toml 可接任意兼容模型。适合「TUI 是默认，编辑器是可选壳」。

典型操作：配 custom model → grok inspect → TUI 里 /model 或 -m 切换。

心法：换模型不等于换 harness；skills / hooks / MCP 仍按仓库配置走。

🧪

长程编码：计划、构建、测试

✦ Grok 4.7 在 Build 可调

xAI 写 4.7 面向长程编码与多小时任务，并已在 Cursor 与 Grok Build 可调。价与 4.6 同档，超 20 万 token 整单翻倍。

典型操作：同一条过夜仓库任务对照 4.6 / 4.7 → 看自检和中途改需求会不会跑偏。

心法：长上下文先估 20 万分界，不要只用百万 token 标价做预算。

不建议的 4 类场景

这些场景，建议换工具或降权使用

强行使用会卡在入口、账单或工作面错配上

💬

只要 Grok 聊天 / 实时信息

✦ 局限：Build 是编码 harness

问答、刷 X 信息走 Grok 对话产品即可。

👉 推荐替代：Grok

🐙

主路径是 GitHub PR 策略与云 Agent

✦ 局限：没有 Copilot 那套企业 AI Controls

自动审、Slack 附件进 Issue、席位额度走 GitHub Copilot。

👉 推荐替代：GitHub Copilot

🖥️

零终端、只要 GUI IDE

✦ 局限：默认体验是 TUI

ACP 可嵌编辑器，但入门成本仍是 CLI。

👉 推荐替代：Cursor

🚫

xAI 账号或网络不可达

✦ 局限：OAuth / API 都依赖 xAI

国内可达性以本机实测为准；需要国产链路请换 Claude Code 平替或国内 IDE。

👉 策略：先 grok --version 和登录走通再写进团队规范

能力概览 & 边界

三层结构：核心 → 进阶 → 边界

依据 x.ai/cli、docs.x.ai/build 与 Grok 4.7 公告整理

核心能力

终端里的编码 Agent

交互式 TUI 鼠标、全屏、status line
读仓改文件跑命令任意语言仓库
无头 -p 脚本 / 机器人
macOS / Linux / Windows 安装脚本官方 curl / irm

进阶能力

可扩展 harness

Skills / Plugins / Hooks / MCP inspect 可见
ACP 嵌其他应用编辑器可选壳
自定义模型 config.toml
企业部署文档见 docs 下一章

能力边界

明确不建议硬扛

替代 Grok 聊天产品线不同
GitHub 企业策略中心 → Copilot
超 20 万 token 仍按短窗估价整单翻倍
无 xAI 网络登录走不通

命名与价目锚点
产品名 Grok Build，二进制 grok。不要和 API 模型 id grok-build-0.1（$1/$2 每百万，256k 窗）混成「必须调这个 id」。日常长任务对照 Grok 4.7 价目；账单以控制台为准。

横向对比

Grok Build vs 相邻路径

终端 Agent、GitHub 席位、AI IDE

⬛
Grok Build最强场景
TUI + 无头
xAI 模型
ACP 可选

🐙

进阶心法

3 条铁律：从「能装 CLI」到「敢过夜跑」

安装只是入口；密钥、上下文分界和验收命令决定账单与质量

🔑

交互用登录，CI 用 Key

本机走浏览器 OAuth。

流水线只注入 XAI_API_KEY，禁止写进 git。

📏

先估 20 万 token 分界

4.7 超窗整单翻倍。

长会话拆任务，或先 inspect 丢掉无关 skills。

✅

改完必须有本地命令

prompt 里写死测试 / lint。

Build 能改文件，不等于已经绿。

开箱即用

4 套 Prompt 模板 — 与 4 大场景一一对应

在 TUI 或 grok -p 里改括号后发送

TUI

先读仓再改

Explain this repo，然后只在 [目录] 实现 [功能]。
· 不要动 [密钥 / 基础设施文件]
· 改完跑 [测试命令] 并把失败日志贴回来

✨ 官方推荐的第一句就是 Explain this repo。

无头

CI 解释架构

grok -p "Explain the architecture of this change relative to main" --output-format streaming-json
· 只基于 git diff
· 输出风险点与测试缺口，不要改文件

✨ 无头模式适合只读检查，避免 CI 直接写仓。

模型

对照换模型

用同一条仓库任务：
· 先 /model 切到 [4.6 或自定义]
· 再切 [4.7]，对比步数、自检和是否改需求跑偏

✨ 官网榜不是你仓库的 SLA，必须同题对照。

长任务

过夜前写验收

目标：[多小时迁移 / 修测试债]。
· 每完成一个子目标跑 [命令]
· 上下文接近 20 万 token 时停下来总结，开新会话续

✨ 用验收命令切开长会话，避开整单翻倍。

一句话总结

Grok Build 要解决的是：把 Grok 从聊天窗口变成能在终端改仓、进 CI 的编码 Agent。

它不是 GitHub Copilot 席位，也不是 grok.com 对话；适合能登录 xAI、主路径在终端或脚本的人。

记住核心公式：CLI 能登录 + token 账单算清 + 改完有测试命令 = 敢用 Build 过夜。

你可能还需要

根据你的场景，看看这些工具

对话 Grok、GitHub 席位与 GUI IDE