部分 SuperGrok 用户会遇到这种情况：

网页使用量页面显示每周配额仅使用 0%,但 Grok Build 却提示 403：

1

Turn failed in 1.9s: Internal error: { "message": "API error (status 403 Forbidden): permission-denied: Your team ******** has either used all available credits or reached...

更特别的是，把“思考强度”调低后，Build 又能继续使用。

Grok Build 使用教程（2026 年最新版）

为什么会这样？

网页端显示的是 SuperGrok 的共享周配额，包括 Chat、Imagine、Build 等产品的总体消耗。

而 Grok Build 通过独立通道 cli-chat-proxy.grok.com 运行，计量更细。长时间 Agent 会话、多轮工具调用和深度推理，会比普通聊天消耗更多。

因此可能出现：

网页总配额还有剩余，但 Build 通道已经触发限制。

为什么降低思考强度就能恢复？

思考强度越高，模型生成的 reasoning tokens 越多，单次请求消耗也越大。

调到 Medium 或 Low 后，单次任务消耗下降，请求重新落入当前剩余额度范围，所以可以继续使用。

这不是额度恢复了，只是单次消耗变低了。

怎么处理？

1. 日常使用 Medium 或 Low，复杂任务再临时调高。
2. 在 CLI 输入 /usage，查看 Build 通道的实际用量。
3. 有高强度需求时，购买额外额度。
4. 如果持续报错，重新登录授权，确认 team 权限正常。

Grok Build error sending request 怎么解决？问题出在这里

总结

Grok Build 报 403，但网页显示 0%，通常不是配额页面出错，而是共享周配额和 Build 独立通道的计量方式不同。

降低思考强度、查看 /usage、控制高消耗任务，基本可以缓解这个问题。

最近很多国内 AI 用户开始关注 Grok。

一方面，是因为 Claude、ChatGPT 这类工具在账号风控、地区限制、内容限制上让不少人觉得麻烦；

另一方面，Grok 在创意写作、网文构思、漫画分镜、图片生成、视频生成、DeepSearch 搜索等场景里，确实有自己的特点。

如果你只是偶尔体验，免费版 Grok 就能用。 但如果你想长期用 Grok 写文章、做图、生成视频、查资料，或者体验更完整的 Grok 功能，那就需要了解 SuperGrok。

这篇直接讲清楚：

• 国内怎么注册 Grok？
• Grok 官网和 X 上的 Grok 有什么区别？
• 免费 Grok 和 SuperGrok 有什么区别？
• 国内用户怎么升级 SuperGrok？
• 升级后不显示 SuperGrok 怎么办？

建议收藏，后面注册和升级时可以直接对照操作。

一、国内可以注册 Grok 吗？

可以。

国内用户注册 Grok，主要需要准备两个东西：

1. 一个邮箱
2. 一个能正常访问 Grok 的网络环境

邮箱没有太多限制，常见的 QQ 邮箱、163 邮箱、Outlook、Gmail、自定义域名邮箱，一般都可以用来注册。

Grok 官网入口：

打开官网后，按照页面提示注册账号即可。整体流程和注册其他 AI 工具差不多：填写邮箱、接收验证码、完成登录，然后就可以进入 Grok 使用页面。

二、Grok 官网和 X 上的 Grok 有什么区别？

很多人会把 Grok 官网和 X 上的 Grok 混在一起。

简单说：

grok.com 是 Grok 的独立官网。

x.com 是 X，也就是原 Twitter 平台里的 Grok 入口。

两边都能用 Grok，但账号体系和订阅体系并不完全一样。

如果你平时主要刷 X，经常看海外 AI 动态、发帖、看推文，那么可以考虑在 X 里使用 Grok。

但如果你的目标很明确，就是想专门使用 Grok 聊天、写作、生成图片、生成视频、做 DeepSearch 搜索，那更建议直接使用 grok.com 官网。

原因也很简单：

X 会员是围绕 X 平台设计的，Grok 只是其中一部分权益。 SuperGrok 是围绕 Grok 本身设计的，更适合专门使用 Grok 的用户。

所以选择方式可以直接记住一句话：

经常用 X，就考虑 X 会员。 专门用 Grok，就直接看 SuperGrok。 只是想体验，先用免费版。

三、免费 Grok 和 SuperGrok 有什么区别？

免费版 Grok 适合轻度体验。

你可以用它问问题、写简单内容、试试模型风格，也可以体验部分基础功能。但如果你使用频率比较高，很快就会遇到限制。

免费版常见限制包括：

• 消息次数有限
• 高峰期容易变慢
• 图片和视频生成次数较少
• 上下文长度较短
• 部分高级功能不可用
• 新功能不一定第一时间开放

SuperGrok 则更适合高频用户。

升级 SuperGrok 后，通常可以获得更高的使用额度、更稳定的访问体验、更长的上下文、更完整的图片和视频生成能力，以及部分新功能的优先体验资格。

如果你经常使用下面这些功能，SuperGrok 会更有价值：

写公众号文章/ 写知乎回答/ 写短视频脚本/ 写网文大纲/ 做漫画分镜/ 生成图片素材/ 生成视频素材/ 使用 DeepSearch 查资料/ 进行长对话/ 体验语音和 Companion 功能

不过也要说清楚，Grok 不一定适合所有场景。

四、国内用户为什么升级 SuperGrok 会失败？

国内用户注册 Grok 通常不难，真正麻烦的是支付。

SuperGrok 官方订阅一般需要海外支付方式，比如 Visa、MasterCard 等国际银行卡。很多国内用户没有这类卡，即使有虚拟卡，也可能遇到支付失败、风控拒付、账单地址不匹配等问题。

常见失败原因包括：

• 银行卡不支持海外订阅
• 虚拟卡被拒付
• 账单地址不匹配
• 支付环境异常
• 账号触发风控
• 浏览器缓存导致页面异常

所以国内用户升级 SuperGrok，通常有两种方式：

第一种：自己用海外卡在 Grok 官网订阅。

第二种：通过国内 SuperGrok 升级入口，用账号 ID 完成充值。

如果你有稳定可用的海外卡，可以直接走官方订阅。

如果你没有海外卡，或者多次支付失败，可以考虑账号 ID 直充方式。重点是：尽量选择不需要账号密码的方式。

不要随便把 Grok 账号、邮箱密码、X 密码交给别人。

五、国内如何升级 SuperGrok？账号 ID 直充教程

如果你使用的是账号 ID 充值，一般流程很简单。

第一步：先注册并登录 Grok

先打开 Grok 官网：

grok.com

完成注册并登录账号。

确认你能正常进入 Grok 聊天页面后，再进行下一步。

第二步：找到自己的 Grok 用户 ID

账号 ID 是升级 SuperGrok 时最关键的信息。

现在官方已经没办法通过页面直接查看你的 Grok ID 了。

在有登录的 grok 的账户页面端，访问 grok.com/api/auth/session 账户页面，找到您的账户 ID（你的userid就是你的grok ID）。

第三步：进入 SuperGrok 升级入口

如果你没有海外卡，可以使用国内 SuperGrok 升级入口：cnmgrok.com

选择 SuperGrok 对应套餐，按照页面提示填写信息。

填写购买的充值码和你的 grok id 即可完成充值。

这里再次提醒： 账号 ID 直充一般不需要账号密码。 能不提供密码，就不要提供密码。

第四步：等待 SuperGrok 到账

提交成功后，一般需要等待几分钟。

到账后，重新打开 Grok 页面，如果升级成功，页面一般会显示 SuperGrok 相关状态。

如果页面没有立刻变化，不一定代表失败，可能只是缓存或延迟。

可以尝试下面几种方法：

• 刷新页面
• 退出 Grok 后重新登录
• 换一个浏览器打开
• 清理浏览器缓存
• 等待几分钟后再查看
• 进入账号订阅页面确认状态

六、升级 SuperGrok 后不显示怎么办？

很多人升级后遇到的第一个问题就是：钱付了，为什么页面还是普通 Grok？

这种情况通常有几种原因。

1. 浏览器缓存没刷新

这是最常见的情况。

解决方法：

退出账号 关闭浏览器 重新打开 grok.com 再次登录查看

2. 到账有延迟

有时候系统不是秒到账，可能需要等几分钟。

解决方法：

不要重复提交订单 等待几分钟后刷新页面 进入账号设置查看订阅状态

3. Grok 用户 ID 填错

如果 ID 填错，可能会导致无法正常充值到你的账号。

解决方法：

重新进入账号页面 复制完整 Grok ID 和充值填写的 ID 对比 确认是否漏字符或复制错

4. 登录了另一个账号

有些人同时有 X 账号、Grok 官网账号，甚至多个邮箱账号，容易登录错。

解决方法：

确认当前登录的邮箱 确认当前账号 ID 确认充值时填写的是同一个账号

七、SuperGrok 适合哪些人开？

SuperGrok 不是人人都必须开。

如果你只是偶尔问几个问题，免费版就够了。

如果你每天都要高频使用 Grok，那 SuperGrok 会更合适。

比较适合升级的人群包括：

内容创作者/ 公众号作者/ 知乎运营/ 短视频编导/ 网文作者/ 漫画脚本创作者/ AI 绘图用户/ AI 视频用户/ 海外信息搜索用户/ DeepSearch 重度用户/ 喜欢语音聊天和 Companion 的用户

尤其是做内容的人，Grok 的优势很明显：它更适合发散思路、扩写脑洞、整理热点、生成脚本和做多模态素材。

八、Grok 和 SuperGrok 常见问题

1. 国内注册 Grok 需要手机号吗？

一般情况下，邮箱注册即可。具体是否需要额外验证，要以页面实际提示为准。

2. QQ 邮箱能注册 Grok 吗？

通常可以。QQ 邮箱、163 邮箱、Outlook、Gmail 等常见邮箱都可以尝试。

3. SuperGrok 可以用支付宝或微信支付吗？

官方订阅一般不直接支持国内常用支付方式。没有海外卡的用户，可以考虑国内升级入口（cnmgrok.com）。

4. 升级 SuperGrok 需要提供账号密码吗？

不建议提供账号密码。更推荐使用 Grok 用户 ID 直充方式。

5. X Premium+ 和 SuperGrok 是一回事吗？

不是完全一回事。

X Premium+ 是 X 平台会员，Grok 只是其中一部分权益。 SuperGrok 是 Grok 官网的独立订阅，更适合专门使用 Grok 的用户。

6. SuperGrok 适合写代码吗？

适合

尤其是搭配 Grok Build 后，原型开发和快速迭代效率很高。虽然大型重构略逊于 Claude，但对大多数开发者来说已足够实用且性价比高。

7. SuperGrok 更适合什么？

更适合写作、创意、图片生成、视频生成、DeepSearch、长对话、语音聊天和陪伴类功能。

九、总结：国内用户怎么选择 Grok 和 SuperGrok？

如果你只是想体验 Grok，先用免费版。

如果你是 X 重度用户，可以考虑 X 的会员体系。

如果你主要就是为了使用 Grok 本身，建议直接使用 grok.com，并根据需求升级 SuperGrok。

国内用户升级 SuperGrok，最大问题通常不是注册，而是支付。如果没有海外卡，或者官方支付一直失败，可以考虑账号 ID 直充方式。

最后再总结一句：

Grok 适合创作、搜索和多模态生成。 SuperGrok 适合高频使用 Grok 的用户。 国内用户升级时，优先选择不需要账号密码的方式，更安全也更省事。

SuperGrok 订阅包含约 $200/月的 xAI API 额度，可访问 grok-imagine-image-quality、grok-imagine-video-1.5-preview、grok-4 等高级模型。但绝大多数用户只用了网页聊天，这部分额度几乎全部浪费。

本文提供两条路径：Grok Build 自动化配置，以及手动逐步操作。

核心原理

xAI 网页端走受限通道，图像和视频配额少且功能受限。通过开源工具 CLIProxyAPI（cliproxy） 将 SuperGrok 登录态转换为本地 OpenAI 兼容 API（http://127.0.0.1:8317/v1），即可在 ComfyUI、Open WebUI 等工具中直接调用订阅内的真实模型额度。

解锁后可访问的模型：

路径一：Grok Build 自动配置（推荐）

Grok Build 是 xAI 官方 CLI coding agent，SuperGrok 用户免费使用，可直接操控本机执行配置。

安装

1
2
3
4
5

# macOS / Linux / WSL
curl -fsSL https://x.ai/cli/install.sh | bash

# Windows（管理员 PowerShell）
irm https://x.ai/cli/install.ps1 | iex

安装后在任意目录运行 grok，首次启动会打开浏览器完成 OAuth 登录。

配置指令

进入 Grok Build 后，直接输入：

1
2
3

帮我配置 SuperGrok 本地 API 代理（CLIProxyAPI），
让 ComfyUI 可以调用订阅内的真实 xAI 模型额度。
management key 用 local，配置开机自启，并指导我完成登录和 ComfyUI 节点替换。

Grok Build 会依次完成：下载 cliproxy、生成配置文件、启动服务、引导 OAuth 登录、安装 ComfyUI、替换节点 API 端点。

路径二：手动配置

1. 安装 CLIProxyAPI

Windows

1. 前往 Releases 页面，下载 CLIProxyAPI_windows_amd64.zip

1. 解压至 C:\cliproxy
2. 复制 config.example.yaml 到 config.yaml

WSL / Linux（支持 systemd 自启）

1

curl -fsSL https://raw.githubusercontent.com/brokechubb/cliproxyapi-installer/refs/heads/master/cliproxyapi-installer | bash

2. 登录 SuperGrok 账号

cliproxy 启动后，浏览器打开 http://localhost:8317/management.html。

• management key 建议设置为简短字符串（如 local）
• 点击 xAI 登录区域完成 OAuth 授权
• Token 保存后服务即可持续调用真实 API

SuperGrok 官方订阅升级服务:cnmGrok.com。

3. 安装 ComfyUI

从 ComfyUI Releases 下载对应版本的便携包（NVIDIA / AMD / CPU），解压后运行对应的 .bat 文件，浏览器访问 http://127.0.0.1:8188。

4. 将 ComfyUI Grok 节点指向本地代理

ComfyUI 默认 Grok 节点走 Comfy 云通道。需将节点 API 端点替换为 http://127.0.0.1:8317/v1，API key 填入 management key（local）。可在节点配置中直接修改，或使用 Grok Build 指令自动完成。

5. （可选）Open WebUI 聊天界面

在 Open WebUI 的 Settings，选择 Connections，点击OpenAI 中新增连接：

1
2

URL:     http://localhost:8317/v1
API Key: local

即可在类 ChatGPT 界面使用 grok-4，支持文件上传、持久记忆、自定义角色。

常见问题

额度如何消耗？ 消耗的是 SuperGrok 订阅本身包含的 API 额度，非额外赠送。专业工作流单次消耗高于网页聊天，但产出效率和质量同步提升。

OAuth 登录失败？ 检查网络是否能正常访问 x.ai，必要时确保代理支持 OAuth 回调。

后续模型更新如何跟进？ 在 Grok Build 中输入”更新我的 Grok 节点和模型列表”，自动维护。

适合人群

适合：图像/视频重度创作者、ComfyUI 进阶用户、已订阅 SuperGrok 但觉得网页配额不够的用户。

不适合：偶尔生成几张图的轻度用户——网页版已经足够，无需折腾本地环境。

配置完成后，你本地运行的就是一个完整的 xAI API 工作站，而不是受限的网页聊天窗口。这才是 SuperGrok 订阅应有的使用方式。

最近 xAI 放出了一条很值得关注的更新：

Composer 2.5 is now available inside Grok Build.

翻译就是： Composer 2.5 现在已经可以在 Grok Build 中使用了。

很多人可能会觉得只是一次普通的模型更新。但从 AI 编程工具的发展方向来看，这次更新其实挺关键。

因为它说明 Grok Build 不再只是一个“能在终端里写代码的 AI 工具”，而是开始朝着一个更完整的 Agentic Coding 工作台发展。

一、Composer 2.5 到底是什么？

按照 xAI 官方说法，Composer 2.5 是一个快速、智能度很高的模型，特点是：

擅长处理长时间运行的任务，也能更好地跟随复杂指令。

真正做开发的人，会更关注另外几个问题：

1. 能不能理解整个项目结构？
2. 能不能连续执行多个步骤？
3. 能不能先分析再动手，而不是上来就乱改？
4. 能不能处理多文件、多模块之间的依赖关系？
5. 能不能在长任务里保持稳定，不跑偏？

Composer 2.5 这次被接入 Grok Build，重点就是补强这些场景。

不是单纯为了聊天，而是更偏向实际工程任务。

二、Grok Build 是什么？

Grok Build 可以理解为 xAI 推出的终端 AI 编程助手。

不是浏览器里的聊天窗口，也不是单纯的代码补全插件。

直接运行在终端里的 coding agent。

你可以在项目目录里启动它，让它读取项目文件、理解代码结构、分析问题、提出计划，并在你确认后执行修改。

这类工具最大的价值是： 它离真实开发环境更近。

因为开发者平时真正工作的地方，本来就是终端、IDE、Git、项目文件夹和调试日志。

Grok Build 进入终端之后，可以更接近实际开发流程。

点击查看文章：Grok Build 使用教程（2026 年最新版)

