xAI 开源 Grok Build：Rust 编写的终端编程代理

7/15/2026开源RustxAIGrok Build编程代理

什么是 Grok Build

Grok Build 是 xAI 旗下 SpaceXAI 团队开发的终端编程代理。它运行在全屏 TUI 中，能理解代码库上下文、编辑文件、执行 shell 命令、搜索网页、管理长任务。支持三种运行模式：交互式 TUI、无头模式（用于 CI/CD 脚本自动化）、以及通过 Agent Client Protocol（ACP）嵌入到编辑器中。

2026 年 7 月，xAI 宣布将 Grok Build 完整开源，源码以 Apache License 2.0 发布在 GitHub。整个项目用 Rust 编写，代码量占比 99.6%。

Grok Build TUI 界面

开源意味着什么

xAI 在官方公告中给出了三个理由：

第一，透明性。开发者可以直接阅读源码，看到从上下文组装（context assembly）到工具调用分发（tool-call dispatch）的完整链路是怎么实现的。

第二，可扩展性。Grok Build 支持 skills、plugins、hooks、MCP servers、subagents 等扩展机制，开源后源码成为这些机制如何加载和调用的权威参考。

第三，本地优先运行。开源后，开发者可以自行编译 Grok Build，指向自己的本地推理服务，通过 config.toml 文件配置全部参数。不再依赖 xAI 的云端推理基础设施。

代码仓库结构

仓库从 SpaceXAI monorepo 定期同步，核心由五个 crate 组成：

Crate职责
xai-grok-pager-bin编译入口，构建 grok 二进制（artifact 名 xai-grok-pager）
xai-grok-pagerTUI 渲染层：滚动缓冲区、提示符、模态框、渲染引擎
xai-grok-shellAgent 运行时，包含交互式、stdio、headless 三种入口
xai-grok-tools工具实现：终端、文件编辑、搜索等
xai-grok-workspace宿主文件系统、VCS、命令执行、检查点机制

THIRD-PARTY-NOTICES 文件显示，xai-grok-tools 移植了 openai/codex 和 sst/opencode 的工具实现，在 Apache 2.0 第 4(b) 条款下附带了变更通知。第三方代码保留原始许可证。

一个细节：根 Cargo.toml（workspace members、依赖版本、lints、profiles）是生成的，开发者应将其视为只读，修改 per-crate 的 Cargo.toml。

从源码构建

依赖要求

  • Rust 工具链（由 rust-toolchain.toml 指定版本，rustup 自动安装）
  • protoc（proto 代码生成，仓库内置 bin/protoc 或回退到 PATH 上的 protoc）
  • macOS 和 Linux 是受支持的构建平台；Windows 构建是 best-effort，未在此仓库中测试

构建命令

bash
cargo run -p xai-grok-pager-bin              # 编译并启动 TUI
cargo build -p xai-grok-pager-bin --release  # release 二进制
cargo check -p xai-grok-pager-bin            # 快速验证

编译产物名为 xai-grok-pager，官方安装脚本将其命名为 grok。首次启动时会打开浏览器进行 OAuth 认证。

开发命令

bash
cargo check -p <crate>        # 总是针对特定 crate，全 workspace 构建很慢
cargo test -p xai-grok-config # 单 crate 测试
cargo clippy -p <crate>       # lint 配置在仓库根的 clippy.toml
cargo fmt --all               # rustfmt 配置在仓库根的 rustfmt.toml

快速安装

不想从源码构建的开发者，可以使用官方预编译二进制：

bash
curl -fsSL https://x.ai/cli/install.sh | bash   # macOS / Linux / Git Bash
irm https://x.ai/cli/install.ps1 | iex          # Windows PowerShell
grok --version

扩展生态

Grok Build 的扩展机制涵盖五个维度：

  • Skills：可复用的工作流定义，类似 Claude Code 的 skills
  • Plugins：功能插件系统
  • Hooks：生命周期钩子，在特定事件触发自定义逻辑
  • MCP Servers：Model Context Protocol 服务器集成，连接外部工具
  • Subagents：并行子代理，用于研究、构建、审查等任务

用户指南随 pager crate 发布，位于 crates/codegen/xai-grok-pager/docs/user-guide/ 目录，涵盖快速入门、键盘快捷键、slash 命令、配置、主题、MCP 服务器、skills、plugins、hooks、headless 模式、沙箱等。

在线文档地址：docs.x.ai/build/overview。

使用限制重置

SpaceXAI 在开源公告同日宣布，已重置所有用户的 Grok Build 使用限制。这并非首次重置，2026 年 5 月底因缓存效率问题导致用户快速触及限额后，xAI 也曾做过一次全量重置。

开源协议和贡献

代码采用 Apache License 2.0。但仓库的 CONTRIBUTING.md 明确写道：不接收外部贡献（External contributions are not accepted）。这属于"源码可见"（source-available）模式：你可以阅读、fork、自行编译和修改，但无法向上游提交 PR。

技术路线对比

维度Grok BuildClaude CodeCodex CLI
语言RustTypeScriptRust
架构多子代理并行单推理 pass云端沙箱优先
运行模式本地优先本地云端优先
开源Apache 2.0（不收 PR）闭源开源
扩展skills/plugins/MCP/hooksskills/MCPMCP

背景：隐私争议

值得回顾的是，2026 年 7 月 12 日，一位独立研究员发布了对 Grok Build CLI v0.2.93 的网络层分析，发现该版本会将完整的 Git 仓库（包括提交历史）上传到 xAI 的 Google Cloud Storage。Elon Musk 随后在 X 上承诺删除所有此前上传的用户数据，并强调零数据保留（ZDR）和 /privacy 命令始终受尊重。

开源在此背景下具有额外意义：开发者现在可以自行审计代码，确认数据流路径。

来源：x.ai/news/grok-build-open-source · GitHub: xai-org/grok-build（Apache 2.0）

推荐阅读