ドキュメント / ツールを接続 / Gemini CLI 統合ガイド

Gemini CLI 統合ガイド

QCode.cc API キーで Google Gemini CLI を設定する

最終更新 2026-09-18
目次

最終確認：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

⚠️ 重要な変更：個人ログイン向けの 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 へ移行してください。

なおリポジトリは停止していません。確認日（2026-09-18）にも nightly が公開されており、最新の安定版は v0.60.0（2026-09-15）です。正確な表現は「消費者向けのログイン提供を停止した」で、「メンテナンス終了」ではありません。

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

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

Gemini CLI とは

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

利用可能なモデル

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

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

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

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

バージョンに関する注記: 2026-06-18 をもって Gemini CLI は Pro / Ultra / 無料の個人アカウントへの提供を停止しました。Google Antigravity CLI（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 認証向けとされているため、下記の通り両方の変数を設定してください。

macOS の設定

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

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

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

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

# Homebrew を更新
brew update

# Node.js をインストール
brew install node
方法 2：公式サイトからダウンロード

  1. https://nodejs.org/ にアクセス

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

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

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

macOS の注意点

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

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

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

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

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

node --version
npm --version

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

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

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

npm install -g @google/gemini-cli

インストール後、確認：

gemini --version

ステップ 3：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"

cr_xxxxxxxxxx を QCode.cc ダッシュボード の API キーに置き換えてください。Claude Code と同じ API キーを使用できます。

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

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

# 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"

その後、以下を実行：

source ~/.zshrc

Gemini CLI 環境変数の確認

ターミナルで確認：

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

Linux / WSL2 の設定

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

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

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

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

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

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

# 最新の LTS バージョンをインストール
nvm install --lts
方法 2：パッケージマネージャーを使用
# 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 インストールの確認

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

node --version
npm --version

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

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

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

npm install -g @google/gemini-cli

インストール後、確認：

gemini --version

ステップ 3：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"

cr_xxxxxxxxxx を QCode.cc ダッシュボード の API キーに置き換えてください。Claude Code と同じ API キーを使用できます。

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

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

# 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"

その後、以下を実行：

source ~/.bashrc

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

Gemini CLI 環境変数の確認

ターミナルで確認：

echo $GOOGLE_GEMINI_BASE_URL
echo $GEMINI_API_KEY
echo $GEMINI_MODEL

Windows の設定

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

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

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

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

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

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

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

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

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

# Chocolatey を使用
choco install nodejs

# または Scoop を使用
scoop install nodejs
Windows の注意点

  • CMD より PowerShell の使用を推奨

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

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

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

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

node --version
npm --version

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

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

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

npm install -g @google/gemini-cli

インストール後、確認：

gemini --version

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

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

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 ダッシュボード の API キーに置き換えてください。Claude Code と同じ API キーを使用できます。

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 で確認：

echo $env:GOOGLE_GEMINI_BASE_URL
echo $env:GEMINI_API_KEY
echo $env:GEMINI_MODEL

トラブルシューティング

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. バックアップエンドポイントを試す：

  4. 深セン：https://api.qcode.cc/gemini

関連ドキュメント

← 前のページ
Devin Desktop（旧 Windsurf）接続
次のページ →
Kilo Code 接続

関連ドキュメント

Roo Code 接続
VS Code 拡張 Roo Code から QCode.cc を使う：Anthropic provider を選び、カスタム base URL を有効にすれば Claude が使える
SillyTavern を QCode に接続する
SillyTavern で QCode.cc の Claude / GPT モデルを使ってチャットする方法、gpt-image-2 の画像生成を接続できるかについての正直な説明と代替手段
Aider 連携
QCode.cc で Aider を設定：Claude は Anthropic エンドポイント（anthropic/ プレフィックス）、GPT と中国系モデルは OpenAI 互換エンドポイント
🚀
QCode を始めよう — Claude Code & Codex
1つのプランで Claude Code と Codex の両方を加速、アジア太平洋低遅延
料金プランを見る → アカウント登録
3人以上のチーム？
企業版：専用ドメイン + サブKey管理 + 封禁保護、¥250/人/月〜
企業版を見る →