三、如何在 Grok Build 中使用 Composer 2.5？

使用方式不复杂。

如果还没有安装 Grok Build，可以使用官方安装命令： curl -fsSL https://x.ai/cli/install.sh | bash

安装完成后，进入你的项目目录： cd your-project

然后启动 Grok Build：grok。

进入 Grok Build 后，可以通过模型菜单切换模型：/model 或者使用官方提到的 /models 菜单。

在模型列表里选择： Composer 2.5

选择Composer 2.5

选择完成后，当前会话就可以使用 Composer 2.5 来处理代码任务。

四、Composer 2.5 适合用在哪些场景？

不是所有任务都需要切到 Composer 2.5。它更适合处理那些上下文长、步骤多、需要持续理解项目结构的任务。

1. 多文件代码修改

比如登录功能，通常会涉及页面、接口请求、token 存储、路由守卫、用户状态管理和异常提示。 这类任务不是改一个文件就能完成的，如果模型只看局部，很容易改漏。Composer 2.5 更适合先理解整体，再分步骤修改。

2. 项目重构

项目重构通常包括拆分组件、整理目录、抽离工具函数、优化接口层、规范命名和删除重复代码。 这类任务很考验模型的上下文保持能力，Composer 2.5 更适合处理这种长任务。

3. 长链路 Bug 排查

