# Grok CLI

來源: https://docs.aicentos.com/zh-TW/clients/grok-cli

Language: zh-TW

> 在 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)