Grok Build 安装使用完整教程（2026最新版）

本文整理 2026 年最新版 Grok Build 完整教程，涵盖安装配置、登录授权、订阅套餐对比和基本使用四大核心内容。Grok Build 是 xAI 推出的终端（CLI）AI 编程代理工具，跟着这篇教程几分钟就能上手。

什么是 Grok Build

Grok Build 是 xAI 推出的终端（CLI）AI 编程代理工具，专为复杂软件工程任务设计。它支持交互式 TUI（文本用户界面）、Plan Mode（规划模式）、多子代理并行执行、代码编辑、文档生成等功能，目前主要面向 SuperGrok 和 X Premium+ 订阅用户（早期 Beta 版）。

和网页版 Grok 聊天不同，Grok Build 直接在你的项目目录里工作，可以：

读写代码、运行构建和测试
理解整个代码库架构
修复 bug、添加功能、重构代码
通过子代理并行处理复杂任务
集成 MCP、Skills、插件和 Hooks

核心能力一览：

类别	功能
核心能力	读写代码、执行命令、项目分析、日常开发、网页搜索
高级工作方式	子代理并行、Plan Mode、Skills 技能系统、TODO 任务追踪
扩展能力	Office 文档处理、设计文档、代码审查、图片生成、MCP 集成

安装 Grok Build

macOS / Linux

打开终端，执行安装命令：

bash

curl -fsSL https://x.ai/cli/install.sh | bash

安装完成后验证：

bash

grok --version

显示版本号即表示成功。

Windows

以管理员权限打开 PowerShell，执行：

powershell

irm https://x.ai/cli/install.ps1 | iex

验证：

powershell

grok --version

注意：需要稳定的网络连接。安装完成后，还需要 SuperGrok 或 X Premium+ 订阅才能正常使用。

首次启动与登录授权

步骤 1：进入项目目录并启动

bash

cd /path/to/your/project
grok

首次运行会自动打开浏览器进行 xAI 账号授权。

步骤 2：授权 Grok Build

浏览器会弹出授权页面，列出 Grok Build 需要的权限（身份验证、读取资料、API 调用等）。点击「允许」完成授权。

步骤 3：连接成功

授权完成后，页面会显示「连接成功」，你可以关闭此窗口并返回 Grok Build 终端界面。

非浏览器环境（服务器 / 脚本）

如果无法打开浏览器（如远程服务器），可以使用 API Key：

bash

export XAI_API_KEY="xai-你的密钥"
grok

API Key 可在 https://console.x.ai 创建。

订阅要求与套餐对比

Grok Build 目前处于早期 Beta，官方明确仅对 SuperGrok 和 X Premium+ 订阅用户开放。免费 Grok 账号无法使用 Grok Build。

启动 Grok Build 后，如果尚未订阅，界面会提示「A subscription is required」，底部显示 Tier: Free，必须升级后才能进入开发界面。

按 ctrl+g 或选择 Subscribe，会跳转到官方订阅页面：https://grok.com/supergrok?referrer=grok-build

哪些套餐能用 Grok Build？

套餐	月费	Grok Build	推荐度
免费 Grok	$0	❌ 不可用	—
SuperGrok（grok.com 官网）	$30/月	✅ 独家访问	⭐⭐⭐⭐⭐ 最推荐
SuperGrok Heavy	$300/月	✅ 全部功能 + 更高额度	⭐⭐⭐ 重度用户
X Premium+（X/推特）	约 $40/月	✅ 可用	⭐⭐⭐ 已有 X 会员可考虑

注意：grok.com 官网和 X 上的 Grok 额度相互独立。如果你专门要用 Grok Build，建议直接在 grok.com 升级 SuperGrok（$30），比 X Premium+（约 $40）更便宜，且 Grok Build 功能标注为 SuperGrok 独家。

Grok Build 功能与使用次数对比

下表重点对比 Grok Build CLI 在各套餐下的功能差异和使用上限：

项目	免费 Grok	SuperGrok（$30/月）	SuperGrok Heavy（$300/月）	X Premium+（约 $40/月）
Grok Build 访问	❌ 无法进入	✅ 独家访问	✅ 全部功能	✅ 可用（独立体系）
CLI 会话 / 轮次	不可用	Fair Use，日常开发基本够用	最高使用上限	独立额度，与官网不共享
单次上下文窗口	—	最高约 512K tokens	更大，适合超长任务	与 grok.com 独立计算
并行子代理	—	支持多子代理并行 + 工作树隔离	最多 16 个专家模式 AI 代理	支持并行，具体上限独立
Plan Mode（规划模式）	—	✅ 先规划再执行	✅	✅
Headless 无头模式	—	✅ 支持脚本 / CI/CD	✅	✅
MCP / Skills / 插件	—	✅ 完整支持	✅ + 更高并发	✅
无闪烁 CLI	—	✅	✅	✅
峰值时段优先权	—	✅ 优先排队	✅ 最高优先级	✅（X 体系内）

