官方安装
安装最新稳定版
macOS、Linux 或 Git Bash 使用 xAI 官方安装脚本:
bash
curl -fsSL https://x.ai/cli/install.sh | bashWindows PowerShell 使用:
powershell
irm https://x.ai/cli/install.ps1 | iex验证二进制:
bash
command -v grok
grok --versionmacOS/Linux 的官方脚本通常安装到 ~/.grok/bin/grok。预期 command -v grok 指向该目录或官方安装器创建的等价路径。
x.ai 下载失败时
官方安装器会在主站不可达时回退到 xAI 的官方 GCS 发行源。请保留官方安装脚本,不要因为下载失败而改装同名社区 npm 包。
若脚本本身无法下载,先检查网络、代理和 TLS;恢复网络后重试。不要为了绕过 TLS 校验而关闭证书验证。
清理非官方同名 CLI
先确认当前命令来源:
bash
command -v grok
which -a grok如果看到社区 npm 包,先卸载它,再安装官方发行版。例如:
bash
npm uninstall -g @vibe-kit/grok-cli
npm uninstall -g grok-dev
hash -r@xai-official/grok 曾发布过较早的 npm 启动器。即使它带有 xAI 名称,也可能不支持当前官方 Grok Build 的自定义模型配置。对于 Code80 中转,请优先使用官方安装脚本下载的当前二进制。
grok: command not found
将官方目录加入 Shell PATH:
bash
printf '\nexport PATH="$HOME/.grok/bin:$PATH"\n' >> ~/.zshrc
export PATH="$HOME/.grok/bin:$PATH"
hash -r
grok --version第一行让新终端永久生效,第二行让当前 Shell 立即生效。Bash 用户应改写入 ~/.bashrc。
升级
官方 Grok Build 安装完成后,使用:
bash
grok update
grok --version升级后复查 command -v grok。如果 PATH 又命中了旧 npm shim,先清理旧包并恢复 ~/.grok/bin 的优先级。