真实项目里的 Bug 往往不是一行代码的问题，可能涉及页面、状态管理、接口、环境变量和构建配置。 Composer 2.5 适合顺着调用链持续分析，先定位问题，再给出修改方案。

4. 文档生成和项目交接

比如生成 README、安装说明、运行步骤、API 文档、目录结构说明和部署文档。 这类任务需要模型理解整个项目，而不是凭空写文档，所以也适合交给 Composer 2.5。

五、推荐使用方式：不要一上来就让它改代码

这是我觉得最重要的一点。

使用 Grok Build 或 Composer 2.5，不建议一上来就说： 帮我优化这个项目 指令太宽泛。

更好的方式是让它先分析，计划，最后执行。 例如：

1
2
3

请先阅读当前项目结构，不要直接修改代码。
先告诉我这个项目的主要模块、技术栈、入口文件和可能的风险点。
分析完成后，再给我一个修改计划。

这个提示词的好处是： 先让模型进入“理解项目”的状态，而不是直接进入“执行修改”的状态。

输出效果

六、几个适合 Composer 2.5 的实战提示词

1. 项目分析

1
2
3
4
5
6
7

请先分析当前项目结构，不要修改任何文件。
请输出：
1. 项目技术栈
2. 主要目录作用
3. 核心入口文件
4. 主要业务流程
5. 目前代码中可能存在的结构问题

