Gemini CLI を CodingPlanX カスタムモデルと連携する

CodingPlanX.ai の API キーを使用して Google Gemini CLI を設定する

Gemini CLI 統合設定ガイド

CodingPlanX.ai は Claude Code、OpenAI Codex、そして Google Gemini CLI をサポートしています。プラン購入後、これら3つのツールはプランの利用枠を共有するため、どのツールを使用するか柔軟に選択できます。

Gemini CLI とは

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

利用可能なモデル

CodingPlanX.ai を通じて以下の 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://api.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

> cr_xxxxxxxxxx をあなたの CodingPlanX.ai API キーに置き換えてください。Claude Code と同じ API キーを使用できます。

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

以下の内容を shell の設定ファイル（~/.zshrc）に追加します：

# Gemini CLI 設定
export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
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

# shell 設定の再読み込み
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 を使用すると権限問題を回避できます
shell の設定ファイルで 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.codingplanx.ai"
export GEMINI_API_KEY="cr_xxxxxxxxxx"
export GEMINI_MODEL="gemini-3-pro-preview"

> cr_xxxxxxxxxx をあなたの CodingPlanX.ai API キーに置き換えてください。Claude Code と同じ API キーを使用できます。

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

以下の内容を shell の設定ファイル（~/.bashrc）に追加します：

# Gemini CLI 設定
export GOOGLE_GEMINI_BASE_URL="https://api.codingplanx.ai"
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 ファイルをダブルクリックします
インストールウィザードに従ってインストールを完了します（デフォルト設定のままでOKです）

方法 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.codingplanx.ai"
$env:GEMINI_API_KEY = "cr_xxxxxxxxxx"
$env:GEMINI_MODEL = "gemini-3-pro-preview"

> cr_xxxxxxxxxx をあなたの CodingPlanX.ai API キーに置き換えてください。Claude Code と同じ API キーを使用できます。

PowerShell での永続的な設定（ユーザーレベル）

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

# ユーザーレベルの環境変数を設定（永続的に有効）
[System.Environment]::SetEnvironmentVariable("GOOGLE_GEMINI_BASE_URL", "https://api.codingplanx.ai", [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_ で始まる必要があります）

ネットワーク接続の問題

問題：CodingPlanX.ai サービスに接続できない

解決策：

ネットワーク接続が正常か確認してください
GOOGLE_GEMINI_BASE_URL が正しく設定されているか確認してください