一、GitHub 仓库

仓库地址： https://github.com/xai-org/grok-build

• 组织名：xai-org（xAI 官方组织，公司名称在 2026 年 7 月 6 日已从 xAI 更名为 SpaceXAI，但 GitHub 组织名仍为 xai-org）[1]

• 仓库状态：2026 年 7 月 15-16 日开源，Apache 2.0 许可证

• 语言：99.6% Rust，0.4% 其他

• README 显示仓库只有 1 次提交，说明本次公开仓库更像是一次性从内部 monorepo 同步出来的快照

• 开源但不接受外部贡献（CONTRIBUTING.md 明确写明 "External contributions are not accepted"）[2]

• 预编译二进制发布到 macOS、Linux、Windows；源码编译支持 macOS/Linux，Windows 为 best effort [2]

• 编译产物名为 xai-grok-pager，官方安装时作为 grok 命令使用 [2]

---

二、架构概述

Grok Build 是 xAI/SpaceXAI 推出的终端原生 AI 编程智能体（terminal-native AI coding agent），定位为 Anthropic Claude Code 和 OpenAI Codex CLI 的直接竞品。2026 年 5 月 14 日以早期 Beta 版本发布，2026 年 7 月 15-16 日全面开源 [3][4]。

整体架构

Grok Build 可理解为“Agent 执行框架 + 终端 UI + 工具层 + 扩展系统”：

• Agent 运行框架（xai-grok-shell）：负责协调任务、上下文组装、模型调用、工具调用分发，是 Grok Build 的核心运行时 [2][5]

• 工具系统（xai-grok-tools）：实现终端命令、文件编辑、搜索等工具能力；README 与第三方分析都提到其包含来自 OpenAI Codex、SST opencode 的 port/移植代码 [2][6]

• 终端 UI（xai-grok-pager）：全屏 TUI，支持鼠标交互、滚动历史、提示输入、模态窗口、内联 Diff 查看器 [2][5]

• 工作区管理（xai-grok-workspace）：文件系统、版本控制、执行、检查点等能力 [2]

GitHub README 的结构可概括为：

Plain Text

Terminal TUI（xai-grok-pager）
    ↓
Agent Runtime（xai-grok-shell）
    ↓
Tools（xai-grok-tools）→ Terminal、File Edit、Search 等
    ↓
Workspace（xai-grok-workspace）→ 文件系统、VCS、执行、检查点

同时，项目支持 ACP（Agent Client Protocol）嵌入编辑器，并支持 headless 模式用于脚本、CI/CD 自动化 [2][5]。

---

三、核心功能与特性

3.1 多智能体并行架构（核心差异化）

第三方分析称，Grok Build 的并行多 Agent 能力是其重要差异化特征之一 [3][4]：

• 复杂任务可拆分为子任务，由多个子 Agent 并行处理

• 第三方资料称最多支持 8 个并发子 Agent，每个可在隔离的 Git worktree 中工作

• 有资料称 SuperGrok Heavy 订阅提供更高规模的“专家模式 AI 代理”协作能力，但该说法来自第三方整理，不同来源口径不完全一致 [3][4]

• 协调者 Agent 负责合并、验证各子 Agent 的结果

3.2 Plan Mode（计划审核模式）

Grok Build 强调“先规划、再执行”的安全机制 [3][4][7]：

• 复杂任务会先生成结构化计划

• 用户可审核、修改、重写计划

• 批准后才开始文件修改

• 修改以 Diff 形式展示，供开发者审查

• 该模式与 Claude Code、Codex CLI 的自主执行方式形成对比，强调 human-in-the-loop

3.3 配置系统

Grok Build 的官方文档路径为：

• https://docs.x.ai/build/overview

在可用抓取内容中，第三方分析和官方仓库信息显示，本地优先运行可通过 config.toml 驱动配置，开发者可以自行编译、指向本地推理并控制工具链行为 [1][5][6]。

实际配置内容包括：

• 配置本地推理模型

• 配置 API Key

• 配置 MCP 服务器

• 配置 Skills、Plugins、Hooks

• 配置工作流规则

3.4 工具系统

Grok Build 的工具层覆盖：

• 终端命令执行

• 文件读写与编辑

• 代码搜索

• 网络搜索

• Git 相关操作

• 工作区管理、版本控制、检查点

README 中 crates/codegen/xai-grok-tools 即为工具实现所在目录；第三方文章还提到该目录中存在来自 openai/codex 和 sst/opencode 的工具 port [2][6]。

3.5 扩展系统

Grok Build 的扩展生态包括 [2][5][6]：

