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 -vGrok 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の接尾辞が必須です - デフォルトモデルのカスタマイズに対応しています