Grok Build

Grok Build は xAI のターミナル向けコーディング Agent で、デフォルトでは xAI 公式インターフェースを呼び出しますが、~/.grok/config.toml に任意の OpenAI 互換 [model.*] エンドポイントを宣言できます。エンドポイントを aicentos に向ければ、同じ Key で grok 系列や他ベンダーのモデルを呼び出せます。

準備アンカーリンクをコピー

• Grok Build をインストールします（公式スクリプト）：

  コピー

  curl -fsSL https://x.ai/cli/install.sh | bash

• aicentos コンソールで専用のキーを 1 つ作成します（名前は grok-build がおすすめです）。

設定値アンカーリンクをコピー

設定手順アンカーリンクをコピー

• キーを shell の環境変数に書き込みます（~/.zshrc または ~/.bashrc に書き、source で反映します）：

  コピー

  export AICENTOS_API_KEY="your_api_key_here"

• ~/.grok/config.toml を編集し、カスタムモデルを 1 つ追加します：

  コピー

  [models]
  default = "aicentos-grok"
  
  [model.aicentos-grok]
  base_url          = "https://aicentos.com/v1"
  env_key           = "AICENTOS_API_KEY"
  api_backend       = "chat_completions"
  context_window    = 200000
  max_completion_tokens = 8192
  description       = "aicentos gateway - grok-4.7"

  [model.<name>] の <name> がそのままモデル ID になります。複数のモデルを接続したい場合、たとえば grok-4.7 と claude-opus-4-8 なら、[model.grok-4.7]、[model.claude-opus-4-8] のセクションをそれぞれ追加します。

• Grok Build を起動し、モデルセレクターまたはコマンドで切り替えます：

  コピー

  grok
  /model aicentos-grok

テストアンカーリンクをコピー

まずモデルが認識されているか一覧表示します：

grok models

次に軽いプロンプトを 1 つ送り（例：grok -p "現在のディレクトリを一文で紹介して" -m aicentos-grok）、正常に返ることを確認します。

注意事項アンカーリンクをコピー

• Grok Build には --base-url のコマンドライン引数がありません。カスタムエンドポイントは設定ファイルか環境変数で指定します。
• api_backend のデフォルトは chat_completions です。明示的に responses や messages と書く場合は、ゲートウェイが対応するエンドポイントをサポートしているか確認してください。対応していないと失敗します。
• 認証情報の解決順序は：モデル設定の api_key → env_key で指定した環境変数 → ログイン済みセッショントークン → グローバルの XAI_API_KEY です。ここでは env_key で自分の変数名を参照すればよく、xAI 公式アカウントに混ざることはありません。
• 新規モデルで context_window を省略すると、Grok Build はデフォルトで 200,000 として扱います。選択したモデルに応じて明示的に入力することをおすすめします。
• カスタムエンドポイントに接続すれば xAI のサブスクリプションには依存しませんが、選択されたモデルの課金は引き続き aicentos 側で行われます。先にウォレットページで残高を確認してください。