Grok Build 国内安装指南：从零到可用（2026 年 7 月）

一句话：这篇文章解决一个具体问题——在国内的网络环境下，把 Grok Build 装好、连上、跑起来。附带 SuperGrok 订阅方案和 Plan Mode 实测体验。

适用人群：想在国内用 Grok Build 的开发者 / 已经装了但连不上的 / 还在观望要不要入坑的。

跳转导航：

• 装不上？先看网络配置
• 还没装？直接看安装步骤
• 装好了想看高阶用法？跳到 Plan Mode
• 不知道选哪个订阅方案？看这里
• 常见问题速查

---

零、国内网络配置（先看这里）

这是全篇最值得先读的一节。如果你已经装好了 Grok Build 但连不上、登不上、跑着跑着超时——不用往下翻，问题出在这里。

为什么连不上

Grok Build 是一个终端应用。它发出的网络请求走的是你终端的环境变量，不是浏览器的代理设置。你在 Chrome 里能打开 x.ai，不代表终端里的 grok 命令能连上 xAI 的服务器。

临时方案（当前终端窗口有效）

如果你已经有代理在本地运行（比如 Clash、V2Ray、Surge），把终端流量指过去就行。

Windows PowerShell（当前会话）：

$env:http_proxy="http://127.0.0.1:7890"
$env:https_proxy="http://127.0.0.1:7890"

macOS / Linux Terminal（当前 shell）：

export http_proxy=http://127.0.0.1:7890
export https_proxy=http://127.0.0.1:7890

7890 是 clash 的默认端口。如果你用的是其他代理工具，换成对应的端口号（V2Ray 通常是 10809，Surge 通常是 6152）。

配完之后跑一下 grok --version，能通就说明代理生效了。

永久方案（每次打开终端自动生效）

把上面那两行加到你的 shell 配置文件里：

• macOS / Linux：写入 ~/.zshrc 或 ~/.bashrc
• Windows PowerShell：写入你的 PowerShell Profile（$PROFILE 文件）

不想全局走代理的话，可以封装成一个 alias，只在需要的时候手动开启。

无代理环境（服务器 / 云开发机）

如果你在阿里云、腾讯云这类国内服务器上用 Grok Build，本地没有代理，两个路子：

1. 申请 xAI API Key，通过环境变量 XAI_API_KEY 直接认证（见第三章），走 API 通道比 CLI 登录稳定一些
2. 在服务器上也配一个代理客户端，但不展开说了，每个人的网络环境不一样

---

一、安装

确认网络能通之后，安装本身很轻量。

macOS / Linux：

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

Windows PowerShell（管理员身份运行）：

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

验证安装：

grok --version

能输出版本号，安装这步就过了。

在 Git 仓库根目录下运行效果最好。Grok Build 会自动读取仓库结构和 .gitignore 等配置文件，理解项目上下文的能力明显比在空目录下强。

平台兼容性：macOS 体验最完整，Linux 次之，Windows 也能跑但偶尔有小问题（路径处理、权限相关）。

---

二、Grok Build 是什么

xAI 官方推出的终端 AI 编码代理（Coding Agent CLI），2026 年 5 月进入早期 Beta。

和 GitHub Copilot 那种代码补全插件不一样——Grok Build 更像一个住在终端里的工程师。你告诉它要做什么，它自己规划步骤、读项目代码、写新功能、跑测试，最后帮你 git commit。

几个值得注意的特性：

• 全屏交互式 TUI 界面，支持鼠标点击
• Plan Mode：先出方案再动手，确认后才改代码
• 大任务自动拆给多个子代理并行处理
• 支持无头模式，能塞进 CI/CD 流水线
• 支持 ACP 协议，可接入 IDE 和其他 Agent 框架

定位上和 Claude Code、Aider 直接竞争。截至 2026 年 7 月，Grok Build 的迭代速度很快，每周都有功能更新。

---

三、首次启动和登录

进入项目目录后直接跑：

cd /path/to/your/project
grok

第一次启动会弹出浏览器让你授权 xAI 账号，点允许就行。

无浏览器环境（服务器），手动设置 API Key：

