grok 到底是什么 · 一个开源的终端编码 Agent
Grok Build 是 xAI 开源的终端编码 Agent（TUI，Rust 写成）。这一章讲清它是什么、能做什么、三种运行形态，以及它在「Claude Code」与「手搓最小 Agent」之间的坐标——为什么值得逐行读它的源码。
作者 David更新于 第 1 篇（共 60 篇）
grok 到底是什么 · 一个开源的终端编码 Agent
一句话：Grok Build 是 xAI 开源的终端编码 Agent。命令行叫 grok，跑起来是一个全屏终端 UI（TUI），能读懂你的代码库、改文件、执行 shell 命令、搜网页、管理长时间运行的任务。整个项目用 Rust 写成，源码公开在 github.com/xai-org/grok-build。
它能做什么
和你已经熟悉的 Claude Code 是同一类东西——一个「住在终端里、能动手改你项目」的 AI 编程助手。核心能力：
- 理解代码库：不是把整个仓库塞给模型，而是有一套工作区抽象 + 代码库图谱（后面第 3 部分细讲）。
- 改文件：内置多种编辑工具，并用 diff 追踪保证不踩掉你手上的改动。
- 跑命令：在真正的伪终端（PTY）里执行 shell，可选 OS 级沙箱隔离。
- 搜网页、跑长任务、开子任务：web 搜索、后台任务、subagent 并行。
三种运行形态
同一个 agent 运行时，套三张不同的「皮」：
| 形态 | 怎么跑 | 场景 |
|---|---|---|
| 交互式 TUI | 直接 grok | 日常在终端里对话、看它改代码 |
| Headless | grok -p "..." | 脚本 / CI，管道进管道出 |
| Agent 模式（ACP） | 通过 Agent Client Protocol | 嵌进编辑器，由 IDE 驱动 |
这三种形态共享同一套内核，区别只在最外层的输入输出通道——这本身就是一个值得学的架构决策，我们在第 6 部分会看它是怎么做到的。
它在哪儿：三个坐标
读这本之前，先把 grok 放到你已知的坐标系里：
- 对比 Claude Code：Claude Code 闭源，站里那本手册是基于官方文档整理的「怎么用」。grok 开源，所以我们能越过文档，直接读「它怎么实现」。
- 对比 《从 LLM 到 Coding Agent》 的教学实现：那本从零手搓了一个最小可运行的 agent，为的是把概念讲透。grok 是一份生产级完整实现——同样的概念，落到真实工程里会长成什么样。
- 对比你自己：如果你也想写一个 agent，grok 是一份高质量的「参考答案」。
这也是为什么这本和 《从 LLM 到 Coding Agent》 配对读最划算：一边是「教学最小实现」，一边是「生产实现」，同一件事两种写法对照，比单看任何一本都清楚。
先建立一张「毛胚地图」
后面所有章节，都是在往这张图里填细节。一次对话，数据大致这样流动：
图表加载中…
- 最外层是 TUI（第 5 部分）；
- 中枢是 Agent 运行时（第 1 部分）——它把「和模型对话」与「调用工具」这两件事转成一个循环；
- 工具落到具体的能力 crate（第 2、3 部分）；
- 模型这一侧是采样器（第 1 部分）。
下一章先把它装起来跑一遍，让这张图有实感。