• Skills（技能）：可打包、安装和复用的能力模块

• Plugins（插件）：扩展 Agent 能力

• Hooks（钩子）：在 agent 生命周期关键点执行自定义逻辑，如编辑前、编辑后、命令执行前、命令执行后、错误处理等

• MCP Servers（Model Context Protocol）：连接外部工具和数据源

• ACP（Agent Client Protocol）：允许外部编辑器、UI 或代理将 Grok Build 作为后端服务调用

3.6 模型集成

关于模型，不同资料口径存在差异，需要区分官方仓库、官方博客与第三方资料：

• 官方 GitHub README 明确 Grok Build 是终端 AI coding agent，但没有直接写明具体使用哪款模型

• The Planet Tools 称 Grok Build 使用 Grok 4.5 驱动自动编码

• AI-bio 称其基于 Grok 4.3 beta，支持 200 万 token 上下文

• Studio Global 称 Grok Build 使用 Grok 4.3 Heavy 16-agent 架构，并提到 grok-code-fast-1、grok-build-0.1 等模型口径

• AimaTools 则称默认模型为 grok-build-0....

较稳妥的说法是：Grok Build 是模型无关的 Agent 框架，可通过配置连接 Grok 模型、本地推理或其他兼容端点；

---

四、与竞品的差异化对比

4.1 与 Cursor、Copilot 等 IDE 编程助手的关系

Grok Build 的主要对标对象不是 Cursor、GitHub Copilot 这类 IDE 内补全型工具，而是 Claude Code、Codex CLI、Gemini CLI 这类终端 Agent。

需要注意的是：

• Grok Build 支持 ACP，可嵌入 VS Code、JetBrains 等编辑器

• 但它仍不是典型的 IDE 插件形态

• 其核心交互模式是终端 TUI、命令行和脚本/CI 自动化

• 与 IDE 内补全工具相比，Grok Build 更强调完整开发流程：规划、搜索、编码、测试、Git 提交

4.2 与 Claude Code 的对比

维度	Grok Build	Claude Code
核心界面	全屏 TUI，鼠标交互	CLI + IDE 集成
并行能力	第三方称支持多子 Agent 并行	主要单 Agent 工作流
Plan Mode	计划审核后执行	有 Diff 审查，但通常更偏自主执行
上下文窗口	不同资料口径不一	不同资料口径不一
扩展能力	Skills、Plugins、Hooks、MCP、ACP	MCP、Skills、Hooks 等
模型	可通过配置连接 Grok 或本地推理	主要绑定 Claude 模型
本地优先	支持本地推理和 config.toml 配置	依赖 Anthropic 服务
开源	Apache 2.0，官方仓库同步	开源但公开范围和权限不同
生态成熟度	Beta 阶段	更成熟

4.3 与 Codex CLI 的对比

• Codex CLI 是 OpenAI 的终端 Agent 工具，采用 Apache 2.0 许可证

• Grok Build 工具层中包含来自 OpenAI Codex 和 SST opencode 的 port/移植代码

• Codex CLI 更依赖 OpenAI 模型生态

• Grok Build 强调模型可插拔和本地优先运行

4.4 与 Cursor 的对比

Cursor 是 IDE 级 AI 编程助手，优势在于编辑器集成、实时提示和 IDE 内工作流。Grok Build 的优势不在 IDE 补全，而在终端原生 Agent 流程：

• 更大规模任务规划

• 文件、终端、搜索、测试、Git 等工具链整合

• 支持 headless 和 ACP 嵌入

• 支持本地推理和配置控制

---

五、隐私风波与开源背景

5.1 上传用户代码事件

2026 年 7 月 12 日，安全研究员 Cereblab 发布分析报告，指出 Grok Build 0.2.93 存在以下行为 [1][8][9]：

• 会将读取到的文件内容，包括 .env 等配置文件发送给 xAI 服务器，不会脱敏

• 会将整个代码仓库打包成 Git Bundle 上传到 SpaceXAI 控制的 Google Cloud Storage Bucket：grok-code-session-traces

• 上传包括完整 Git 提交历史，甚至包含已从工作树中删除的密钥

• 在一个约 12GB、Agent 未实际读取的测试仓库中，模型推理通道仅传输约 192KB，而 /v1/storage 上传约 5.10GiB，约 27,800 倍差距

• 该上传行为由全局标志 disable_codebase_upload 控制，默认开启，且与用户是否开启“改进模型”选项无关

5.2 马斯克回应

马斯克公开承认：“确有此事”，并承诺“任何数据都不会留下（zero anything whatsoever will remain）” [8][9]。

5.3 开源作为信任修复

