Claude Code マルチエージェント構成セットアップガイド

5月 6, 2026

概要

Claude Code を中心に、Codex・Gemini CLI を補助エージェントとして組み合わせるマルチエージェント構成のセットアップ手順と運用方針をまとめる。

---

1. ツール全体像

役割分担

ツール	位置づけ	得意なこと
Claude Code	オーケストレーター（主役）	深い推論・複数ファイル編集・アーキテクチャ判断
Codex（OpenAI）	サブエージェント	軽量タスク・高速な反復・Claude消費量の節約
Gemini CLI	サブエージェント	100万トークンのコンテキスト横断分析
GitHub Copilot	別レイヤー（逆方向）	インライン補完・GitHub統合（CopilotがClaudeを呼ぶ側）

注意： GitHub Copilot は Claude Code の補助ツールではなく、Copilot のパートナーエージェントとして Claude を呼び出す関係（方向が逆）。

---

2. Codex プラグイン

2-1. 前提条件

• ChatGPT サブスクリプション（無料プランを含む）または OpenAI API キー
• Node.js 18.18 以降

2-2. インストール手順

Claude Code のプロンプトで 1コマンドずつ 実行する。

/plugin marketplace add openai/codex-plugin-cc

↓ 完了を確認してから

/plugin install codex@openai-codex

↓ 完了を確認してから

/reload-plugins

↓ 完了を確認してから

/codex:setup

ポイント： 4コマンドを一度に貼り付けると「Invalid marketplace source format」エラーになる。必ず1コマンドずつ実行すること。

2-3. 認証

すでに Codex にサインイン済みであればそのまま使える。未認証の場合：

!codex login

2-4. セットアップ確認

- Codex CLI: v0.128.0（利用可能）
- 認証: ChatGPT ログイン済み
- ステータス: ready ✓

2-5. 主要コマンド

コマンド	用途
/codex:review	現在の変更を Codex がレビュー
/codex:review --base main	main ブランチとの差分をレビュー
/codex:review --background	バックグラウンドで実行
/codex:adversarial-review	懐疑的な敵対的レビュー
/codex:rescue タスク内容	タスクを Codex に委譲（コード変更可能）
/codex:status	実行中ジョブの確認
/codex:result	完了ジョブの結果取得

2-6. モデル設定（オプション）

プロジェクトルートに .codex/config.toml を作成：

model = "gpt-5.4-mini"
model_reasoning_effort = "high"

2-7. Review Gate（注意が必要）

/codex:setup --enable-review-gate   # 有効化
/codex:setup --disable-review-gate  # 無効化

Claude の応答ごとに Codex がレビューを実行する機能。長時間ループが発生し使用量を急速に消費するため、原則オフで運用する。

---

3. Gemini プラグイン

3-1. 前提条件

• Gemini CLI がインストール済み
• Google AI Studio の API キー、または Google アカウント（無料枠：60 req/分、1,000 req/日）

3-2. インストール手順

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

3-3. 認証（API キー方式）

C:\Users\{username}\.claude\settings.json に追記する：

{
    "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 はこちらを優先的に読み込む。

追記後、Claude Code を完全に再起動してから /gemini:setup で確認する。

Google アカウントでサインインする場合（代替手段）

!gemini

3-4. セットアップ確認

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

3-5. 主要コマンド

コマンド	用途
/gemini:review --base main	複数ファイルにまたがる変更のレビュー
/gemini:adversarial-review 観点	設計・実装方針の敵対的レビュー
/gemini:rescue タスク内容	大規模な調査・分析タスクの委譲
/gemini:status	実行中ジョブの確認
/gemini:cancel	実行中ジョブのキャンセル

---

4. 運用方針

4-1. ツール使い分けの基本方針

場面	使うツール
通常のコーディング・ファイル編集	Claude Code に直接依頼（最速）
Claude の週間消費を抑えたい重めのタスク	/codex:rescue または /gemini:rescue
重要な変更前のダブルチェック	/codex:review または /gemini:review
コードベース横断の大規模分析	/gemini:rescue（100万トークンの強みを活かす）
リスクの高い変更の圧力テスト	/codex:adversarial-review または /gemini:adversarial-review

4-2. トークン消費に関する注意

• /codex:rescue・/gemini:rescue は Claude 側と各ツール側の両方のトークンを同時消費する
• 単純なファイル編集・追記は Claude Code に直接依頼する方が速く効率的
• rescue 系コマンドの節約効果が出るのは、長時間・大量コード生成が必要なタスクのみ
• Review Gate は原則オフ（両方の消費量が増大するため）

4-3. 課金先

ツール	課金先
Claude Code	Anthropic（Claude Pro/Max）
Codex	OpenAI（ChatGPT アカウント）
Gemini	Google（AI Studio API キー）

---

5. 設定ファイルの場所

ファイル	用途
C:\Users\{username}\.claude\settings.json	Claude Code グローバル設定（プラグイン・環境変数）
{プロジェクトルート}\.claude\settings.local.json	プロジェクト固有設定
{プロジェクトルート}\CLAUDE.md	Claude Code へのプロジェクト共通指示
{プロジェクトルート}\.codex\config.toml	Codex モデル設定

---

6. CLAUDE.md への記載内容

プロジェクト共通の CLAUDE.md に以下のセクションを追記する（Claude Code に直接依頼して追記）。

## Codex プラグインの使用方針

### 目的
- Claude Code の週間消費量を抑える
- 重要な変更前のダブルチェック

### 使い分け

| 場面 | コマンド |
|---|---|
| 軽めのタスク・定型作業を Codex に任せる | `/codex:rescue タスク内容` |
| 重要な変更前のレビュー | `/codex:review --base main` |
| リスクが高い変更の敵対的レビュー | `/codex:adversarial-review 観点を記述` |

### 注意事項
- Review Gate は原則オフ（両方の消費量が増大するため）
- `/codex:rescue` はコードを変更できる唯一のコマンド。指示は明確に
- Codex の使用量は ChatGPT アカウント側に課金される
- `/codex:rescue` は Claude・Codex 両方のトークンを同時消費する
- 単純なファイル編集・追記は Claude Code に直接依頼する方が速く効率的
- `/codex:rescue` の節約効果が出るのは長時間・大量コード生成が必要なタスク
- `/codex:review` は読み取り専用のため比較的軽量でダブルチェックに適している

---

## Gemini プラグインの使用方針

### 目的
- 100万トークンのコンテキストウィンドウを活かしたコードベース横断分析
- Claude・Codex とは異なる視点でのダブルチェック

### 認証
- Auth method: API key
- APIキーは C:\Users\{username}\.claude\settings.json の "env" セクションに設定

### 使い分け

| 場面 | コマンド |
|---|---|
| 複数ファイルにまたがる変更のレビュー | `/gemini:review --base main` |
| 設計・実装方針の敵対的レビュー | `/gemini:adversarial-review 観点を記述` |
| 大規模な調査・分析タスクの委譲 | `/gemini:rescue タスク内容` |

### 注意事項
- Review Gate は原則オフ（Claude・Gemini 両方の消費が増大するため）
- `/gemini:rescue` はコードを変更できる。指示は明確に
- Gemini の使用量は Google AI Studio の API キー側に課金される
- `/gemini:rescue` は Claude・Gemini 両方のトークンを同時消費する
- 単純な編集は Claude Code に直接依頼する方が速く効率的