# Grok Build

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

Language: ja

> Grok Build で aicentos に接続する —— config.toml で model provider をカスタマイズ

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

## 準備

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

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

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

## 設定値

| 項目              | 値                                                  |
| --------------- | -------------------------------------------------- |
| base\_url       | `https://aicentos.com/v1`                          |
| api\_backend    | `chat_completions`（デフォルト値）                         |
| env\_key        | `AICENTOS_API_KEY`                                 |
| model           | コンソール「モデル広場」のモデル ID。例：`grok-4.7`、`claude-opus-4-8` |
| context\_window | 選択したモデルに応じて入力。例：`200000`                           |

## 設定手順

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

  ```bash
  export AICENTOS_API_KEY="your_api_key_here"
  ```

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

  ```toml
  [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 を起動し、モデルセレクターまたはコマンドで切り替えます：

  ```bash
  grok
  /model aicentos-grok
  ```

## テスト

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

```bash
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 側で行われます。先に[ウォレットページ](https://aicentos.com/wallet)で残高を確認してください。