Gemini プラグイン Windows 対応 トラブルシューティング記録

目次

概要

Claude Code に Gemini プラグインを導入する過程で発生した Windows 固有の問題と、その解決までの経緯をまとめる。

1. 最初のセットアップ（sakibsadmanshajib/gemini-plugin-cc）

インストール手順

/plugin marketplace add sakibsadmanshajib/gemini-plugin-cc
/plugin install gemini-plugin-cc@gemini-plugin-cc
/reload-plugins

認証設定

C:\Users\{username}\.claude\settings.json の "env" セクションに追記：

{
    "enabledPlugins": {
        "codex@openai-codex": true,
        "gemini@google-gemini": true
    },
    "env": {
        "GEMINI_API_KEY": "AIza..."
    }
}

注意： プロジェクト固有の settings.local.json ではなく、ホームディレクトリ（C:\Users\{username}\.claude\）の settings.json に追記すること。Claude Code はこちらを優先的に読み込む。

セットアップ確認結果

- Status: Available and authenticated
- Auth method: API key
- Review Gate: Off

2. 問題発生：ACP process is not ready

エラー内容

Error: Shell command failed for pattern "!node
"C:/Users/{username}/.claude/plugins/cache/google-gemini/gemini/
1.0.1/scripts/gemini-companion.mjs" review "": [stderr]
Review failed: ACP process is not ready.

試みた対処（効果なし）

対処結果
Gemini CLI を最新版に更新（npm update -g @google/gemini-cli）解消せず
/gemini:review --wait で同期実行同じエラー
GEMINI_ACP_TIMEOUT_MS: "60000" でタイムアウト延長解消せず
abiswas97/gemini-plugin-cc に切り替え同じ設計のため同じエラー

根本原因の特定

Windows 固有の Unix socket 非対応問題。

このプラグインの通信アーキテクチャ：

Claude Code ──[Bash]──> gemini-companion.mjs ──[Unix socket]──> ACP Broker
                                                                      |
                                                               gemini --acp (persistent)
  • ACPブローカーは Unix socket を使って JSON-RPC 通信を行う
  • Unix socket は Windows ネイティブ環境では動作しない
  • !gemini --acp 自体は起動するが、プラグインがそのプロセスに接続できない

影響するプラグイン（Unix socket 使用のため Windows 非対応）

  • sakibsadmanshajib/gemini-plugin-cc
  • abiswas97/gemini-plugin-cc

3. 解決：rsecss/gemini-plugin-cc への切り替え

選定理由

rsecss/gemini-plugin-cc は ACP ブローカーを使わない直接呼び出し方式 を採用しており、README に「comprehensive Windows compatibility fixes」と明記されている唯一のプラグイン。

通信アーキテクチャの違い：

プラグイン方式Windows 対応
sakibsadmanshajibUnix socket（ACPブローカー）❌
abiswas97Unix socket（ACPブローカー）❌
rsecss直接 CLI 呼び出し（gemini -p "..."）✅

切り替え手順

Step 1：古いプラグインをアンインストール

Claude Code のプロンプトで：

/plugin uninstall gemini@google-gemini

確認ダイアログで y を入力（永続データも含めて削除）。

Step 2：新しいプラグインをインストール

/plugin marketplace add rsecss/gemini-plugin-cc
/plugin install gemini@gemini-plugin
/reload-plugins

Step 3：動作確認

/gemini:setup

確認結果：

- Node.js: v24.15.0
- Authentication: GEMINI_API_KEY configured
- Review Gate: Off

4. 動作確認

/gemini:review を実行し、以下の選択肢が表示されれば正常動作：

How would you like to run the Gemini review?

> 1. Run in background (Recommended)
  2. Wait for results
  3. Type something.
  4. Chat about this

バックグラウンド実行の結果例：

Gemini Review
Target: branch diff against master
Verdict: approve
No material findings.

使用プラグイン：gemini-plugin/1.1.0（rsecss版）

5. 使用コマンド一覧

コマンド用途
/gemini:review現在の変更をレビュー（インタラクティブに実行方法を選択）
/gemini:review --base main指定ブランチとの差分をレビュー
/gemini:adversarial-review設計・実装方針への敵対的レビュー
/gemini:rescue タスク内容タスクを Gemini に委譲
/gemini:statusバックグラウンドジョブの確認
/gemini:result完了ジョブの結果取得
/gemini:cancel実行中ジョブのキャンセル

6. 注意事項

  • Review Gate は原則オフ（Claude・Gemini 両方の消費が増大するため）
  • /gemini:rescue はコードを変更できる。指示は明確に
  • Gemini の使用量は Google AI Studio の API キー側に課金される
  • 単純な編集は Claude Code に直接依頼する方が速く効率的
  • バックグラウンド実行後は /gemini:status → /gemini:result で結果確認

7. 設定ファイルまとめ

ファイル内容
C:\Users\{username}\.claude\settings.jsonGEMINI_API_KEY の環境変数設定、プラグイン有効化設定
{プロジェクトルート}\CLAUDE.mdGemini プラグイン使用方針の記載

8. トラブルシューティング早見表

症状原因対処
ACP process is not readyUnix socket 非対応（Windows）rsecss/gemini-plugin-cc に切り替える
認証エラーsettings.json の場所が違うC:\Users\{username}\.claude\settings.json に GEMINI_API_KEY を追記
古いプラグインが呼ばれる複数プラグインが競合/plugin uninstall で古いプラグインを削除してから再インストール
main...HEAD エラープロジェクトに main ブランチがない--base master を指定するか、差分なしとして正常扱い

AI,プログラム開発

Posted by iwadjp