Grok CLI

安装 Grok CLI

如果你的设备尚未安装 Node.js，请先安装 Node.js 18 及以上版本，再执行以下命令安装 Grok CLI。你可以访问官网安装，也可以通过命令安装：

brew install node

如果你更习惯图形界面安装，也可以访问：

https://nodejs.org/

安装完成后，执行以下命令安装 Grok CLI：

npm install -g @vibe-kit/grok-cli

更多安装细节与进阶用法请参考 xAI 官方文档。

还没有 API Key？ 请先订阅 Token Plan，然后在控制台 账户管理 → Token Plan 创建专属 API Key。套餐额度用尽或达到限制后，可开启 Extra Usage，超出部分将自动按量计费、从账户余额扣费。

设置环境变量

你可以先在当前终端中临时设置环境变量；如果希望长期生效，请写入对应系统的环境变量配置。

export GROK_BASE_URL="https://api.senseaudio.cn/v1"
export GROK_API_KEY="<SENSEAUDIO_API_KEY>"

macOS / Linux 如需长期生效，可以将环境变量写入 Shell 配置文件：

nano ~/.zshrc

在文件末尾加入以下内容，保存后重新打开终端，或执行 source ~/.zshrc / source ~/.bashrc 生效：

export GROK_BASE_URL="https://api.senseaudio.cn/v1"
export GROK_API_KEY="<SENSEAUDIO_API_KEY>"

如果需要在 Windows 桌面环境中长期生效，请按以下步骤配置：

打开 开始菜单，搜索 环境变量。
点击 编辑系统环境变量。
在弹出的窗口中点击 环境变量。
在 用户变量 中点击新建，分别添加：
- 变量名：GROK_BASE_URL，变量值：https://api.senseaudio.cn/v1
- 变量名：GROK_API_KEY，变量值：你的 SenseAudio Token Plan API Key
保存后重新打开终端，再启动 Grok CLI。

启动 Grok CLI

grok --model senseaudio-s2

运行效果如下：

macOS / Linux 中通过 export 设置的变量只在当前终端会话内生效；如果希望长期生效，建议写入 ~/.zshrc 或 ~/.bashrc。Windows 中通过 PowerShell 设置的 $env: 变量也只在当前终端会话内生效。