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

# CometAPI で Gemini CLI を使う

> このガイドでは、CometAPI の認証情報、base URL 設定、Gemini model ID を使って Gemini CLI を設定する方法を説明します。

このガイドでは、API エンドポイントとして CometAPI を使用して [Gemini CLI](https://github.com/google-gemini/gemini-cli) を実行する方法を説明します。

公式リファレンス:

* [Gemini CLI GitHub](https://github.com/google-gemini/gemini-cli)
* [Gemini CLI Authentication](https://github.com/google-gemini/gemini-cli/blob/main/docs/get-started/authentication.mdx)

<Note>
  model の利用可否は時間とともに変化します。利用可能な Gemini model については
  [CometAPI Models page](/ja/overview/models) を確認してください。
</Note>

## 前提条件

| 要件           | 詳細                                                                |
| ------------ | ----------------------------------------------------------------- |
| Node.js      | 22+（LTS 推奨）                                                       |
| OS           | macOS、Linux、または Windows                                           |
| CometAPI key | [CometAPI Dashboard](https://www.cometapi.com) から取得（`sk-` で始まります） |

## セットアップ

<Steps>
  <Step title="Gemini CLI をインストール">
    ```bash theme={null}
    npm install -g @google/gemini-cli
    ```

    または Homebrew（macOS / Linux）経由:

    ```bash theme={null}
    brew install gemini-cli
    ```

    確認:

    ```bash theme={null}
    gemini --version
    ```
  </Step>

  <Step title="環境変数を設定">
    ```bash theme={null}
    export GEMINI_API_KEY="sk-your-cometapi-key"
    export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"
    ```

    `sk-your-cometapi-key` を実際の CometAPI key に置き換えてください。
  </Step>

  <Step title="Gemini CLI を起動">
    ```bash theme={null}
    cd your-project
    gemini
    ```

    初回起動時には、テーマの選択、安全に関する注意の確認、作業ディレクトリの信頼確認を求められます。
  </Step>
</Steps>

## 環境変数を永続化する

セッションごとに毎回 export しなくて済むように、シェル設定に追加します:

```bash theme={null}
# Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"
```

変更を反映するには、ターミナルを再起動してください。

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

<AccordionGroup>
  <Accordion title="無効な API キー エラー">
    `GEMINI_API_KEY` が正しく設定されていることを確認してください。確認するには `echo $GEMINI_API_KEY` を実行します。
  </Accordion>

  <Accordion title="fetch failed">
    ネットワーク制限によって接続がブロックされている可能性があります。システム全体のプロキシを試してください。
  </Accordion>

  <Accordion title="Node.js のバージョンが正しくない">
    Gemini CLI には Node.js 22+ が必要です。確認するには `node --version` を実行します。
  </Accordion>

  <Accordion title="Gemini CLI をアンインストールする">
    `npm uninstall -g @google/gemini-cli` を実行します。
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#howto",
        "name": "CometAPI で Gemini CLI を使う",
        "description": "このガイドでは、Gemini CLI を CometAPI の認証情報、base URL 設定、Gemini の model ID で構成する方法を説明します。",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-1",
            "position": 1,
            "name": "Gemini CLI をインストールする",
            "text": "CometAPI で Gemini CLI を使うガイドの「Gemini CLI をインストールする」手順を完了してください。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-2",
            "position": 2,
            "name": "環境変数を設定する",
            "text": "CometAPI で Gemini CLI を使うガイドの「環境変数を設定する」手順を完了してください。"
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-3",
            "position": 3,
            "name": "Gemini CLI を起動する",
            "text": "CometAPI で Gemini CLI を使うガイドの「Gemini CLI を起動する」手順を完了してください。"
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI ドキュメント",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "連携",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "CometAPI で Gemini CLI を使う",
            "item": "https://apidoc.cometapi.com/integrations/gemini-cli"
          }
        ]
      }
    ]
    }
    `}
</script>