🎯

Claude Code で Grok・Gemini・Claude を使い分けるマルチ AI エージェント設計

に公開

Claude Code で Grok・Gemini・Claude を連携させるマルチ AI エージェント設計の実装方法と、ツール不在時の Graceful Degradation パターンを解説します。マルチエージェントワークフローを組み始めると、「とりあえず全部 Claude に任せよう」という状態になりがちです。包丁一本で寿司も天ぷらもパスタも作る料理人のように、Claude という万能プレイヤーが全工程を担う設計です。専門家を適材適所に配置したチームと比べると、効率もアウトプットの質も大きく差がついてきます。

この記事では、実際のリポジトリ改善プロセスを追いながら、Claude・Gemini・Grok の 3 つの AI を役割ごとに使い分けるマルチ AI 設計術を解説します。Grok CLI はまだ試したことがないという方にも、実装の具体的なイメージが伝わるよう、コードを交えて説明します。

はじめに — Claude だけでいいと思っていた

https://zenn.dev/motowo/articles/claude-code-gemini-cli-orchestration-guide

Claude Code のマルチエージェント機能を使い始めた頃、筆者のすべてのエージェントは Claude 一択でした。しかしワークフローを運用していく中で、特定の場面でボトルネックが見えてきました。たとえば researcher エージェントがウェブ検索で取得できるのは「静的なドキュメント」のみで、昨日 X(旧 Twitter)で話題になった技術情報や、今週マージされたばかりのオープンソースの動向は拾いにくい。あるいは大量の GA(Google Analytics)データを Gemini に投げればもっと安く処理できるのに、Claude で無理に処理しているケースもありました。

問題は「Claude が苦手」なのではなく、「Claude に向いていないタスクを Claude にやらせていた」ことでした。包丁一本の料理人に問題があるのではなく、専門の道具を使えるのに使っていなかっただけです。

3 つの AI が持つ固有の強みを整理する

Claude・Gemini・Grok は、それぞれ異なる設計思想と強みを持っています。 まず特性を比較してから、どのタスクに向いているかを考えましょう。

特性 Claude Gemini Grok
推論の深さ ◎ 最高峰 ○ 優秀 ○ 優秀
コンテキストウィンドウ ○ 20 万トークン ◎ 100 万〜200 万トークン △ 131,072 トークン(約 131K)
リアルタイム検索 △ WebSearch(静的) △ WebSearch ◎ Live Search(X 含む)
画像生成 × ◎ nanobanana 連携 ○ 画像生成 CLI 対応
日本語品質
コスト効率 △ Pro/Max 課金制 ◎ 1,000 リクエスト/日 無料枠 △ API 従量課金
ファイル操作 ◎ Claude Code 統合
指示遵守

※ 筆者の実使用経験ベース。環境・用途によって異なります。

この表から各 AI の「最もコスパよく使えるタスク」が見えてきます。

Claude は推論の深さ・日本語品質・ファイル操作・指示遵守の点で突出しています。記事執筆・複雑なレビュー・ワークフロー全体のオーケストレーションが最も向いています。

Gemini は巨大なコンテキストウィンドウと無料枠が強みです。大量の GA データ分析や長大なログの解析、Gemini CLI に同梱された画像生成拡張子ツール「nanobanana」を使った画像生成が得意です。しかもコストが低い。

Grok は Elon Musk が設立した AI 企業 xAI が開発した AI で、X(旧 Twitter)のエコシステムとリアルタイム検索に特化しています。「今現在コミュニティで何が話されているか」を調べるタスクではほかの 2 者を凌駕します。

まとめると:

AI 向いているタスク
Claude 記事執筆・レビュー・オーケストレーション全般
Gemini GA データ分析・長大コンテキスト処理・画像生成
Grok リアルタイム ウェブ 検索・X コミュニティトレンド収集

実際のエージェント分析:Skills / Agents マトリックス

既存のワークフローを「現在の AI」と「最適な AI」で整理すると、改善ポイントが一目で把握できます。

スキル(コマンド)の担当 AI 分析