本次开源与隐私风波存在直接关联：

• 开源使开发者可以审计 Grok Build 如何构建上下文、解析模型响应、调度工具调用

• 本地优先运行让数据可以不经过 xAI/SpaceXAI 服务器

• config.toml 使模型、工具、工作流配置可控

• 官方还重置了用户服务器端使用限制 [1][8]

但 36氪等中文报道也指出，这次开源被部分人视为对隐私争议的补救：代码公开并不能直接证明此前上传的数据已经被删除，也无法替代服务器侧审计 [8]。

---

六、独特设计模式总结

1. Agent 框架与模型解耦
   Grok Build 的核心不是单纯依赖某一款模型，而是通过框架把模型调用、工具调用、文件编辑、命令执行、Git 工作区和扩展系统组合起来。

2. 本地优先运行模式
   官方公开资料显示，Grok Build 支持本地编译、本地推理、config.toml 配置，为敏感代码和本地环境提供了更强控制力。

3. Plan Mode 作为安全闸门
   复杂任务先规划、审核、批准，再执行文件修改，并以 Diff 形式呈现，形成更明确的人工审查机制。

4. 多子 Agent 并行执行
   第三方资料称 Grok Build 支持多子 Agent 并行，适合大型、可拆分的工程任务；该能力是其主要差异化方向。

5. ACP 协议支持
   Grok Build 可通过 Agent Client Protocol 嵌入编辑器或外部系统，使其不只是独立 CLI，也可作为后端 Agent 服务。

6. Skills / Plugins / Hooks / MCP 扩展体系
   工具层、扩展层、生命周期钩子和外部协议共同构成 Grok Build 的可扩展性。

7. 从内部 monorepo 同步的开源模式
   GitHub README 明确仓库是周期性从 SpaceXAI monorepo 同步，且不接受外部贡献，因此本次开源更像是“透明化发布 + 可审计发布”，而非完全社区驱动项目。

---

主要来源

1. The Planet Tools, “SpaceXAI Open-Sources Grok Build: Its Rust Coding Agent Goes Fully Open and Local (July 2026)”, Why SpaceXAI Just Open-Sourced Grok Build (And Went Local) | ThePlanetTools.ai

2. GitHub, xai-org/grok-build, https://github.com/xai-org/grok-build

3. AI-bio, “Grok Build – xAI推出的终端原生AI编程智能体与多智能体开发工具”, Grok Build – xAI推出的终端原生AI编程智能体与多智能体开发工具 | AI工具箱

4. Studio Global, “xAI Grok Build Arrives: Parallel Agents and Plan Mode Shake Up Terminal Coding”, xAI Grok Build Arrives: Parallel Agents and Plan Mode Shake Up Terminal Coding | Answer | Studio Global AI

5. Remio, “xAI Open Sources Grok Build Coding Agent and Terminal Interface”, https://www.remio.ai/post/xai-open-sources-grok-build-coding-agent-and-terminal-interface-but-local-control-comes-with-limits

6. El Solitario, “xAI Publishes Grok Build’s Code on GitHub, Its Rust CLI”, Grok Build: xAI's Code CLI on GitHub

7. CSDN, “【2026保姆级】手把手教你安装使用 Grok Build 并说明使用次数限制”, 【2026保姆级】手把手教你安装使用 Grok Build 并说明使用次数限制-CSDN博客

8. 36氪 / CSDN, “被曝上传用户代码后，马斯克官宣开源Grok Build，GitHub上线即斩获7.7k Star”, 被曝上传用户代码后，马斯克官宣开源Grok Build，GitHub上线即斩获7.7k Star-36氪

9. CSDN 极客头条, “上传用户数据事件后，马斯克宣布开源 Grok Build 编程 AI 智能体”, 实习生日薪5500元，DeepSeek工资待遇登热搜；苹果AI国行版已过审，接入千问、百度；曝GPT-5.6 Sol会擅自删除用户文件 | 极客头条-CSDN博客

10. 腾讯云开发者社区, “硬核开源！马斯克放出 Grok Build 全部家底：80 万行代码 + 完整提示词一览无余”, 硬核开源！马斯克放出 Grok Build 全部家底：80 万行代码 + 完整提示词一览无余-腾讯云开发者社区-腾讯云

11. 极客网, “马斯克旗下xAI宣布开源Grok Build编程AI智能体框架”, https://www.fromgeek.com/info/723291.html

12. AimaTools, “Grok Build Complete Guide: xAI's Multi-Agent Coding CLI (2026)”, Grok Build Complete Guide: xAI's Multi-Agent Coding CLI (2026)