AI 编程约 9 分钟

Grok Build 怎么用？4 步装好 xAI 编码 Agent

AI 指南·更新于 2026-09-18·◉ 0 浏览

Grok Build（命令名 grok）是 xAI 官方推出的终端 AI 编码代理：以全屏 TUI 方式运行，能理解你的代码库、编辑文件、执行 shell 命令、联网搜索并管理长任务。完整上手只要 4 步：装好命令行工具、登录授权、在项目目录里启动、下达第一个任务。工具本身已开源在 GitHub 仓库 xai-org/grok-build，采用 Apache 2.0 协议，截至 2026 年 9 月 18 日 star 数约 2.68 万、fork 约 5049、主语言为 Rust，仓库仍在高频更新。

前提条件是一台 macOS、Linux 或 Windows 电脑加一个 x.ai 账号（订阅 SuperGrok 或配置 API 额度均可）。官方仓库描述把它定位为「SpaceXAI 的编码代理框架与 TUI，全屏、鼠标可交互、可扩展」，社区覆盖 macOS、Linux、WSL 与 Windows PowerShell 全平台场景。

Grok Build 是什么，和 Claude Code 有什么不同

先对齐认知。Grok Build 定位与 Claude Code、Codex CLI 同类，都是「在终端里干活的编码 Agent」，差异点有三个：

模型侧绑定 xAI 的 Grok 系列，与 X 平台数据生态打通。
底层用 Rust 实现，官方口径强调全屏交互式 TUI，鼠标可操作，还支持无头模式（headless）跑脚本和 CI，以及通过 Agent Client Protocol（ACP）嵌入编辑器。
已开源：代码在 GitHub 仓库 xai-org/grok-build，star 数已到 2.68 万量级；官方 README 明确说明它吸收了 openai/codex 与 sst/opencode 的工具实现经验，第三方能看到它对同类的借鉴。

开始前的三件准备

系统与环境：macOS、Linux 原生支持，Windows 走 PowerShell 脚本；不需要提前装 Node 或 Python，官方提供的是预编译二进制。
账号：准备一个 x.ai 账号。SuperGrok 订阅用户直接用订阅额度，API 用户则按量付费。
网络与合规：认证和模型调用都要访问 x.ai 域名，国内环境先把链路打通；公司项目请先确认代码外发是否符合合规要求。

三样齐了再往下走，能少踩一大半坑。

第一步：安装（三条命令搞定）

官方发布的是预编译二进制，覆盖 macOS、Linux 与 Windows，按系统选一条命令：

macOS / Linux / Git Bash：

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

Windows PowerShell：

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

装完验证：

grok --version

能打印出版本号就是装好了。安装包与说明都发布在官方页面 x.ai/cli，每个版本改了什么可查官方 changelog。

如果你有 Rust 环境，也可以按仓库 README 从源码编译，但要额外满足两个条件：先用 cargo install dotslash 装好 DotSlash（否则 bin/protoc 等构建工具无法下载运行），以及 Rust 工具链要按仓库里的 rust-toolchain.toml 固定版本。构建出的产物名是 xai-grok-pager，官方安装版会把它包装成 grok 命令。官方 README 明确写着 macOS 和 Linux 是受支持的构建宿主，Windows 从源码构建属于尽力支持、当前未测试，所以 Windows 用户直接走安装脚本最稳。

第二步：登录授权

首次运行 grok 会自动打开浏览器跳转 x.ai 完成认证，授权后回到终端即可。两种账号姿势：

SuperGrok 订阅用户：直接用订阅额度，适合个人日常使用，各档位差异可以参考我们之前的 Grok 会员四档价格实测（/ai-guide/grok-membership-worth-it）。
API 用户：配置 API 额度按量计费，适合 CI 或脚本场景，接入细节见 Grok 4.6 价格与 API 全解（/ai-guide/grok-4-6-price-api-guide）。

国内用户注意：认证和调用都要访问 x.ai 域名，网络链路是第一大门槛，建议先解决访问问题再装工具，具体可看 Grok 国内使用教程（/ai-guide/grok-bot-china-guide）。

第三步：在项目里启动，下达第一个任务

进入你的项目目录，运行：

grok

