# Grok CLI

来源: https://docs.aicentos.com/clients/grok-cli

Language: zh-CN

> 在 Grok CLI 中使用 aicentos —— 通过环境变量或配置文件接入

Grok CLI 是一个命令行工具，使用 OpenAI 兼容接口，可以直接将自定义 API 地址作为其后端服务接入。

## 准备工作

需要先安装 Node.js 18+ 和 npm。

推荐从 Node.js 官方下载页安装：[https://nodejs.org/en/download](https://nodejs.org/en/download)

* macOS/Windows：下载并安装 LTS 版本
* Linux：按发行版方式安装

macOS 用户也可以使用 Homebrew：

```bash
brew install node
```

安装完成后确认：

```bash
node -v
npm -v
```

## 安装 Grok CLI

使用 npm 全局安装：

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

安装完成后验证：

```bash
grok --version
```

## 配置接入

Grok CLI 提供三种配置方式，优先级为：命令行参数 > 环境变量 > 配置文件。

### 方式一：环境变量（推荐）

设置以下环境变量：

```bash
export GROK_BASE_URL="https://aicentos.com/v1"
export GROK_API_KEY="your_api_key_here"
```

临时测试直接在当前 shell 执行 export 即可。永久生效需将上述语句加入 `~/.zshrc` 或 `~/.bashrc`，然后执行 `source ~/.zshrc` 使其生效。

### 方式二：配置文件

编辑 `~/.grok/user-settings.json`：

```json
{
  "apiKey": "your_api_key_here",
  "baseURL": "https://aicentos.com/v1",
  "defaultModel": "gpt-4o"
}
```

### 方式三：命令行参数

启动时通过参数指定：

```bash
grok --base-url https://aicentos.com/v1
```

## 启动使用

配置完成后，直接运行：

```bash
grok
```

启动后在 Grok CLI 中发起对话，如果能正常收到回复，说明接入成功。

## 验证与排查

如果遇到鉴权错误，请检查：

* `GROK_API_KEY` 是否正确
* `GROK_BASE_URL` / `baseURL` 是否指向正确的服务地址（需要带 `/v1` 后缀）

确认配置无误后重新启动即可。

## 注意事项

* Grok CLI 使用 OpenAI 兼容接口，配置简单直接
* 三种配置方式可以灵活选择，推荐使用环境变量方式
* API 地址必须包含 `/v1` 后缀
* 支持自定义默认模型

## 相关链接

* 官方文档：[https://docs.aicentos.com/clients/grok-cli.html](https://docs.aicentos.com/clients/grok-cli.html)