名字为什么容易混
Grok 这个词既指模型家族，也指聊天产品，现在又加上面向仓库的 Build。同事说“我用 Grok”，你要问他是网页对话、API 调用，还是本机这条 grok 命令。
Grok Build 解决的问题很具体：你把任务说清楚，Agent 去读文件、跑命令、改代码，再把计划和 diff 交给你看。它不是只在光标处补三行的插件。
公开材料把 CLI 安装页和 Build 文档写成同一条产品线。开源仓库让你可以核对流派、issue 和发布说明，但不等于“没有账号要求”。
文中提到的 Grok 4.6 是公开点过名的驱动模型之一。默认模型、自定义模型和 API 上的同名模型可以同时存在。以 grok inspect 和当天文档为准。
三种用法各自擅长什么
交互 TUI 适合你已经在仓库目录、要盯着计划和工具调用。无头适合任务已经写成一句提示、要进脚本或 CI。ACP 适合你不想换编辑器、只想嵌一层 Agent。
官方材料把它们写成同一产品的不同门。配置文件、说明书、技能和 MCP 经常是一份。换窗口通常不是换大脑。
初学只选一扇门。三套同时配，排错时你分不清是登录坏了、PATH 坏了，还是仓库说明书没被读到。
云端聊天和本机 grok 会话都能谈代码，但不一定看见同一批文件。笔记本上未提交的改动，在你进入该目录之前，仍是本地的。
- TUI：适合已经在项目目录里开着终端的人。
- 无头：适合脚本、机器人、CI 里的一次任务。
- ACP：适合把 Agent 嵌进现有应用，而不是再开一个全屏 TUI。
不逛街的情况下怎么选第一扇门
先问自己会在哪看第一份 diff。答案是终端全屏，就从 grok 开始。答案是已经写好的脚本，就先装通再写一条 -p。人已经住在带 ACP 的编辑器，也可以从那里开始，但本教程默认 TUI。
以后再换，比同时调试三个半成品登录便宜。安装章不会要求你把每扇门都配齐。
- 先 TUI：你已经在 shell 里跑测试。
- 先无头：你要把一次只读解释写进脚本。
- 先 ACP：宿主应用已经声明支持该协议。
说明书、技能、MCP 怎么叠
AGENTS.md 是仓库或用户级的常驻说明：语言、测试命令、禁区。技能是按任务才加载的剧本。插件、钩子和市场是扩展层。MCP 是仓库外的手。
先写短说明书，再抽重复任务成技能，最后才接线。反过来会先得到一个会乱调外部系统、却不懂你仓库的 Agent。
把这几层想成：始终在、按需、以及仓库外。把它们混进同一份文件，说明书就会长到没人读。
- AGENTS.md：始终在，保持短。
- 技能与插件：点名、斜杠命令或匹配任务时加载。
- 钩子：在特定生命周期插一段你自己的检查。
- MCP：只给仓库里没有的能力。
Grok Build 不是什么
它不是自动把生产密钥写进仓库的借口，也不是不经 diff 就合并的机器人。你还是作者，Agent 是会跑命令的助手。
它也不等于 Codex CLI、Cursor 或其他编辑器。那些产品可以很好，但配置路径和模型选择不同。对照章再谈取舍。
它也不能代替代码评审，或你们团队的威胁模型。一个会跑命令的 Agent，比聊天框更能干，也更危险。
- 不是不用看 diff 的自动合并。
- 不是官方安全审计。
- 不是本站浏览器里一键安装器。
- 不是“开源了就可以匿名乱改任何仓库”。
什么时候值得打开它
任务能写成“在这些文件里做这件事，用这个命令验证”，就值得。只是问一句语法，用普通对话更快。
仓库越大，越要先写 AGENTS.md。没有说明书的大仓库，Agent 会用平均互联网习惯改你的代码。
第一周适合的任务：补测试、修类型错误、更新清单、起草 PR 说明。不适合的：轮转生产凭证、重写构建，或顺便把仓库整理一下。
- 值得：加测试、修类型错误、按清单开 PR、解释某个目录。
- 先别：生产数据迁移、不经人工看的权限变更。
第一次看命令大概长什么样
安装后，公开文档常展示进入项目目录再运行 grok。第一次启动可能打开浏览器做授权。无头环境则改用环境变量里的 API 密钥。
若 shell 说找不到命令，停在下一章。不要从随机博客再发明第二种安装器。
- 新终端里确认 grok 在 PATH。
- 先进入临时或练习仓库。
- 第一天只读问题比写入强。
关于产品的常见混淆
有人把 Grok Build 收成网页里的聊天模型。这会藏掉本机配置目录、计划模式，以及 MCP 是跑在你机器上的进程。
另一种混淆是把无头模式当成另一套有另一份说明书的 Agent。通常不是。跨入口互相矛盾的规矩能浪费一周。
- 从非官方镜像装二进制。
- 假设网页聊天能看见未同步文件。
- 因为 README 很长就跳过 AGENTS.md。
离开这一章时你该知道
你应该能说出准备用哪扇门，以及这周不会让 Agent 做什么。
- 用自己的话点名三种用法。
- 为安装选定一扇门。
- 写下你已经知道的一条禁区（密钥、生产数据、强制推送）。
- 打开官方文档，再读下一章。
下一步：只装一扇门
安装章会选门、登录或放密钥、做无害自检。仍然不会接 MCP。
若账号或密钥完全走不通，停下来看产品页。本教程不能帮你打开地区或档位。