# Grok CLI

出典: https://docs.aicentos.com/ja/clients/grok-cli

Language: ja

> 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 には 3 つの設定方法があり、優先順位は：コマンドライン引数 > 環境変数 > 設定ファイル です。

### 方法 1：環境変数（推奨）

以下の環境変数を設定します：

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

一時的なテストなら、現在の shell で export を実行するだけで OK です。永続化するには上記の文を `~/.zshrc` または `~/.bashrc` に追記し、`source ~/.zshrc` を実行して反映させます。

### 方法 2：設定ファイル

`~/.grok/user-settings.json` を編集します：

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

### 方法 3：コマンドライン引数

起動時に引数で指定します：

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

## 起動と利用

設定が完了したら、そのまま実行します：

```bash
grok
```

起動後に Grok CLI で会話を始め、正常に返信が受け取れれば接続成功です。

## 検証とトラブルシューティング

認証エラーが発生した場合は、以下を確認してください：

* `GROK_API_KEY` が正しいか
* `GROK_BASE_URL` / `baseURL` が正しいサービスアドレスを向いているか（`/v1` の接尾辞が必要です）

設定に問題がないことを確認したら、再起動すれば OK です。

## 注意事項

* Grok CLI は OpenAI 互換インターフェースを使用しており、設定はシンプルで直感的です
* 3 つの設定方法から柔軟に選択でき、環境変数方式がおすすめです
* API アドレスには `/v1` の接尾辞が必須です
* デフォルトモデルのカスタマイズに対応しています

## 関連リンク

* 公式ドキュメント：[https://docs.aicentos.com/clients/grok-cli.html](https://docs.aicentos.com/clients/grok-cli.html)