export XAI_API_KEY="xai-你的密钥"

API Key 申请地址：console.x.ai/team/default/api-keys

登录成功后进入全屏 TUI 界面，长这样：

---

四、Plan Mode 实测

Plan Mode 是 Grok Build 目前最值得用的功能，没有之一。

用过其他 AI 编码工具的人应该都有这种经历：你让它改点东西，它二话不说直接上手，结果改乱了、依赖装错了、测试挂了，回滚都麻烦。Plan Mode 就是为了避免这种情况设计的。

开启之后，Grok Build 会先输出一份完整的执行计划——打算做哪几步、动哪些文件、用什么方案。你可以：

• 直接批准，让它动手
• 对某一步提出修改意见
• 让它推翻重来

确认后每个文件的改动以 diff 形式展示，一目了然。

三种进入方式

① 快捷键：在界面里按 Shift + Tab 循环切换，状态栏出现 "Plan" 即开启。

② 斜杠命令：输入 /plan。

③ 启动参数：

grok --plan

退出再按一次 Shift + Tab，或者输入 /plan off。

我自己的习惯是默认开着 Plan Mode，只有改个变量名、加个注释这种小事才切回普通模式。开着 Plan Mode 省下的回滚时间，远多于它多花的确认时间。

---

五、常用命令

界面里可以直接用中文或英文输入需求，跟聊天差不多。下面是几个高频斜杠命令：

命令	作用
/help	打开帮助面板
/plan	进入规划模式
/yolo	自动批准模式（谨慎使用）
/model <模型名>	切换模型
/inspect	查看当前配置和加载的技能
/feedback	提反馈给 xAI
/clear	清空会话

刚上手先 /help 看一眼，比什么教程都好使。

---

六、订阅方案怎么选

Grok Build 需要 SuperGrok 或 X Premium Plus 会员才能用。

简短版建议：

方案	适合谁	说明
SuperGrok	只为了用 Grok Build + Grok 聊天	价格更低，订阅路径简单
X Premium Plus	本来就在用 X（Twitter）的付费功能	附带 X 蓝标认证、Grok 访问权限等

SuperGrok 可以通过 grokng.com 的一键升级系统订阅。grokm.com 的内购价格目前比较有竞争力，可以两边比较一下再入手。

如果你还需要用 Grok 生成图片或视频素材，SuperGrok 目前的内容生成速度和质量都不错，一个订阅能覆盖编码 + 内容制作两个场景。

---

七、常见问题

Grok Build 在国内能用吗？

能。但需要配代理，终端默认不走浏览器的代理设置。具体步骤见网络配置章节。

安装时报网络错误怎么办？

先确认 curl 或 PowerShell 能不能正常访问外网。能的话把终端代理配好再跑安装命令。不行的话检查代理客户端是否开启、端口号对不对。

SuperGrok 和 X Premium Plus 选哪个？

大多数开发者选 SuperGrok 就够了——价格更低，功能覆盖 Grok Build 的所有需求。X Premium Plus 多出来的主要是 X 平台的社交功能（蓝标、广告分成等），对写代码没有额外帮助。

Grok Build 和 Claude Code 比哪个好？

两个定位一样，但在 2026 年 7 月这个时间点上差异明显：

• Grok Build：Plan Mode 的设计更克制，界面交互更友好，迭代速度快
• Claude Code：生态更成熟，第三方工具和社区插件更丰富

如果你追求"先规划再执行"的安全感，Grok Build 的 Plan Mode 体验更好。如果你已经有成型的 Claude Code 工作流，迁移成本可能不值得。

不用代理能直接用吗？

如果只是用 API Key 方式调用（XAI_API_KEY 环境变量），部分国内服务器可以直接连上，但不稳定。终端直连 x.ai 域名基本都需要代理。老老实实配好吧。

为什么我配了代理还是连不上？

检查三点：

1. 代理端口号对不对（常见：Clash 7890，V2Ray 10809，Surge 6152）
2. http_proxy 和 https_proxy 都设了吗（很多人只设了一个）
3. 是不是在 PowerShell 里设了环境变量但用 cmd 终端跑的——两个不通

---