Grok Build 安装、配置与首次运行避坑指南：从 `grok` 命令到 Plan Mode

何十二
4,295 阅读5分钟

摘要：本文面向第一次使用 Grok Build 的开发者，整理 macOS、Linux、WSL 和 Windows PowerShell 的安装方式，以及 PATH、首次登录、设备码认证、grok inspect 和 Plan Mode 的使用顺序。内容依据 2026 年 7 月可查到的 xAI 官方文档整理。

先说结论

Grok Build 是运行在终端里的 coding agent。第一次使用时，建议按这个顺序操作：

  1. 在正确的终端安装；
  2. 重新打开终端，让 PATH 生效；
  3. 在自己的项目目录启动 grok；
  4. 使用浏览器或设备码登录正确账号；
  5. 先查看项目和计划，再批准文件修改；
  6. 最后检查 diff 并运行测试。

不要在安装失败时同时修改 PATH、网络、浏览器和账号。每次只改变一个变量，才能确认问题来自哪里。

Grok Build 适合什么场景

Grok Build 更接近本地开发工作流，而不是普通聊天窗口。它可以在终端中理解项目、读取文件、执行命令，并把修改结果交给开发者审核。

需求Grok Build 的对应方式
理解陌生代码库先让它解释目录和关键模块
处理跨文件任务先进入 Plan Mode，再逐步执行
控制修改风险检查权限提示、计划和 diff
继续历史任务使用会话列表和恢复功能

macOS、Linux 与 WSL 安装

官方安装命令：

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

安装后重新打开终端，再进入项目目录：

cd your-project
grok

如果出现 grok: command not found，先检查：

echo $SHELL
echo $PATH
which grok

不要直接假设二进制一定安装在某个固定目录。应先查看安装输出，再决定是否需要调整对应 shell 的配置文件。

WSL 和 Windows PowerShell 是两套环境。在 WSL 中安装的程序应在 WSL 中运行；如果要在 Windows 本机运行，使用 PowerShell 安装方式。

Windows PowerShell 安装

官方安装命令：

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

安装完成后关闭当前 PowerShell，重新打开一个窗口，再运行：

grok

仍无法识别命令时，依次检查：

检查项判断方法
当前终端确认是 PowerShell，不是 CMD 或 WSL
PATH 是否刷新重新打开终端，不在旧窗口反复测试
安装位置查看安装脚本实际输出的目录
当前版本安装成功后运行 grok version

首次登录：浏览器与设备码

交互式环境默认可以运行：

grok login

浏览器打开后，先确认登录的是准备使用 Grok Build 的账号，再完成授权。如果浏览器中同时登录了多个账号，账号不一致可能导致后续权限或会话问题。

在 SSH、容器、云开发环境或浏览器回调受限的终端中，可以使用官方设备码登录：

grok login --device-auth

终端会显示网址和短代码。请在自己的浏览器中完成授权，不要把设备码、登录链接或认证信息发送给他人。

先检查版本，再排查异常

grok version
grok update --check

发现稳定版更新后：

grok update

版本会持续变化，不应把某个版本号长期写成“最新版”。具体修复内容应查看官方更新日志。

grok inspect 有什么用

进入项目目录后可以运行：

grok inspect

它用于查看 Grok 在当前目录发现的规则、skills、plugins、hooks、MCP servers 等配置来源。第一次在重要项目中使用时，先检查这些上下文，比直接让 agent 修改代码更稳妥。

Plan Mode 怎么用

进入计划模式：

/plan [任务描述]

查看计划：

/view-plan

适合的工作顺序：

  1. 先解释项目结构；
  2. 要求列出准备读取和修改的文件；
  3. 检查数据库、鉴权、支付和部署相关步骤；
  4. 确认计划后再执行；
  5. 查看 diff；
  6. 运行测试后决定是否接受。

常见问题

现象优先处理
grok: command not found检查终端、安装位置和 PATH
浏览器没有打开手动运行 grok login，检查默认浏览器
SSH 无法完成登录使用 grok login --device-auth
登录后出现 403先更新版本，再核对账号和会话
修改范围过大使用 Plan Mode，并逐项检查 diff

登录和 403 的完整排查见本专栏第 3 篇： juejin.cn/post/766005…

账号与订阅边界

xAI 发布 Grok Build 时说明其早期测试版面向 SuperGrok 和 X Premium+ 订阅者。具体可用性仍应以当前官方说明和自己的账号状态为准。

安装失败、PATH 未刷新和浏览器未打开通常不是订阅付款问题。只有确认安装与登录链路正常后，才需要进一步核对当前账号的订阅权益。

如果确认问题属于消费者会员订阅付款，而不是安装、PATH 或登录故障，可以进一步参考 chonggrok.com 的 SuperGrok 开通说明。它只是没有海外付款方式时的一个可选入口，不能解决客户端或登录问题；不需要账号密码，Grok User ID 仍应只在确认的核销流程中提交，具体权益以 xAI 实时展示为准。

FAQ

Grok Build 和 Grok 网页聊天是一回事吗？

不是同一种使用界面。Grok Build 是终端 coding agent，网页端更偏日常聊天和内容任务；账号权益和实际入口应以官方实时展示为准。

第一次使用时应该马上允许修改文件吗？

不建议。先解释项目、检查配置、进入 Plan Mode，再看 diff 和测试结果。

安装失败与会员订阅有关吗？

通常无关。命令找不到、PATH 未刷新和终端混用应先作为本地安装问题处理。

参考资料

avatar
文章
阅读
粉丝