xAI Grok Build
xAI 开源的终端 AI 编码智能体（Rust / Apache 2.0），对标 Claude Code 与 Codex CLI，支持交互式 TUI、无头模式、Plan、并行子代理、MCP、ACP 与本地模型。
[!info] related notes
xAI Grok Build
它是什么
Grok Build 是 xAI 推出的终端 AI 编码智能体，以命令行为核心，通过 Agent 自主完成”理解代码 → 修改文件 → 执行命令 → 验证”的完整开发流程。它于 2026 年 7 月 14–16 日正式开源，仓库 xai-org/grok-build 约 84 万行 Rust，采用 Apache 2.0 许可证。
定位上，它最接近 Anthropic 的 Claude Code 与 OpenAI 的 Codex CLI：local-first（默认优先在本地机器运行），单二进制分发（grok），全屏 TUI 交互。底层模型基于 xAI 的 Grok 4.5，API 定价为输入 $0.20 / 百万 token、输出 $1.50 / 百万 token（SWE-Bench Verified 得分 70.8%，256K 上下文窗口）。
[!warning] 开源背景：一次隐私风波 开源的直接诱因是一起隐私事件：安全研究员发现 Grok Build 在运行时会把整个工作目录（含
~/.ssh、密码管理器数据库、个人文档）静默上传到 xAI 的服务器，即便开启隐私设置也不例外。开源后 xAI 重置了所有用户的服务端限制，并支持完全本地运行（不再受云端额度限制）。在把敏感仓库交给任何 coding agent 前，都建议先读源码、用grok inspect核对，必要时抓包确认数据路径。
架构：四个分层
Grok Build 把能力拆成清晰的分层——单二进制但内部解耦，便于审计单个组件：
| 层 | crate | 职责 |
|---|---|---|
| TUI | xai-grok-pager | 全屏终端界面：滚动回放、提示栏、渲染、鼠标支持 |
| Agent 运行时 | xai-grok-shell | 执行循环，三种形态：交互式 TUI / 无头（脚本与 CI）/ leader-stdio（被 IDE 通过 ACP 嵌入） |
| 工具集 | xai-grok-tools | 文件编辑、终端执行、网页搜索、沙箱执行、检查点 |
| 工作区 | xai-grok-workspace | 文件系统与 VCS 编排 |
THIRD_PARTY_NOTICES.md 明确说明：其工具实现移植自 OpenAI Codex（apply_patch、grep_files、list_dir、read_file）与 sst/opencode（bash、edit、glob、grep、read、skill、todowrite、write），按 Apache §4(b) 标注修改并兼容授权。换言之，Grok Build 在工具语义上刻意兼容 Codex / OpenCode 生态，而非另起一套。
核心能力
| 能力 | 说明 |
|---|---|
| 代码库理解 | 读项目结构、自动发现依赖/配置/测试目录，解释调用链与架构 |
| 代码修改 | 编辑文件、运行命令、跑测试、按错误继续修复 |
| 交互式 TUI | 全屏界面，鼠标操作、无闪烁滚动、斜杠命令 |
| 无头模式 | grok -p "..." 直接喂提示，适合脚本与 CI |
| Plan 模式 | 先规划再执行（→ 权限模式） |
| 并行子代理 | --max-agents N 启动多个子智能体并行干活 |
| MCP 扩展 | 支持 Model Context Protocol，挂载外部工具 / 企业内网 / 私有知识库 |
| ACP 接入 | 通过 Agent Client Protocol 被编辑器作为原语嵌入 |
| 检查点回滚 | 关键步骤打快照，可回滚代码与对话上下文 |
| AGENTS.md 兼容 | 直接读取项目 AGENTS.md，复用规则、插件、Hooks、MCP 配置 |
安装
[!tip] 三种方式 官方二进制（受 xAI 服务条款约束，scoop manifest 的 license 标为 Proprietary）、官方安装脚本、或从 Apache 2.0 源码自编译（后者才是真正开源版）。
1. scoop（Windows，已验证可用）
scoop install grok-cli # main bucket，bin = grok.exe[!caution] 别装错包
scoop search grok还会命中grok（aegoroff 的 regex 宏引擎，需手动加 aegoroff bucket）、ngrok、sigrok——它们与 Grok Build 无关。要装的是grok-cli。
2. 官方脚本
# macOS / Linux / Git Bash
curl -fsSL https://x.ai/cli/install.sh | bash
# Windows PowerShell（管理员推荐）
irm https://x.ai/cli/install.ps1 | iex3. 源码编译（要真正开源版时）
git clone https://github.com/xai-org/grok-build.git
cd grok-build
cargo build -p xai-grok-pager-bin --release # 产物 target/release/xai-grok-pager需要 Rust（版本由 rust-toolchain.toml 锁定）与 protoc（经 dotslash 提供，cargo install dotslash）。官方安装脚本会把产物重命名为 grok。
配置
认证
首次运行 grok 会打开浏览器做 xAI 账号授权；无浏览器 / CI 环境改用环境变量：
export XAI_API_KEY="xai-..." # PowerShell: $env:XAI_API_KEY="xai-..."API key 在 https://console.x.ai 创建。
本地模型（local-first）
开源后支持把推理端点指向自己的模型，脱离默认云端路径。编辑 ~/.grok/config.toml（Windows：%USERPROFILE%\.grok\config.toml）：
[model.my-local]
model = "model-id"
base_url = "https://api.example.com/v1"
name = "My Local Model"
env_key = "API_KEY"
[models]
default = "my-local"校验与调用：
grok inspect # 确认模型发现
grok -p "Hello" -m my-local # 用本地模型规则文件
Grok Build 直接读取 AGENTS.md（兼容 Claude Code 生态），自动复用项目级指令、插件、Hooks 与 MCP 配置，迁移成本接近零。
使用
grok # 进入项目目录后启动全屏 TUI
grok -p "Explain the architecture" # 无头模式，一次性任务
grok plan "refactor callbacks to async/await" # 先规划再执行
grok --max-agents 8 "add TypeScript types" # 并行子代理
grok @src/main.rs "walk me through this file" # @ 引用具体文件
grok -p "review this PR" --output-format streaming-json # CI 结构化输出相近工具与关系
- OpenAI Codex：Grok Build 的工具实现直接移植自 Codex CLI，二者在编辑 / 搜索 / 文件操作语义上高度一致。
- Claude Code：生态兼容目标，Grok Build 复用其
AGENTS.md、MCP 与 Hooks 约定。 - OpenCode：同样被移植工具实现（bash / edit / glob / grep 等），开源终端 agent 的另一条路线。
| 维度 | Grok Build | Codex CLI | Claude Code |
|---|---|---|---|
| 厂商 | xAI | OpenAI | Anthropic |
| 开源 | Apache 2.0（2026-07） | 开源（Apache 2.0） | 闭源（CLI 开源讨论中） |
| 语言 | Rust | Rust / TS | — |
| 入口 | TUI / 无头 / ACP | TUI / Cloud / IDE | TUI / SDK |
| 模型 | Grok 4.5 | GPT 系列 | Claude 系列 |
| 本地模型 | 支持（config.toml） | 通过中转站 | 通过中转站 |
使用边界
- 适合规则明确、可验证的开发任务：重构、补测试、修 CI、批量改名。
- 不适合独立承担复杂业务边界与架构判断。
- 敏感仓库务必先确认数据不会外传（见上方隐私提示）。
最短记忆方式
Grok Build = xAI 开源的终端 AI 编码智能体（Rust / Apache 2.0），对标 Claude Code 与 Codex CLI；核心是把代码理解 → 修改 → 验证串成闭环，并兼容 Codex / OpenCode 工具语义与 Claude Code 的 AGENTS.md / MCP 生态。