使用次数关键说明

Grok Build 没有单独公布的「每天 X 次」固定数字，官方采用 Fair Use（公平使用）机制：正常使用几乎感觉不到限制，但连续高强度、长时间跑大型任务（尤其是多子代理并行 + Plan Mode 长链推理）时，可能触发短时软限流，稍后自动恢复。

免费用户完全无法使用 Grok Build，不是额度少的问题，而是功能入口直接锁定，必须订阅 SuperGrok 或 X Premium+
SuperGrok 的「无限」并非绝对无限：网页端生图/视频、CLI 长会话都属于 Fair Use 范畴，重度连续使用可能遇到 limit reached
子代理数量：SuperGrok 支持多子代理并行（日常任务一般 2～8 个）；SuperGrok Heavy 官方标注 16 个专家模式 AI 代理，适合超大型项目
上下文消耗：Grok Build 界面右上角会显示 token 用量（如 37K / 512K），长对话、大文件引用、多子代理并行都会加速消耗，建议复杂任务用 /compact 压缩上下文

对于大多数开发者，SuperGrok（$30/月）已经足够使用 Grok Build 的全部核心功能。

Grok Build 基本使用

订阅成功后，就可以正式开始使用了。

使用方式

交互式 TUI 模式（推荐）：输入 grok 进入全屏界面，支持鼠标点击、键盘快捷键、自然语言输入（中英文均可）
命令行快捷模式（Headless，非交互）：

bash

grok -p "你的自然语言指令"

常用命令

在 TUI 内或命令中输入：

命令	功能
`/plan`	进入 Plan Mode，先规划再执行
`/goal 任务描述`	启动自主长期任务（子代理自动分解执行）
`/inspect`	查看配置、Skills、插件等资源
`/model <name>`	切换模型
`/skillify`	将当前工作流保存为可复用 Skill
`/status`	查看当前状态和额度

Plan Mode 说明

Plan Mode 是核心安全机制：对于复杂任务，Grok Build 会先生成结构化计划（plan.md），你可审核、修改或重写步骤，批准后才执行文件修改，并以 Diff 形式展示变更。

常用交互方式

@文件路径（或 @文件;行号）引用代码
/ 开头命令（/new、/plan、/model、/compact 等）
直接使用技能名（/check-work、/create-skill 等）

使用实例

实例 1：简单代码解释（快速上手）

bash

grok -p "解释这个代码库的整体架构"

或进入 TUI 后直接输入：

@src/main.py 详细讲解这个文件的功能

实例 2：重构代码（使用 Plan Mode）

在项目目录运行 grok，然后输入：

使用 JWT 替换当前的 session 认证机制，重构 auth 模块

Grok Build 会建议进入 Plan Mode：

它会探索代码库、生成详细计划
你审核/修改计划后批准，它会并行使用子代理进行修改、测试，并展示 Diff

实例 3：大型任务（/goal 自主模式）

/goal 迁移整个认证模块到新 API，并添加单元测试和文档更新

支持多个子代理（最多 8 个）并行工作：一个研究 API、一个写代码、一个审查等
可随时输入 /goal status 查看进度

实例 4：创建新功能

创建一个 React 组件，实现带拖拽功能的看板（Kanban），使用 Tailwind 样式

Grok Build 会自动生成文件、处理依赖等。

实例 5：Headless 脚本中使用

bash

grok -p "修复所有 ESLint 错误，并优化性能" --output-format json

高级功能与提示

多子代理：复杂任务自动拆分并行处理，互不干扰
集成：支持 AGENTS.md、插件、MCP 服务、Hooks 等，兼容现有开发流程
安全：所有文件修改前需审核 Plan 和 Diff
调试：用 grok inspect 或 /inspect 查看可用资源；遇到问题可输入自然语言求助
更新：定期运行安装命令或检查官方文档

官方资源

安装与文档：https://docs.x.ai/build/overview
新闻：https://x.ai/news/grok-build-cli

Grok Build 仍在快速迭代，建议结合你的项目实际尝试。如果你是订阅用户，安装后直接在项目里跑 grok 体验最直观。

字节笔记本

Grok Build 安装使用完整教程（2026最新版）

什么是 Grok Build

安装 Grok Build

macOS / Linux

Windows

首次启动与登录授权

步骤 1：进入项目目录并启动

步骤 2：授权 Grok Build

步骤 3：连接成功

非浏览器环境（服务器 / 脚本）

订阅要求与套餐对比

哪些套餐能用 Grok Build？

Grok Build 功能与使用次数对比

使用次数关键说明

Grok Build 基本使用

使用方式

常用命令

Plan Mode 说明

常用交互方式

使用实例

实例 1：简单代码解释（快速上手）

实例 2：重构代码（使用 Plan Mode）

实例 3：大型任务（/goal 自主模式）

实例 4：创建新功能

实例 5：Headless 脚本中使用

高级功能与提示

官方资源