2. Bug 排查

1
2
3
4
5
6
7

请帮我排查当前项目的报错。
要求：
1. 先不要修改代码
2. 先定位可能相关的文件
3. 分析错误产生的调用链
4. 给出 2-3 个可能原因
5. 最后再给出建议修改方案

3. 多文件修改

1
2
3

我需要优化当前项目的登录流程。
请先分析登录相关文件，包括页面、接口、token 存储、路由跳转和异常处理。
先给出修改计划，等我确认后再执行代码修改。

4. README 生成

1
2
3
4
5
6
7
8
9
10

请基于当前项目生成一份适合开源发布的 README。
需要包含：
1. 项目介绍
2. 技术栈
3. 安装方式
4. 本地运行
5. 目录结构
6. 环境变量说明
7. 常见问题
8. 后续开发计划

5. 重构任务

1
2
3
4
5
6
7

请分析当前项目是否存在重复代码、目录混乱、组件职责不清的问题。
先输出重构建议，不要直接修改。
每一条建议都要说明：
1. 涉及文件
2. 为什么要改
3. 改动风险
4. 预期收益

七、Composer 2.5 和普通模型怎么选？

建议是：

如果只是简单问答、小范围代码生成、解释报错，默认模型就够用。

但如果任务满足下面任意一个条件，就可以考虑切到 Composer 2.5：