スキル 概要 現在の AI 最適 AI(提案)
/editorial スクラップから編集会議・企画 Claude(+ Gemini CLI オプション) Claude 主軸 + Gemini(GA データ)
/draft 記事執筆(チーム協調) Claude(+ Gemini CLI オプション) Claude 主軸 + Gemini(画像生成)
/review 5 ステージパイプラインレビュー Claude Claude(変更なし)
/publish 公開前チェック・スケジュール Claude Claude(変更なし)
/revise 公開済み記事の修正 Claude Claude(変更なし)
/image 画像・図表生成 Gemini CLI(nanobanana) + Claude Gemini(画像生成)+ Claude(Mermaid)
/analytics GA アクセス解析 Gemini CLI(GA MCP) Gemini(変更なし)
/audit-seo サイト全体 SEO 健康診断 Claude + Gemini CLI Claude 統括 + Gemini(GA データ)

各スキルを担う編集チームの構築過程は以下で解説しています:

https://zenn.dev/motowo/articles/claude-code-editorial-team-1week

エージェントの担当 AI 分析

エージェント 役割 現在の AI 最適 AI(提案) 理由
official-researcher 公式ドキュメント・GitHub 調査 Claude Grok 推奨 リアルタイム ウェブ 検索が強み
community-researcher コミュニティ・SEO キーワード調査 Claude Grok 推奨 X エコシステムに特化
writer 記事執筆 Claude Claude(変更なし) 長文の論理構成・日本語品質
image-creator 図表・画像生成 Gemini CLI Gemini(変更なし) nanobanana 連携が前提
reviewer レビュー全般(5 エージェント) Claude Claude(変更なし) 複雑なルール遵守・深い推論
data-analyst GA4 データ分析 Gemini CLI Gemini(変更なし) 長大コンテキスト + 無料枠

このマトリックスを見ると、official-researchercommunity-researcher の 2 エージェントが明確な改善ポイントになっています。現状は Claude の静的 WebSearch に依存していますが、Grok のリアルタイム検索を活用することで、最新の技術情報やコミュニティの声を収集できるようになります。

以下のアーキテクチャ図は、全エージェントの接続関係と担当 AI を整理したものです:

オレンジが「Grok 推奨」のエージェント、青が「Gemini 担当」のエージェントです。大多数のエージェントは依然として Claude が適任ですが、情報収集とデータ分析の領域で明確な分業が生まれます。

このようなマルチエージェント構成の設計戦略(SubAgent・Teams・Hybrid の比較)については以下で詳しく解説しています:

https://zenn.dev/motowo/articles/claude-code-dev-flow-multi-agent-1

設計バグの発見:/analytics のハードストップ問題

既存の /analytics コマンドには、Gemini CLI が未設定の環境で処理を完全停止させる設計上の問題がありました。

問題のコードは AGENTS.md 内の /analytics 定義にありました。Gemini CLI が見つからない場合の処理が以下のようになっていました:

- 利用不可の場合は以下を表示して終了する:
- > ⚠️ Gemini CLI が見つかりません。...

「終了する」という設計は、一見シンプルで明快に見えます。しかし /analytics コマンドには seo-check(SEO 分析)・trend(トレンド分析)・compare(比較分析)という 3 つのサブコマンドがあり、このうち GA データを必要としない静的分析は Gemini CLI なしでも実行できるはずです。

「GA データが取れないなら全部止める」という設計は、利便性より依存関係を優先した硬直した設計でした。これが「ハードストップ問題」です。

Graceful Degradation への修正

今回適用した修正は、「ツールが使えなくても、使える範囲でできることをやる」という方針への転換です:

+ 利用不可の場合は以下を表示し、静的分析モードで続行する:
+ | サブコマンド | 静的分析モードの動作 |
+ | seo-check   | フロントマター・見出し構造の静的分析(GA データなし) |
+ | trend       | analytics/ キャッシュから過去データを参照 |
+ | compare     | 両記事の静的 SEO 構造比較のみ |

Gemini CLI が使える場合は従来通り GA データと組み合わせた高精度な分析ができ、使えない場合は静的分析にフォールバックする。ユーザーはツールの有無を意識せず /analytics を呼び出せるようになりました。

Grok CLI 統合 — リアルタイム情報補強の実装

Grok CLI を researcher エージェントに組み込むことで、コミュニティの最新動向をリアルタイムで取得できるようになります。 ただし Grok CLI の現状には注意が必要です。

Grok CLI の現状(2026-03-08 時点)

まず、Grok CLI を巡る状況を整理します:

コミュニティ製 Grok CLI の概要は以下の通りです:

