Grok Build 现在指什么
2026 年公开材料里的 Grok Build，是 xAI 面向写代码的可扩展 Agent：你可以在终端全屏 TUI 里会话，也可以用同一条 grok 命令在脚本或 CI 里无头跑，还可以经 Agent Client Protocol 嵌进别的应用。它不是聊天框里贴代码的页面，也不等于某一个编辑器插件。
公开仓库在 2026 年 7 月开源，GitHub 上的 xai-org/grok-build 是核对命令、配置和发布说明的地方。产品文档入口在 docs.x.ai 的 Build 概述，安装页在 x.ai/cli。本教程只写公开、可核对的用法。
官方概述提过，驱动 Grok Build 的同一模型家族也可以直接走 xAI API。文中会写到 Grok 4.6 曾被公开点名为驱动该产品的模型之一，但具体默认模型、地区和账号门槛会变，不要把旧博客里的名字当成今天的唯一答案。
可用性、登录方式和是否需要付费档位以官方页面和你的账号为准。本教程不编造硬性的 SuperGrok 付费墙，也不写价格。遇到冲突，以官方文档和本机实测为准。
- 交互式 TUI：在项目目录运行 grok，全屏会话、计划模式、斜杠命令。
- 无头模式：grok -p 把一次任务交给脚本、流水线或机器人。
- ACP：把同一套 Agent 嵌进其他编辑器或应用，而不是再学一套产品。
- 本机配置常见落在 ~/.grok/config.toml（Windows 为用户目录下的 .grok\config.toml）。
这套教程写给谁
给你已经会 git、会开终端、想让 Agent 在自己仓库里干活的人。不要求你先背完提示词工程，也不要求你丢掉现在的编辑器。
如果你只想在网页里问问语法，用普通对话产品就够。如果你的主力是 Codex CLI 或其他 Agent，也可以读本系列：对照章会说明重叠和差异，不必改宗。
如果你从不打开仓库、只要一行片段，可以跳过。如果你会批准或丢掉一份改了你文件的补丁，就留下。
- 要在本机仓库跑可复查改动的应用开发者。
- 已经写过 README，想把约定写进 Agent 能读的文件的人。
- 需要把 issue、文档或浏览器接到 Agent 上的人（后面的 MCP 章）。
- 要在 CI 里用无头命令做只读检查或起草补丁的人。
三种用法，一份配置习惯
官方概述把交互 TUI、无头脚本和 ACP 写成同一产品的不同入口。登录态、config.toml、AGENTS.md、技能、插件、钩子和 MCP 常常是共用的。换窗口不等于换一套完全不同的 Agent。
选入口看你待的时间：整天在终端就用 TUI；任务已经写进脚本或机器人就用无头；人已经住在别的编辑器、只想嵌一层 Agent，再看 ACP。本教程每章都按先 TUI、再对照无头来写。
实用规则：先在一个入口完成登录或 API 密钥，再用同一入口做第一章任务。只有出现一份可复查的 diff 之后，才打开第二个入口。
- 先打通一个入口，不要同一天配 TUI、CI 和嵌入。
- 同一仓库用同一份 AGENTS.md，不要按客户端复制三份互相矛盾的规矩。
- 技能、插件、钩子和 MCP 配好后，通常各入口都能看见，具体以 grok inspect 为准。
建议学习顺序
短功能介绍带不来会用的人。下面八章按依赖排：先搞清产品，再安装，再做一件能复查的小事，然后才读配置、写技能和外部工具。
每章有多节、清单和 FAQ，章末有上一章和下一章。不必一天读完。卡在登录或进程时，直接跳排错章，再回来。
若 grok 已经能进 TUI，安装章可以略读，直接去做第一个任务。若登录或密钥已经坏了，先跳排错章。
- Grok Build 是什么：分清三种用法和它不是什么。
- 安装与登录：官方脚本、浏览器授权或 API 密钥，并做一次无害自检。
- 第一个任务：计划模式、小范围改动、看 diff、回退。
- 配置与说明书：config.toml、grok inspect、AGENTS.md。
- 技能与插件：按任务加载的剧本，以及 /skillify。
- MCP：只有仓库外的系统才接线。
- 和 Codex 怎么选：按工作界面选，而不是按热搜。
- 排错：登录、PATH、inspect、MCP、技能、计划门闩。
这套教程实际要花多久
一个专注的下午，通常够装通、做一件小事、写一页 AGENTS.md。技能和 MCP 更适合第二次坐下来，那时你已经有一份信得过的 diff。
不要把“学完 Grok Build”排成周末重写生产应用。这是习惯课：小任务、写禁区、一次只接一个工具。
- 安装加只读自检：网络和账号顺利时通常一小时内。
- 第一个可复查任务：再一小时，大部分时间在看计划与 diff。
- 读一遍 grok inspect 并写 AGENTS.md 初稿：三十分钟写事实。
- 一个技能加一条只读 MCP：留到后面一个晚上。
先用谨慎的口气看一眼命令
公开安装页给出过一条 curl 到 x.ai/cli/install.sh 的装法。装完后常见第一步是进入项目目录运行 grok。可执行文件名和参数曾经改过；从你今天打开的安装页抄，不要从旧 gist 抄。
无头用法公开写成 grok -p，并可加 --output-format streaming-json。第一次会话更适合在 TUI 里问只读问题。若命令找不到，那是安装或 PATH，不是模型。
- 在当天的 x.ai/cli 核对安装命令。
- 装完新开终端，让 PATH 刷新。
- 先问当前目录，再谈写权限。
这页总览想挡住的错
昂贵的错是协作上的，不是语法上的：第一天接十条 MCP、跳过计划模式直接改生产文件、以及把 API 密钥写进仓库。
更安静的错是克隆别人的 AGENTS.md。说明书里写着另一个团队的测试命令，Agent 会很自信地失败。
- 三个入口都装了，却没有一个能列出文件。
- 第一次对话就贴生产令牌。
- 因为演示视频看起来简单，就跳过第一个任务章。
- 把“开源了”理解成“没有账号或密钥要求”。
进入第一章前的总览清单
不需要完美环境。你需要一个自己的仓库、一种回退办法，以及先用哪扇门的决定。
- 选定一个入口：TUI、无头脚本，或以后再谈的 ACP。
- 确认这份仓库允许送进外部 Agent。
- 能跑 git status，并有回退计划。
- 另开标签页收藏当天的官方 Build 文档和 x.ai/cli。
- 入口选定了再打开下一章。
本教程怎么写、怎么读
正文是本站原创概述，不是官方文档的粘贴。命令示例只用常见公开装法。包版本、菜单文案、订阅名称请打开当天的官方页面核对。
本站同时提供中文默认 URL 和英文前缀版。章节会链到本站 MCP 和技能目录，那些页面是元数据，不会在浏览器里替你执行安装。
本系列插图是为本教程生成的示意图。它们是真正的 img 标签，不是 CSS 背景，搜索引擎和读屏都能看见。
- 不编造星标、价格、内部功能名或硬性付费墙。
- 不要求你同时打开写权限和十条 MCP。
- 密钥只放环境变量或系统钥匙串，不写进仓库。
- 官方文档与本教程冲突时，以官方和你本机实测为准。
读完总览接下来做什么
先去下一章，把产品边界说清再安装。若三种用法你已经分得清，可以直接去安装章。
把这页总览留作目录。每章结尾都有上一章、下一章，以及八课清单。