• 读取多个文件
• 连续执行多个步骤
• 先计划再修改
• 长时间保持上下文
• 复杂指令跟随
• 处理真实项目结构
• 做重构、排查、文档、迁移

小任务看速度，大任务看稳定。

Composer 2.5 的价值，主要体现在复杂任务和长任务里。

八、总结

如果你已经在使用 Grok Build，这次 Composer 2.5 值得试一下。

它的意义不是替代所有模型，而是让 Grok Build 多了一个更适合长任务和复杂指令的模型选择。

前几天装 Grok Build，被一个特别隐蔽的问题卡了一晚上。

折腾完之后回头看，发现这个坑其实很多人都会踩，踩了之后第一反应基本都是错的。今天把过程整个写出来，看完这篇你应该可以省不少时间。

报错长这样

我本地装好 Grok Build 之后，初始化要跳转 xAI 登录认证。浏览器那边一切正常，但终端这边一直转圈，过一会儿就甩出来这段：error sending request for url https://auth.x.ai/.well-known/openid-configuration

翻译就是：Grok Build 想去请求 auth.x.ai 获取登录配置，但是请求根本发不出去。

我开始全猜错

我的第一反应是这么排查的：重装、换号、升级、清配置，全没用。

折腾快一小时才反应过来，报错里写得明明白白：error sending request