項目 内容
公式実装 なし(xAI は CLI を提供していない)
最初に普及したコミュニティ実装(非推奨) @vibe-kit/grok-cli — 2026-01-12 以降 410 エラーで機能停止
動作確認済みの代替実装 @kazuki-ookura/grok-cli(Responses API 対応フォーク)
対応 API xAI Responses API(https://api.x.ai/v1/responses
利用可能なツール web_search / x_search
# 動作確認済みの代替実装をインストール(GitHub でソースコードを確認の上)
npm install -g @kazuki-ookura/grok-cli

# API キーの設定
export XAI_API_KEY="your-api-key-here"

# 動作確認
grok "Claude Code の最新トレンドを教えてください"

エージェントへの組み込み方:手順 3.5 パターン

今回の改善では official-researchercommunity-researcher の両エージェント定義に「手順 3.5」として Grok CLI による情報補強ステップを追加しました。既存の手順に割り込む形で、既存ワークフローへの影響を最小化しています:

### 3.5. Grok CLI による最新情報補強(オプション)

#### 3.5.1 利用可否の確認

if command -v grok > /dev/null 2>&1; then
  echo "Grok CLI が利用可能です"
else
  echo "Grok CLI が見つかりません。手順 4 にスキップします"
fi

見つからない場合はこのステップをスキップして手順 4 へ進む。

#### 3.5.2 最新情報の取得

grok "以下の技術に関する最新情報を教えてください: [調査対象]"

実際のシェルスクリプトとして書くと:

# Graceful Degradation を組み込んだ Grok CLI 呼び出しパターン
# $QUERY: 調査対象の技術名(例: "Claude Code 最新アップデート")
QUERY="Claude Code 最新アップデート"
if command -v grok > /dev/null 2>&1; then
  echo "=== Grok CLI による最新情報補強 ==="
  grok "以下の技術に関する最新情報・コミュニティ動向を教えてください: $QUERY"
else
  echo "ℹ️  Grok CLI が見つかりません。この手順をスキップします。"
  echo "   インストール: GitHub でコミュニティ製 Grok CLI を検索してください"
fi

command -v が失敗した場合はスキップするだけで、処理全体を止めない点がポイントです。

GROK.md — AI 専用プロジェクト設定ファイルの定義

今回の改善では CLAUDE.md・GEMINI.md と同等の位置づけで、Grok 専用のプロジェクト設定ファイル GROK.md を新規作成しました。

# Grok プロジェクト設定

## 役割
リアルタイム情報リサーチャー。X(旧 Twitter)エコシステムと
web_search ツールを使い、最新情報を構造化データとして返す。

## 出力フォーマット

### パターン A: 公式情報補強
- 最新バージョン: X.X.X
- 主要な変更点: (箇条書き 3 点まで)
- 公式発表 URL: https://...

### パターン B: X コミュニティ動向
- トレンドキーワード: (3 語まで)
- 主な議論トピック: (箇条書き 3 点まで)
- センチメント: positive / neutral / negative

Grok が返すデータが簡潔な構造化フォーマットに限定されるよう設計しています。これは Claude Code 側のコンテキストウィンドウを圧迫しないための配慮です。Grok のコンテキストウィンドウは 131,072 トークン(約 131K)と 3 者の中で最も小さいため、Grok に渡すプロンプトも簡潔に保つ必要があります。

Graceful Degradation の設計原則

マルチ AI ワークフローの堅牢性を高めるには「ツールが使えない状態を正常系として設計する」ことが重要です。

以下のフローチャートは、今回のワークフローにおける Graceful Degradation の全体像を整理したものです。Grok CLI・Gemini CLI それぞれの有無に応じて、どのように縮退運転へ切り替わるかを示しています:

オレンジが「Grok による強化」、青が「Gemini による強化」、グレーが「フォールバック(縮退運転)」のステップです。どのパスをたどっても処理が完走する構造になっています。

今回の実装から抽出した Graceful Degradation の 4 原則を整理します。

原則 1: 存在チェックを必ず行う

# 悪い例: ツールが存在しなければ実行時エラーで止まる
grok "クエリ"

# 良い例: 存在チェック後にフォールバック
if command -v grok > /dev/null 2>&1; then
  grok "クエリ"
else
  echo "スキップ: 手順 4 に進みます"
fi

原則 2: 「停止」ではなく「縮退運転」を選ぶ

ツールが使えない場合でも、できる範囲の処理を継続します。/analytics の修正はその典型例です。GA データが取れなくてもフロントマター解析は実行できます。

原則 3: フォールバック内容をユーザーに明示する

何がスキップされ、何は実行されているかを明確にユーザーへ伝えます。ユーザーが「なぜ結果が違うのか」を理解できるようにします。

原則 4: オプション依存は「手順 X.5」として設計する

既存の必須ステップに影響を与えないよう、オプション処理は「3.5」「4.5」のように中間番号の手順として挿入します。既存ワークフローのテストを壊さずに機能追加できます。

適材適所の割り当てで何が変わったか

3 者分担の設計により、アウトプットの質とコスト効率の両方が改善します。

リサーチ品質の向上

researcher エージェントが Grok のリアルタイム検索を使えるようになると、次のような情報が取得できます:

  • 昨日マージされたオープンソースのリリースノート
  • 今週の X で話題の技術トレンド
  • 公式ドキュメントにまだ反映されていないベストプラクティス

「公式ドキュメントには書いていないが、コミュニティで広く使われているパターン」を拾う能力が特に向上します。

コスト最適化

タスク 変更前 変更後 効果
GA データ分析 Claude(課金) Gemini(無料枠) コスト削減
リアルタイム検索 Claude WebSearch Grok(API 従量) 品質向上
画像生成 対応不可 Gemini nanobanana 新機能追加
記事執筆・レビュー Claude Claude(変更なし) 変更なし

※ Grok API の料金はモデル・利用量により異なります。最新の料金は xAI 公式サイト でご確認ください。この比較は 2026-03 時点の定性的な傾向を示すものです。

「マルチ AI = コスト増」というのはよくある誤解です。適材適所で使えば、Gemini の無料枠を活用することで全体のコストを抑えつつ、品質を向上させることができます。ただし Grok API を本格的に利用する場合はコストが発生するため、実際の費用対効果は利用頻度・クエリ量を踏まえて判断してください。

ワークフローの継続性

Graceful Degradation の設計により、Grok CLI が未設定の環境でもワークフロー全体が止まらなくなりました。チームメンバーが各自の環境で必要なツールのみをセットアップし、残りはフォールバックで動かす、という段階的な導入が可能です。

まとめ:マルチ AI 設計のチェックリスト

冒頭で「包丁一本で全部やる料理人」の例え話をしました。レストランが成長して注文が多様になったとき、包丁一本の料理人でも回せますが、専門家を配置したキッチンにはおよびません。ソムリエがいればワインの提案が、パティシエがいればデザートの質が格段に上がります。

マルチ AI 設計も同じです。Claude という万能プレイヤーに全部任せることはできますが、Gemini や Grok という「専門家」を適材適所に加えることで、同じコストで質の高いアウトプットが出るようになります。

今回の実装を通じて整理したチェックリストを共有します:

AI 選定のチェックリスト

  • タスクに「リアルタイム情報収集」が含まれるか → Grok を検討
  • 大量のデータ(ログ・GA など)を処理するか → Gemini を検討
  • 長文の論理的な文章生成が必要か → Claude を維持
  • 複雑なルールや指示への厳密な準拠が必要か → Claude を維持
  • 画像・図表の生成が必要か → Gemini(nanobanana)を検討

Graceful Degradation のチェックリスト

  • 外部ツールの存在チェックに command -v <tool> > /dev/null 2>&1 を使っているか
  • ツールが使えない場合の「縮退運転」モードが定義されているか
  • フォールバック時に何がスキップされているかをユーザーに伝えているか
  • オプション処理は既存の必須手順に影響しない形(手順 X.5)で挿入しているか

設計上の注意点チェックリスト

  • Grok CLI は公式ツールではなくコミュニティ製であることを認識しているか
  • 使用するパッケージの GitHub で最新の動作状況を確認したか
  • xAI API キー(XAI_API_KEY)が環境変数に設定されているか
  • Grok へのプロンプトは簡潔(コンテキスト節約)に設計されているか
  • 各 AI 専用の設定ファイル(CLAUDE.md / GEMINI.md / GROK.md)が揃っているか

包丁一本のキッチンから始まったこのリポジトリは、今回の改善を経て、Claude・Gemini・Grok の 3 者が役割分担するチームになりました。まだ Grok CLI は「オプション」扱いですが、フォールバック設計のおかげで、導入するかどうかをユーザーが選べる設計になっています。専門家を揃えるかどうかはキッチン次第、でも揃える準備はできています。

この設計をベースにしたエディトリアルチームのエコシステム全体像は、以下の連載記事で解説しています。

https://zenn.dev/motowo/articles/claude-code-editorial-team-ecosystem-1

https://zenn.dev/motowo/articles/claude-code-editorial-team-ecosystem-2


参考リンク

Discussion