# Gemini CLI 統合ガイド

> **最終確認**：2026-09-18 · 📄 公式ドキュメント準拠（Gemini CLI v0.60.0（2026-09-15。Pro / 無料枠は 2026-06-18 に提供終了、企業課金キーは継続））

## 概要

| 項目 | 内容 |
|---|---|
| 利用できるモデル | Gemini ✅ · Claude ❌ · GPT ❌ · 中国系モデル ❌ |
| プロトコルと Base URL | Gemini：`https://api.qcode.cc/gemini`（CLI が `/v1beta/...` を自動付与。手動で付けない） |
| 設定場所 | `~/.gemini/settings.json` または環境変数 `GOOGLE_GEMINI_BASE_URL` + `GEMINI_API_KEY` |
| 公式ドキュメント | [google-gemini/gemini-cli](https://github.com/google-gemini/gemini-cli) |

> **⚠️ 重要な変更：個人ログイン向けの Gemini CLI は Google Antigravity CLI に置き換わりました**。2026-05-19 の公式発表の原文では、**2026-06-18** をもって Gemini CLI と Gemini Code Assist の IDE 拡張が「will stop serving requests」とされ、対象は **Google AI Pro、Ultra**、および個人アカウントで無料利用しているユーザーです。同日に提供開始されたのは **Antigravity CLI と Antigravity 2.0**（IDE としての Antigravity は 2025-11-18 に先行リリース済み）。企業向けは扱いが別で、Gemini Code Assist Standard / Enterprise ライセンスの組織は継続、同じ発表に「Gemini CLI will remain accessible via paid Gemini and Gemini Enterprise Agent Platform API keys」と明記されています。**したがって本ページは企業向け有料キーでは引き続き有効**です。Pro / Ultra / 無料枠は [Google Antigravity CLI](/docs/ide/antigravity) へ移行してください。
>
> なおリポジトリは停止していません。確認日（2026-09-18）にも nightly が公開されており、最新の安定版は v0.60.0（2026-09-15）です。正確な表現は「**消費者向けのログイン提供を停止した**」で、「メンテナンス終了」ではありません。

> **🚧 試用段階**：Gemini リソースは現在限定的に提供されており、大規模な提供はまだ行われていません。大量利用のニーズがある場合は、[オンラインサポート](javascript:void(Tawk_API.toggle()))にお問い合わせいただくか、**hi@qcode.cc** までメールをお送りください。専用の Gemini リソースをご用意いたします。

QCode.cc は Claude Code、OpenAI Codex、Google Gemini CLI をサポートしています。プランを購入すると、3つのツールは**同じ配分を共有**するため、どのツールを使用するか柔軟に選択できます。

## Gemini CLI とは

[Gemini CLI](https://geminicli.com/) は Google が提供するコマンドライン AI プログラミングアシスタントで、Claude Code と同様に、ターミナルでのコード開発、デバッグ、ファイル操作をサポートします。

## 利用可能なモデル

QCode.cc 経由で以下の Gemini モデルが利用可能です：

**リアルタイム照会を正典としてください**。本ページを含め、いかなる文書の固定リストも
転記しないでください：

```bash
curl -s https://api.qcode.cc/gemini/v1beta/models \
  -H "x-goog-api-key: cr_あなたのQCodeキー"
```

返ってきた id が現在呼べる Gemini モデルです。`GEMINI_MODEL` に設定してください。
販売中の一覧とリアルタイム単価は [qcode.cc/models](https://qcode.cc/models) を参照。

> **バージョンに関する注記**: 2026-06-18 をもって Gemini CLI は Pro / Ultra / 無料の個人アカウントへの提供を停止しました。[Google Antigravity CLI](https://antigravity.google/)（Antigravity CLI と Antigravity 2.0 は 2026-05-19 に提供開始）への移行をお願いします。エンタープライズの有料キーは影響を受けず、引き続き Gemini CLI を利用できます。

## 設定の概要

Gemini CLI には以下の環境変数が必要です：

- `GOOGLE_GEMINI_BASE_URL` - サービスエンドポイント

- `GEMINI_API_KEY` - API キー（Claude Code と同じ）

- `GEMINI_MODEL` - モデル選択
設定ファイルも公式がサポートする経路です：ユーザーレベルは `~/.gemini/settings.json`、プロジェクトレベルは `.gemini/settings.json`（プロジェクト側が優先）。モデルは `model.name`、認証種別は `security.auth.selectedType`。ファイル内の文字列値は `$VAR`、`${VAR}`、`${VAR:-既定値}` で環境変数を参照できます。公式ドキュメントでは `GOOGLE_GEMINI_BASE_URL` は gemini-api-key 認証向けとされているため、下記の通り両方の変数を設定してください。


<div data-os="macos" markdown="1">

## macOS の設定

### ステップ 1：Node.js のインストール

Gemini CLI を実行するには Node.js が必要です。

#### 方法 1：Homebrew を使用（推奨）

Homebrew がインストールされている場合、Node.js のインストールに使用できます：

```bash
# Homebrew を更新
brew update

# Node.js をインストール
brew install node
```

#### 方法 2：公式サイトからダウンロード

1. [https://nodejs.org/](https://nodejs.org/) にアクセス

2. macOS 用の LTS バージョンをダウンロード

3. ダウンロードした `.pkg` ファイルを開く

4. インストーラーの指示に従ってインストールを完了

#### macOS の注意点

- 権限の問題が発生した場合は `sudo` が必要な場合があります

- 初回実行時はシステム環境設定での許可が必要な場合があります

- Terminal または iTerm2 の使用を推奨

#### Node.js インストールの確認

インストール後、Terminal を開いて以下のコマンドを実行：

```bash
node --version
npm --version
```

バージョン番号が表示されれば、インストール成功です！

### ステップ 2：Gemini CLI のインストール

npm を使用して Gemini CLI をグローバルにインストール：

```bash
npm install -g @google/gemini-cli
```

インストール後、確認：

```bash
gemini --version
```

### ステップ 3：Gemini CLI 環境変数の設定

プロキシサービスに接続するために以下の環境変数を設定します：

#### 一時的な設定（現在のセッション）

ターミナルで以下のコマンドを実行：

```bash
export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"
```

> `cr_xxxxxxxxxx` を [QCode.cc ダッシュボード](https://qcode.cc/dashboard) の API キーに置き換えてください。Claude Code と同じ API キーを使用できます。

#### 永続的な設定（シェル設定ファイル）

シェル設定ファイル（`~/.zshrc`）に以下を追加：

```bash
# Gemini CLI 設定
export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"
```

その後、以下を実行：

```bash
source ~/.zshrc
```

### Gemini CLI 環境変数の確認

ターミナルで確認：

```bash
echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL
```

</div>

<div data-os="linux" markdown="1">

## Linux / WSL2 の設定

### ステップ 1：Node.js のインストール

Gemini CLI を実行するには Node.js が必要です。

#### 方法 1：nvm を使用（推奨）

nvm を使用すると、複数の Node.js バージョンを簡単に管理できます：

```bash
# nvm をインストール
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash

# シェル設定を再読み込み
source ~/.bashrc

# 最新の LTS バージョンをインストール
nvm install --lts
```

#### 方法 2：パッケージマネージャーを使用

```bash
# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
sudo apt-get install -y nodejs

# Fedora
sudo dnf install nodejs

# Arch Linux
sudo pacman -S nodejs npm
```

#### Linux / WSL2 の注意点

- WSL2 ユーザーは Windows ではなく Linux サブシステムにインストールすることを推奨

- nvm を使用すると権限の問題を回避できます

- シェル設定ファイルが nvm を正しく読み込んでいることを確認

#### Node.js インストールの確認

インストール後、ターミナルを開いて以下のコマンドを実行：

```bash
node --version
npm --version
```

バージョン番号が表示されれば、インストール成功です！

### ステップ 2：Gemini CLI のインストール

npm を使用して Gemini CLI をグローバルにインストール：

```bash
npm install -g @google/gemini-cli
```

インストール後、確認：

```bash
gemini --version
```

### ステップ 3：Gemini CLI 環境変数の設定

プロキシサービスに接続するために以下の環境変数を設定します：

#### 一時的な設定（現在のセッション）

ターミナルで以下のコマンドを実行：

```bash
export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"
```

> `cr_xxxxxxxxxx` を [QCode.cc ダッシュボード](https://qcode.cc/dashboard) の API キーに置き換えてください。Claude Code と同じ API キーを使用できます。

#### 永続的な設定（シェル設定ファイル）

シェル設定ファイル（`~/.bashrc`）に以下を追加：

```bash
# Gemini CLI 設定
export GOOGLE_GEMINI_BASE_URL="https://api.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-2.5-pro"
```

その後、以下を実行：

```bash
source ~/.bashrc
```

Zsh を使用している場合は、`~/.zshrc` に追加して `source ~/.zshrc` を実行してください。

### Gemini CLI 環境変数の確認

ターミナルで確認：

```bash
echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL
```

</div>

<div data-os="windows" markdown="1">

## Windows の設定

### ステップ 1：Node.js のインストール

Gemini CLI を実行するには Node.js が必要です。

#### 方法 1：公式サイトからダウンロード（推奨）

1. ブラウザで [https://nodejs.org/](https://nodejs.org/) にアクセス

2. "LTS" バージョンをクリックしてダウンロード（安定版を推奨）

3. ダウンロードした `.msi` ファイルをダブルクリック

4. インストールウィザードに従い、デフォルト設定のまま完了

#### 方法 2：パッケージマネージャーを使用

Chocolatey または Scoop がインストールされている場合、コマンドラインを使用：

```powershell
# Chocolatey を使用
choco install nodejs

# または Scoop を使用
scoop install nodejs
```

#### Windows の注意点

- CMD より PowerShell の使用を推奨

- 権限の問題が発生した場合は管理者として実行

- 一部のウイルス対策ソフトが誤検知する場合があります；必要に応じてホワイトリストに追加

#### Node.js インストールの確認

インストール後、PowerShell または CMD を開いて以下のコマンドを実行：

```powershell
node --version
npm --version
```

バージョン番号が表示されれば、インストール成功です！

### ステップ 2：Gemini CLI のインストール

npm を使用して Gemini CLI をグローバルにインストール：

```powershell
npm install -g @google/gemini-cli
```

インストール後、確認：

```powershell
gemini --version
```

### ステップ 3：Gemini CLI 環境変数の設定

プロキシサービスに接続するために以下の環境変数を設定します：

#### PowerShell 一時設定（現在のセッション）

PowerShell で以下のコマンドを実行：

```powershell
$env:GOOGLE_GEMINI_BASE_URL = "https://api.qcode.cc/gemini"
$env:GEMINI_API_KEY = "cr_xxxxxxxxxx"
$env:GEMINI_MODEL = "gemini-2.5-pro"
```

> `cr_xxxxxxxxxx` を [QCode.cc ダッシュボード](https://qcode.cc/dashboard) の API キーに置き換えてください。Claude Code と同じ API キーを使用できます。

#### PowerShell 永続設定（ユーザーレベル）

PowerShell で以下のコマンドを実行：

```powershell
# ユーザーレベルの環境変数を設定（永続）
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.qcode.cc/gemini", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-2.5-pro", [System.EnvironmentVariableTarget]::User)
```

> 変更を有効にするには、PowerShell を再起動する必要があります。

### Gemini CLI 環境変数の確認

PowerShell で確認：

```powershell
echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL
```

</div>

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

### Node.js バージョンが古い

**問題**：Gemini CLI が Node.js バージョンの非互換性を報告

**解決策**：

1. Node.js バージョンを確認：`node --version`

2. 公式の要件は Node.js **20.0.0 以上**（パッケージ内の `engines.node >=20.0.0`。18 のままだとインストール直後にエラーになります）

3. nvm でアップグレード：`nvm install --lts && nvm use --lts`

### 環境変数が反映されない

**問題**：環境変数を設定後も接続できない

**解決策**：

1. ターミナルを再起動したか、`source` コマンドを実行したか確認

2. 変数名が正しいか確認（大文字小文字を区別）

3. API キーの形式が正しいか確認（`cr_` で始まる）

### ネットワーク接続の問題

**問題**：QCode.cc サービスに接続できない

**解決策**：

1. ネットワーク接続を確認

2. `GOOGLE_GEMINI_BASE_URL` が正しく設定されているか確認

3. バックアップエンドポイントを試す：
   - 深セン：`https://api.qcode.cc/gemini`

## 関連ドキュメント

- [Antigravity CLI の接続](/docs/ide/antigravity) - Gemini CLI の公式後継
- [環境変数の設定](/docs/getting-started/environment) - Claude Code のセットアップ

- [Codex 統合](/docs/ide/codex) - OpenAI Codex CLI の設定

- [クイックスタート](/docs/getting-started/quick-start) - Claude Code の使い方