请求压根没发出去——这是网络层的问题，跟上面那些一个都不沾边。

最反直觉的一点

根本原因是：

浏览器能上不等于终端能上

我们日常用的本地网络工具，默认只接管浏览器流量。PowerShell、CMD、Node.js 这些命令行工具，默认不读取系统网络配置，全走直连。Grok Build 的请求自然也没走配好的通道。

完整排查步骤

第 1 步：先确认浏览器能打开

浏览器手动访问：

1

https://auth.x.ai/.well-known/openid-configuration

能看到一大段 JSON 配置就说明你的本地网络环境没问题。打不开的话先解决网络环境本身。

第 2 步：找到本地网络工具的端口

不同网络工具端口不一样，千万别照搬别人的端口号。

打开你自己常用的那个本地网络工具，找到”本地端口”或”入站端口”，把 HTTP 和 SOCKS 两个端口号都记下来。一般在主界面就能看到，类似：

1

本地: socks:XXXXX | http:XXXXX

第 3 步：在终端里手动配置环境变量

用 PowerShell 的话，输入下面的命令，把端口号换成你自己的：

1
2
3

$env:HTTP_PROXY="http://127.0.0.1:你的HTTP端口"
$env:HTTPS_PROXY="http://127.0.0.1:你的HTTP端口"
$env:ALL_PROXY="socks5://127.0.0.1:你的SOCKS端口"

