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

# Gemini CLI

> TokenLab API を使用するように Google Gemini CLI を設定する

## 概要

<Note>
  **種類**: コーディングツール

  **主要パス**: Gemini-native

  **サポートレベル**: best-effort
</Note>

Google Gemini CLI は、Gemini モデルとやり取りするためのコマンドラインツールです。TokenLab は互換性のあるエンドポイントを提供しており、Gemini CLI を使用して 300 以上のモデルにアクセスできます。

<Warning>
  これは実験的な互換構成です。Gemini CLI は現在、TokenLab のようなカスタム Base URL ワークフローを安定した形で公式には文書化していません。サポートされた TokenLab のターミナル運用が必要なら、Codex CLI、Claude Code、OpenCode を優先してください。
</Warning>

## システム要件

* **Node.js**: バージョン 20.0 以上
* **OS**: Windows 10/11、macOS 10.15 以上、Ubuntu 20.04 以上、または Debian 10 以上

## インストール

```bash theme={null}
npm install -g @google/gemini-cli
```

インストールの確認:

```bash theme={null}
gemini --version
```

## 設定

### ステップ 1: API キーの取得

1. [TokenLab ダッシュボード](https://tokenlab.sh/dashboard)にログインします
2. [API キー](https://tokenlab.sh/dashboard/api)に移動します
3. API キーを作成してコピーします（形式: `sk-...`）

### ステップ 2: 環境変数の設定

**一時的（現在のセッション）:**

```bash theme={null}
export GEMINI_API_KEY="sk-your-tokenlab-key"
export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"
```

**永続的な設定:**

シェル設定ファイルに追加します:

<Tabs>
  <Tab title="Bash">
    ```bash theme={null}
    echo 'export GEMINI_API_KEY="sk-your-tokenlab-key"' >> ~/.bashrc
    echo 'export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"' >> ~/.bashrc
    source ~/.bashrc
    ```
  </Tab>

  <Tab title="Zsh">
    ```bash theme={null}
    echo 'export GEMINI_API_KEY="sk-your-tokenlab-key"' >> ~/.zshrc
    echo 'export GOOGLE_GEMINI_BASE_URL="https://api.tokenlab.sh"' >> ~/.zshrc
    source ~/.zshrc
    ```
  </Tab>

  <Tab title="Fish">
    ```bash theme={null}
    set -Ux GEMINI_API_KEY "sk-your-tokenlab-key"
    set -Ux GOOGLE_GEMINI_BASE_URL "https://api.tokenlab.sh"
    ```
  </Tab>
</Tabs>

<Warning>
  設定を反映させるために、設定後にターミナルを再起動してください。
</Warning>

<Note>
  **既知の制限事項**: キャッシュされた Google セッションがある場合、Gemini CLI が `GOOGLE_GEMINI_BASE_URL` を無視することがあります。接続の問題が発生した場合は、CLI キャッシュをクリアするか、新しいターミナルセッションを開始してください。
</Note>

## 基本的な使い方

プロジェクトディレクトリから Gemini CLI を起動します:

```bash theme={null}
cd your-project
gemini
```

初回実行時には、以下の操作を行います:

1. テーマの選択
2. 安全に関する通知の確認
3. 作業ディレクトリの信頼設定

## 利用可能なモデル

| モデル                     | 説明                |
| ----------------------- | ----------------- |
| `gemini-2.5-pro`        | 最も高性能な Gemini モデル |
| `gemini-3.5-flash`      | 高速で、ほとんどのタスクに効率的  |
| `gemini-3.1-flash-lite` | 現行の軽量 Gemini モデル  |

## よく使うコマンド

**質問する:**

```
> What is the best way to structure a React app?
```

**コードを分析する:**

```
> Explain the code in src/main.ts
```

**コードを生成する:**

```
> Create a Python function to parse JSON files
```

**変更をレビューする:**

```
> Review the recent git changes and suggest improvements
```

## 設定の確認

```bash theme={null}
# 環境変数の確認
echo $GEMINI_API_KEY
echo $GOOGLE_GEMINI_BASE_URL

# 接続テスト
gemini
```

## トラブルシューティング

<AccordionGroup>
  <Accordion title="接続エラー">
    * `GOOGLE_GEMINI_BASE_URL` が `https://api.tokenlab.sh` に設定されていることを確認してください
    * 注意: Gemini エンドポイントには `/v1` サフィックスは不要です
    * ネットワーク接続を確認してください
  </Accordion>

  <Accordion title="認証失敗">
    * `GEMINI_API_KEY` 環境変数が設定されていることを確認してください
    * キーが `sk-` で始まっていることを確認してください
    * TokenLab ダッシュボードでキーが有効であることを確認してください
  </Accordion>

  <Accordion title="モデルが利用不可">
    * [tokenlab.sh/en/models](https://tokenlab.sh/ja/models) で Gemini モデルの利用可能性を確認してください
    * 別の Gemini モデルバリアントを試してください
  </Accordion>
</AccordionGroup>

## ベストプラクティス

<AccordionGroup>
  <Accordion title="プロジェクトディレクトリで使用する">
    コンテキストをより正確に理解させるため、常にプロジェクトのルートから Gemini CLI を実行してください。
  </Accordion>

  <Accordion title="ディレクトリの信頼設定は慎重に行う">
    自身が所有するディレクトリのみを信頼してください。Gemini CLI はファイルを読み取り、変更する可能性があります。
  </Accordion>

  <Accordion title="生成されたコードをレビューする">
    プロジェクトにコミットする前に、AI が生成したコードを必ずレビューしてください。
  </Accordion>
</AccordionGroup>