Skip to Content
aicentos

Grok CLI

Grok CLI で aicentos を使う —— 環境変数または設定ファイルによる接続

最終更新:

Grok CLI はコマンドラインツールで、OpenAI 互換インターフェースを使用しており、カスタム API アドレスをバックエンドサービスとしてそのまま接続できます。

準備

先に Node.js 18+ と npm をインストールする必要があります。

Node.js の公式ダウンロードページからのインストールをおすすめします:https://nodejs.org/en/download

  • macOS/Windows:LTS バージョンをダウンロードしてインストール
  • Linux:ディストリビューションごとの方法でインストール

macOS ユーザーは Homebrew も使えます:

brew install node

インストール完了後、次で確認します:

node -v
npm -v

Grok CLI のインストール

npm でグローバルインストールします:

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

インストール完了後、次で検証します:

grok --version

接続設定

Grok CLI には 3 つの設定方法があり、優先順位は:コマンドライン引数 > 環境変数 > 設定ファイル です。

方法 1:環境変数(推奨)

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

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 を編集します:

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

方法 3:コマンドライン引数

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

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

起動と利用

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

grok

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

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

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

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

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

注意事項

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

関連リンク