Gemini 統合設定

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

Gemini CLI 統合ガイド ¶

🚧 試用段階：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 モデルが利用可能です：

モデル	説明
`gemini-3-pro-preview`	最新プレビュー版、推奨
`gemini-2.5-pro`	安定版

最新バージョン: Gemini CLI v0.33.1（2026-03-12）、Extensions システム、カスタムテーマなどの新機能を搭載。

設定の概要 ¶

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

GOOGLE_GEMINI_BASE_URL - サービスエンドポイント
GEMINI_API_KEY - API キー（Claude Code と同じ）
GEMINI_MODEL - モデル選択

macOS の設定 ¶

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

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

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

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

# Homebrew を更新
brew update

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

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

https://nodejs.org/ にアクセス
macOS 用の LTS バージョンをダウンロード
ダウンロードした .pkg ファイルを開く
インストーラーの指示に従ってインストールを完了

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://asia.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

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

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

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

# Gemini CLI 設定
export GOOGLE_GEMINI_BASE_URL="https://asia.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

その後、以下を実行：

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://asia.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

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

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

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

# Gemini CLI 設定
export GOOGLE_GEMINI_BASE_URL="https://asia.qcode.cc/gemini"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

その後、以下を実行：

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：公式サイトからダウンロード（推奨）¶

ブラウザで https://nodejs.org/ にアクセス
"LTS" バージョンをクリックしてダウンロード（安定版を推奨）
ダウンロードした .msi ファイルをダブルクリック
インストールウィザードに従い、デフォルト設定のまま完了

方法 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://asia.qcode.cc/gemini"
$env:GEMINI_API_KEY = "cr_xxxxxxxxxx"
$env:GEMINI_MODEL = "gemini-3-pro-preview"

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

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

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

# ユーザーレベルの環境変数を設定（永続）
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://asia.qcode.cc/gemini", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_API_KEY", "cr_xxxxxxxxxx", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("GEMINI_MODEL", "gemini-3-pro-preview", [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 バージョンの非互換性を報告

解決策：

Node.js バージョンを確認：node --version
Node.js 18.x 以上を推奨
nvm でアップグレード：nvm install --lts && nvm use --lts

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

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

解決策：

ターミナルを再起動したか、source コマンドを実行したか確認
変数名が正しいか確認（大文字小文字を区別）
API キーの形式が正しいか確認（cr_ で始まる）

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

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

解決策：

ネットワーク接続を確認
GOOGLE_GEMINI_BASE_URL が正しく設定されているか確認
バックアップエンドポイントを試す：
香港：http://103.218.243.5/gemini
深セン：http://103.236.53.153/gemini

QCode.cc の優位性 ¶

優位性	説明
80% コスト削減	公式価格より大幅に低い
共有配分	Claude Code、Codex、Gemini が同じプラン配分を共有
99.9% 可用性	エンタープライズグレードの安定サービス
アジア太平洋最適化	低遅延、高速レスポンス