摘要:Grok Build 登录失败或返回 403 时,不应一开始就重装、删除认证文件或重复购买订阅。本文按照“记录报错位置、检查版本、核对浏览器账号、重新登录、设备码授权、旧会话与订阅权益”的顺序排查,并说明哪些问题不是充值能够解决的。
先判断卡在哪一步
| 现象 | 优先检查方向 |
|---|---|
终端找不到 grok | 安装位置、当前终端、PATH |
| 启动后浏览器没有打开 | 默认浏览器、网络、登录命令 |
| 浏览器授权后终端仍未登录 | 授权账号、回调、旧认证状态 |
| 登录后打开会话返回 403 | 客户端版本、团队账号、旧会话 |
| 只有某个账号无法使用 | 登录账号与订阅账号是否一致 |
| Grok 网页付款被拒 | 银行卡、账单地址、3DS 和支付风控 |
先记录完整错误文本、发生时间和触发步骤。公开日志前隐藏账号、授权码、路径中的个人信息和其他敏感字段。
第一步:确认 Grok Build 版本
官方 CLI 提供版本和更新命令:
grok version
grok update --check
发现稳定版更新后:
grok update
更新完成后关闭当前终端,重新打开,再运行一次 grok version。版本号会持续变化,本文不把某个版本长期写成“最新版”。
更新日志曾记录多项登录、认证刷新、Windows 和会话相关修复,因此排错前先更新,可以避免重复处理已经修复的问题。
第二步:核对浏览器授权账号
交互式登录可以运行:
grok login
浏览器打开后不要急着确认,先检查当前登录的是否为准备使用 Grok Build 的账号。如果浏览器保存了多个账号,可能会授权到另一个没有相应权益的账号。
建议核对:
- 浏览器账号与 Grok 网页中的账号一致;
- 当前看到的订阅状态属于同一账号;
- 没有在另一个浏览器配置文件中完成授权;
- 公司或团队账号没有被误切换为个人账号。
第三步:使用官方命令重新登录
优先使用官方退出和登录命令,不要直接删除不清楚用途的认证文件:
grok logout
grok login
登录完成后先新建空会话测试。如果新会话正常、旧会话仍失败,问题更可能集中在会话或版本,而不是会员付款。
不要把登录链接、Cookie、认证文件或设备码发送给他人。
第四步:SSH、WSL 或浏览器受限环境
如果终端无法自动打开浏览器,使用官方设备码登录:
grok login --device-auth
终端会显示网址和短代码。可以在另一台有浏览器的设备上打开该网址,登录正确账号并输入代码,完成后回到原终端。
设备码适合 SSH、容器、云开发环境和浏览器回调受限场景。它仍然属于账号认证流程,不需要把账号密码交给其他人。
第五步:重新登录后仍然返回 403
按下面的顺序检查,每次只改变一个变量:
| 顺序 | 检查项 | 判断目的 |
|---|---|---|
| 1 | grok version | 是否已经更新成功 |
| 2 | 当前浏览器账号 | 是否授权了正确账号 |
| 3 | 新建空会话 | 是否只有旧会话失败 |
| 4 | 个人账号或团队账号 | 是否存在身份切换 |
| 5 | 官方更新日志 | 是否有对应版本缺陷 |
| 6 | 官方服务状态 | 是否属于临时服务异常 |
xAI 更新日志曾记录:某个版本修复了团队账号重新登录后,会话列表接口返回 403的问题。这个记录不能泛化为“所有 403 都是同一个软件 Bug”,只能作为特定账号类型和会话环节的参考。
如果仍无法解决,联系官方支持时准备:
- Grok Build 版本;
- 操作系统和终端类型;
- 报错发生的具体步骤;
- 已脱敏的完整错误信息;
- 是否为个人账号或团队账号;
- 问题是否只影响旧会话。
第六步:检查订阅权益
xAI 发布 Grok Build 时说明,早期测试版面向 SuperGrok 和 X Premium+ 订阅者。权益检查应同时满足:
- 当前终端授权的是目标账号;
- 订阅已经在该账号内生效;
- 当前官方说明仍将该订阅列为可用入口;
- 没有把 Grok 网页模型入口与 Grok Build 终端入口混为一谈。
订阅状态正常仍然出现 403,并不能证明需要再次付款。应继续检查版本、会话、账号和官方服务状态。
哪些问题不是充值能解决的
grok: command not found或 PATH 未刷新;- 浏览器授权了错误账号;
- SSH、代理或企业网络阻断认证;
- 客户端版本缺陷;
- 团队身份不匹配;
- 旧会话异常;
- xAI 服务临时故障。
只有确认当前账号缺少符合条件的会员订阅时,付款入口才与问题相关。即使订阅已经生效,也不能保证解决客户端、网络、团队权限或所有 403;仍需按发生环节继续排查。
只有已经确认账号缺少会员权益、问题确实属于订阅付款时,才可以进一步参考 chonggrok.com 的 SuperGrok 开通说明。它只是一个可选付款入口,不能解决客户端版本、网络、团队权限、旧会话或所有 403;ChongGrok 与 xAI、X 无隶属关系。
最终排查清单
- 已保存并脱敏原始报错;
- 已运行
grok version; - 已检查并执行必要更新;
- 已确认浏览器授权账号;
- 已通过官方命令退出并重新登录;
- 浏览器受限时已尝试设备码登录;
- 已测试新会话与旧会话的差异;
- 已区分个人账号与团队账号;
- 已检查官方更新日志和服务状态;
- 未把所有 403 都归因于订阅;
- 未在问题未明时重复付款。
FAQ
403 一定代表没有 SuperGrok 吗?
不一定。它可能来自账号不一致、旧会话、团队身份、客户端版本或服务异常,应根据发生环节逐层排查。
需要手动删除本地认证文件吗?
通常不需要。先使用 grok logout 和 grok login。手动删除未知文件可能扩大问题。
SSH 中登录必须在服务器上打开浏览器吗?
不必。可以运行 grok login --device-auth,再在另一台有浏览器的设备上完成授权。
开通 SuperGrok 能保证 Grok Build 可用吗?
不能作绝对保证。还要看官方当前入口、账号状态、客户端版本、网络和具体报错。
付款后仍显示 Free 怎么办?
先核对付款账号与当前登录账号,重新登录并保留订单记录,不要立刻重复下单。这个问题属于消费者会员权益同步,不等同于 Grok Build 403。
参考资料
- Introducing Grok Build:x.ai/news/grok-b…
- Grok Build Overview:docs.x.ai/build/overv…
- CLI Reference:docs.x.ai/build/cli/r…
- Enterprise Authentication:docs.x.ai/build/enter…
- Changelog:x.ai/build/chang…
还未安装 Grok Build,可阅读本专栏第 1 篇: juejin.cn/post/765961…
需要比较不同 AI 编程工具,可阅读本专栏第 2 篇: juejin.cn/post/765985…