> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bettertoken.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Grok CLI のセットアップ：インストール、API Key、Base URL、カスタムモデル

> Grok CLI をインストールし、BetterToken の Base URL と API Key を設定して、対応プロバイダーのモデルを選び、よくあるエラーを解決します。

Grok CLI を BetterToken に接続するには、API Key を用意し、以下の Base URL を入力して、モデル広場から現在の Model ID を選択します。

## 主要な設定

| 項目       | 値                                                                   |
| -------- | ------------------------------------------------------------------- |
| API Key  | BetterToken API Key                                                 |
| Base URL | `https://www.bettertoken.ai/v1`                                     |
| Model    | <a href={"https://bettertoken.ai/pricing"}>モデル広場</a>にある現在の Model ID |

## 前提条件

* 現在のバージョンのツールがインストールされている
* BetterToken API Key：<a href={"https://bettertoken.ai/register"}>登録して取得</a>
* <a href={"https://bettertoken.ai/pricing"}>モデル広場</a>の Model ID

## インストール

### Grok CLI をインストールする

Windows、macOS、Linux で次を実行します。

```bash theme={null}
npm install -g @vibe-kit/grok-cli
```

インストール後に `grok` が見つからない場合は、ターミナルを閉じて開き直し、`grok --help` を実行します。グローバル `npm` パッケージディレクトリが `PATH` に含まれていることを確認してください。

## 手動設定

| 項目       | 値                                                                   |
| -------- | ------------------------------------------------------------------- |
| API Key  | BetterToken API Key                                                 |
| Base URL | `https://www.bettertoken.ai/v1`                                     |
| Model    | <a href={"https://bettertoken.ai/pricing"}>モデル広場</a>にある現在の Model ID |

### 必要なもの

* Node.js と `npm`
* BetterToken API Key：<a href={"https://bettertoken.ai/register"}>ここで登録</a>
* <a href={"https://bettertoken.ai/pricing"}>モデル広場</a>にある現在利用可能な**対応プロバイダーのモデル ID**

### Base URL と API Key を設定する

<Tabs>
  <Tab title="macOS / Linux">
    <Steps>
      <Step title="競合する変数を削除する">
        ```bash theme={null}
        unset OPENAI_API_KEY
        unset OPENAI_BASE_URL
        ```
      </Step>

      <Step title="BetterToken 変数を設定する">
        ```bash theme={null}
        export GROK_BASE_URL="https://www.bettertoken.ai/v1"
        export GROK_API_KEY="YOUR_API_KEY"
        ```
      </Step>

      <Step title="モデルを指定して Grok CLI を起動する">
        ```bash theme={null}
        grok --model YOUR_MODEL_ID
        ```

        `YOUR_MODEL_ID` を、モデル広場にある現在の**対応プロバイダーのモデル ID**に置き換えます。
      </Step>
    </Steps>
  </Tab>

  <Tab title="Windows PowerShell">
    <Steps>
      <Step title="現在の PowerShell ウィンドウの変数を設定する">
        ```powershell theme={null}
        $env:GROK_BASE_URL = "https://www.bettertoken.ai/v1"
        $env:GROK_API_KEY = "YOUR_API_KEY"
        ```
      </Step>

      <Step title="モデルを指定して Grok CLI を起動する">
        ```powershell theme={null}
        grok --model YOUR_MODEL_ID
        ```

        これらの変数は現在の PowerShell ウィンドウにのみ適用されます。新しいウィンドウを開くときは、チームで承認されたシークレット保存方法で再度設定してください。
      </Step>
    </Steps>
  </Tab>
</Tabs>

## 接続を確認する

短いテストプロンプトを送信します。認証または Model ID のエラーなしでツールがレスポンスを返せば、接続は機能しています。設定を変更した後はツールを完全に再起動してください。

Grok CLI の起動後に短いプロンプトを送信します。認証またはモデル ID のエラーなしで応答すれば、接続は準備できています。環境変数を変更したときは、現在の Grok CLI セッションを終了し、新しいセッションを開始してください。

## モデルを切り替える

モデルセレクターを開くか、設定の `Model` フィールドを変更します。<a href={"https://bettertoken.ai/pricing"}>モデル広場</a>にある正確な Model ID を使用してから、現在のセッションを再起動してください。

## よくあるエラー

| 症状                                         | 確認事項                                                                                               |
| ------------------------------------------ | -------------------------------------------------------------------------------------------------- |
| `grok: command not found`                  | もう一度インストールし、新しいターミナルを開いて `grok --help` を確認します。                                                     |
| `401`、`Unauthorized`、または `Invalid API key` | `GROK_API_KEY` を確認し、余分な空白がコピーされていないことと、変数を設定した同じターミナルで Grok CLI を起動していることを確認します。                   |
| `model not found` または利用不可モデル               | モデル広場の**対応プロバイダー**から現在のモデル ID をコピーします。Claude プロバイダーの ID は使用しないでください。                               |
| リクエストで以前のサービスが使われる                         | `GROK_BASE_URL` を確認し、`/chat/completions` を追加せずに、ターミナルと Grok CLI を再起動します。                           |
| 接続エラー                                      | Base URL が `https://www.bettertoken.ai/v1` であり、ネットワークから HTTPS 経由で `bettertoken.ai` に到達できることを確認します。 |

### セットアップ FAQ

**Grok CLI ではどの Base URL を使用すべきですか？**

`https://www.bettertoken.ai/v1` を使用します。これは BetterToken の OpenAI 互換 Base URL です。

**どの API Key とモデルを選択すべきですか？**

BetterToken API Key と、同じグループのモデルを使用します。

**システムプロキシを変更したり VPN を有効にしたりする必要がありますか？**

いいえ。ターミナルで Base URL と API Key を設定して BetterToken に接続します。

## Advanced setup

## 対応プロバイダー

| プロバイダー | 対応状況 |
| ------ | ---- |
| Claude | 未対応  |
| GPT    | 手動設定 |
| Kimi   | 手動設定 |
| GLM    | 手動設定 |

<Note>ここに示す対応状況は、このページで説明する BetterToken の設定方法に適用されます。</Note>

<Accordion title="設定方法の説明">
  * **手動設定**：API Key、Base URL、Model を入力します。
  * **未対応**：検証済みの直接接続方法はまだありません。
</Accordion>

### 関連ガイド

* [カスタムプロバイダーで Codex CLI を設定する](/ja/ai-tools/codex)
* [Cursor でカスタム API、Base URL、API Key を設定する](/ja/ai-tools/cursor)
* [Cline で OpenAI 互換 API を設定する](/ja/ai-tools/cline)
* [OpenAI 互換 API と Anthropic 互換 API](/ja/faq/concepts/openai-compatible-vs-anthropic-compatible)
* [MCP と API Key / Base URL の違い](/ja/faq/concepts/mcp-vs-api-key-base-url)

## 技術詳細

<Accordion title="プロトコル、Endpoint、内部プロバイダーフィールド">
  この設定では `https://www.bettertoken.ai/v1` を使用します。ツールが OpenAI 互換の Endpoint パスを追加します。特定のフィールドで明示的に要求されない限り、`/chat/completions` や `/responses` を追加しないでください。
</Accordion>