进入全屏界面后，直接用自然语言下任务，比如「阅读这个仓库的 README，总结构建流程」「把 utils.ts 里的这个函数补上单测」。它会自己读文件、改代码、跑命令，每一步在界面上可见，敏感操作会请求你的确认；如果它请求执行某条命令，界面上会列明具体内容，选允许或拒绝即可。验证跑通的标准：它能正确读出你项目里的文件内容，并且完成一次真实的文件修改。

第四步：日常使用的关键功能

斜杠命令：界面内输入 / 前缀可调用内置命令（配置、主题、会话管理等），完整列表见随仓库附带的用户指南。
权限模式：可以控制它自动执行命令的激进程度，刚上手建议保持每次确认，跑顺了再放宽。
无头模式（headless）：用脚本方式调用，适合接入 CI 或批处理任务。
MCP、skills、hooks：官方用户指南覆盖了 MCP 服务器、技能、插件与钩子配置，想深度定制的从文档入手。
沙箱与权限控制：官方支持沙箱执行与细粒度权限，处理敏感项目时建议开启，限制它能碰的文件范围和命令白名单。
编辑器集成：支持通过 Agent Client Protocol（ACP）嵌入编辑器，习惯 IDE 工作流的人不必离开现有环境，终端与编辑器两边都能指挥它。

官方文档站是 docs.x.ai/build/overview，随仓库附带的用户指南则在 crates/codegen/xai-grok-pager/docs/user-guide/ 目录，涵盖快捷键、斜杠命令、配置、主题、MCP、skills、插件、hooks、headless 与沙箱等章节，想深入配置的直接看这两处。

常见报错与踩坑速查

现象	原因	解法
grok 命令不存在	安装脚本没有写入 PATH	重开终端；仍无效则手动把安装目录加入 PATH
浏览器授权后终端无反应	本地回调被拦截	检查是否有安全软件拦截本地端口，重跑 grok 再试
请求超时或连不上	x.ai 域名访问受限	先解决网络链路，再使用工具
版本过旧报接口错误	工具迭代很快	重新执行安装脚本升级到最新版，或查 changelog
源码构建报找不到 protoc / dotslash	缺 DotSlash 或 protoc 未就绪	先 cargo install dotslash 并确保在 PATH，protoc 由 bin/protoc 经 DotSlash 解析
想提 PR 被拒绝	仓库不接受外部贡献，只读同步	通过官方渠道反馈，不要在 fork 上提 PR
仓库代码和实装版本对不上	仓库是从内部 monorepo 周期性同步的镜像	以 changelog 和安装版行为为准，别把镜像当实时源码

上手建议

第一次用别上来就交给它大重构。拿一个小仓库让它跑「读代码、写单测、修一个小 bug」的闭环，观察它改文件和执行命令的方式，确认权限机制后再扩大使用范围。跑过两三个项目后，再把重复性高的工作固化成 skills 或 hooks，效率提升会非常明显。遇到行为不符合预期时先查官方文档再动手改配置。

常见问题

Grok Build 免费吗？

答：工具本身开源免费（Apache 2.0，源码在 GitHub xai-org/grok-build），但模型调用需要 x.ai 账号，按 SuperGrok 订阅额度或 API 用量计费。

Windows 能用吗？

答：可以。官方提供 PowerShell 安装脚本；从源码构建时 Windows 属于尽力支持、未经完整测试，建议 Windows 用户走官方安装脚本。

它会把我的代码传到哪里？

答：它需要把上下文发给 x.ai 的模型服务来完成任务，这是云端 Agent 的普遍机制。有保密要求的代码请先确认公司合规政策，善用沙箱与权限配置控制执行范围。

Grok Build 和 Claude Code 怎么选？

答：编码能力两者同一梯队，选型更多取决于你订阅的生态：已有 SuperGrok 订阅或偏好 Grok 模型选 Grok Build，已订阅 Claude 选 Claude Code，切换成本都不高。

能给它提 PR 或提 issue 吗？

答：不能。官方仓库不接受外部贡献，也没有开启 issue 与 pull request 功能，它是从内部 monorepo 周期性同步的只读镜像，反馈要走官方渠道。

可以从源码编译吗？

答：可以，需要 Rust 工具链、DotSlash 和 protoc。macOS 与 Linux 是受支持的构建宿主，Windows 从源码构建未经过测试，产物名为 xai-grok-pager，官方安装版会包装成 grok 命令。