用 CMD 的话，命令换成：

1
2
3

set HTTP_PROXY=http://127.0.0.1:你的HTTP端口
set HTTPS_PROXY=http://127.0.0.1:你的HTTP端口
set ALL_PROXY=socks5://127.0.0.1:你的SOCKS端口

这是告诉这个终端窗口：你后续发出的请求都走本地这些端口。

有个特别重要的细节：

这个配置只在当前窗口生效，窗口一关就失效。所以下面所有的测试和最后跑 Grok Build，都必须在同一个窗口里完成。

第 4 步：用 curl 做对比测试

这一步是整个排查的关键，能精准定位问题。

先测带端口参数的版本：

1

curl.exe -x http://127.0.0.1:你的HTTP端口 https://auth.x.ai/.well-known/openid-configuration

返回一大段 JSON 就说明本地通道本身没问题。

再测不带端口参数的版本：

1

curl.exe https://auth.x.ai/.well-known/openid-configuration

如果这个失败、上面那个成功，就 100% 锁定了问题：命令行环境没读取系统的网络配置，必须靠手动设置环境变量解决。

第 5 步：在同一个窗口跑 Grok Build

1

grok-build

然后点击界面里的：

1

Login with Grok

正常情况下浏览器会自动弹出登录页，跳转完成回到终端就能继续了。

授权登录

写在最后

整个问题的核心其实就一句话：

浏览器和终端是两套独立的网络通道，给浏览器配好了，不等于给终端配好了。

排查方法简单四步：

1. 看到 error sending request，先怀疑网络可达性，不要先怀疑软件本身。
2. 分别验证浏览器侧和终端侧的可达性。
3. 用 curl 带参数和不带参数各测一次，对比结果就能定位问题。
4. 实在不行就开 TUN，一了百了。

这套思路不光适用于 Grok Build，所有需要联网的命令行工具都适用。各种 AI 命令行工具、npm install 超时之类的问题，本质上都是这一类。

希望这篇能帮你少走点弯路。

Grok Build 是 xAI 官方推出的终端 AI 编码代理（Coding Agent CLI），于 2026 年 5 月正式进入早期 Beta 阶段。它把强大的 Grok 模型直接塞进你的终端，能帮你完成从规划、搜索、编码、测试到 Git 提交的全流程工作。

它支持交互式 TUI（全屏、鼠标操作、无闪烁）、Plan Mode（先规划再执行）、并行子代理、无头模式（脚本/自动化）、ACP 协议接入其他工具等特性，是目前最接近“专业软件工程师”的终端 AI 工具之一。

1. 前提条件

• 订阅要求：SuperGrok 或 X Premium Plus 会员（点击查看文章 : 2026 国内最新 SuperGrok 升级订阅教程）

• 系统支持：macOS、Linux、Windows（推荐 macOS/Linux 体验最佳）。

• 推荐环境：在你的项目根目录下运行效果最好（它会自动读取仓库结构、AGENTS.md、技能等）。

