[!info] related notes

• 相关 MOC: Coding Agent MOC, OpenAI Codex MOC, Claude Code MOC
• 关系笔记: xAI Grok Build
• 相近工具: OpenAI Codex, Claude Code, OpenCode

xAI Grok Build MOC

xAI 开源的终端 AI 编码智能体（Rust / Apache 2.0），对标 Claude Code 与 Codex CLI，local-first，单二进制 grok。

这张地图覆盖什么

• Grok Build 的产品定位与开源背景
• 四层架构（TUI / 运行时 / 工具 / 工作区）
• 安装方式与配置体系
• 使用模式（交互、无头、Plan、并行、ACP、本地模型）
• 与 Codex / Claude Code / OpenCode 的关系

从这里开始

1. xAI Grok Build — 产品概览、架构、安装、配置、使用
2. Coding Agent MOC — coding agent 通用能力模式
3. Coding Agent 权限模式 — Plan / 审批 / 安全边界
4. Coding Agent GitHub 集成 — PR / CI 协作
5. Coding Agent Code Review — 本地与 PR 审查

产品定位

• 厂商：xAI；底层模型：Grok 4.5
• 形态：终端 AI 编码智能体，单二进制 grok
• 开源：2026-07-14~16，Apache 2.0，约 84 万行 Rust
• 对标：Claude Code、Codex CLI

架构分层

层	crate	职责
TUI	xai-grok-pager	全屏终端界面、渲染、鼠标
运行时	xai-grok-shell	执行循环：TUI / 无头 / ACP
工具	xai-grok-tools	编辑、命令、搜索、沙箱、检查点
工作区	xai-grok-workspace	文件系统与 VCS

→ xAI Grok Build - 架构分层

安装与配置

安装

• scoop install grok-cli（Windows，main bucket）
• curl -fsSL https://x.ai/cli/install.sh | bash（macOS / Linux）
• irm https://x.ai/cli/install.ps1 | iex（Windows）
• 源码编译：cargo build -p xai-grok-pager-bin --release

配置

• 认证：XAI_API_KEY 或首次浏览器授权
• 本地模型：~/.grok/config.toml 自定义 [model.*] + [models].default
• 规则文件：直接读取 AGENTS.md，兼容 Claude Code 生态

→ xAI Grok Build - 配置

使用模式

模式	命令
交互 TUI	grok
无头任务	grok -p "..."
Plan 模式	grok plan "..."
并行子代理	grok --max-agents 8 "..."
文件引用	grok @src/main.rs "..."
本地模型	grok -p "..." -m my-local
CI 输出	grok -p "..." --output-format streaming-json

共享能力（coding agent 通用模式）

能力	笔记
Skills	Coding Agent Skills
Subagents	Coding Agent Subagents
权限模式	Coding Agent 权限模式
云端执行	Coding Agent 云端执行
IDE 集成	Coding Agent IDE 集成
GitHub 集成	Coding Agent GitHub 集成
Code Review	Coding Agent Code Review
自动化	Coding Agent 自动化
Git Worktree	Coding Agent Git Worktree

相近工具

• OpenAI Codex — 工具语义被 Grok Build 直接移植
• Claude Code — AGENTS.md / MCP / Hooks 生态兼容
• OpenCode — 同样被移植工具实现，开源终端 agent 路线

Related notes

• xAI Grok Build
• Coding Agent MOC
• OpenAI Codex MOC