2. 安装 Grok Build

macOS / Linux

1

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

Windows（PowerShell，管理员权限推荐）

1

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

安装完成后，终端输入 grok --version 验证是否成功。

3. 首次启动与登录

1. 进入你的项目目录：cd /path/to/your/project
2. 启动 Grok Build：grok

3. 首次登录： 会自动打开浏览器进行 xAI 账号授权（推荐）。

无浏览器环境可手动设置环境变量：export XAI_API_KEY="xai-你的密钥" （密钥可在 https://console.x.ai/team/default/api-keys 获取）

登录成功后会进入全屏交互式 TUI 界面。

4. TUI 界面操作指南

Grok Build 的 TUI 支持鼠标点击、键盘快捷键，界面清晰无闪烁：

输入框：直接输入自然语言指令（如中文或英文）。

常用命令（在 TUI 内输入）：

5. Plan Mode（强烈推荐用于复杂任务）

输入复杂需求前，先用 /plan 或启动时加标志进入规划模式。

Grok Build 会先输出完整执行计划（分步骤）。 你可以：

• 逐条批准（Enter）
• 评论修改某一步
• 完全重写计划
• 批准后，所有文件变更都会以干净的 diff 形式展示，确认无误后再执行。

Plan Mode 的三种常用方法

1. 快捷键切换（最快，推荐日常使用） :在 TUI 中按 Shift + Tab 循环切换模式，直到状态栏显示 Plan。

2. 使用 Slash 命令: 输入命令/plan或/plan on后按回车。
3. 启动时直接进入（适合复杂任务）:grok --plan 或结合项目路径：cd your-project && grok --plan

退出或切换回 Normal 模式

再次按 Shift + Tab 切换到 Normal 模式或输入命令：/plan off

6. 基本使用示例

示例 1：新建项目

1

创建一个现代化的 React + TypeScript Todo App，带暗黑模式、拖拽排序、本地存储，使用 Tailwind CSS，风格参考 Apple

操作建议：

1. 直接在空文件夹中启动 grok
2. 推荐开启 Plan Mode，让 Grok Build 先输出项目结构、依赖清单和技术方案
3. 批准计划后，它会自动创建 package.json、组件文件、样式，并初始化 Git 仓库

预期效果：

• 生成完整的项目结构（含 README、测试文件）

• 包含暗黑模式切换、拖拽排序（@dnd-kit）、本地持久化（localStorage + Zustand）
• 自动安装依赖并运行 npm run dev

进阶技巧：

• 追加需求：“加上用户登录界面和后端 API 模拟”
• 完成后输入：“帮我部署到 Vercel 并生成部署脚本”

示例 2：分析现有项目

1

Explain this repo in detail. 重点分析架构、核心模块和潜在优化点。

示例 3：修改代码

1

@src/main.rs 帮我把这个文件重构为更清晰的模块结构，并添加错误处理。

示例 4：并行子代理（大型任务）

Grok Build 会自动拆分任务给多个子代理并行执行（如一个写前端、一个写后端、一个写测试）。

7. 无头模式（Headless）—— 脚本/自动化神器

适合 CI/CD、自动化脚本或嵌入其他工具：

1
2
3
4
5

# 简单执行
grok -p "为当前项目添加用户认证模块（JWT + 数据库）"

# 输出 JSON 便于解析
grok -p "分析这个代码库的安全问题" --output-format streaming-json

8. 高级功能

9. 实用技巧 & 注意事项

• 最好在 Git 仓库根目录运行，效果最强。
• 大项目建议先用 Plan Mode，避免一次性改太多。
• 图片支持：可直接粘贴截图让它分析 UI 或报错。
• 多任务切换：支持同时运行多个 Grok Build 实例。
• Beta 阶段：偶尔会有小 bug，遇到问题请用 /feedback 反馈。
• 卸载：参考官方文档或删除对应二进制文件。