マルチエージェントプログラミング完全ガイド
1 つの AI エージェントで足りないときは複数のエージェントを連携させ、アーキテクチャ設計から実装、テストまでを並行で進めるマルチエージェントアプローチを使います。並行開発、コードレビュー、大規模リファクタリングの実践シナリオと、Claude Code、Codex、OpenCode の公式ドキュメントに示された有効化、設定、コストの注意点を解説します。
マルチエージェントプログラミングとは？
マルチエージェントプログラミングとは、複数の AI エージェントが協調して開発タスクを遂行する進め方です。単一のエージェントがすべてを抱えるのではなく、各エージェントが専門的な役割（アーキテクチャ設計、フロントエンドとバックエンドの実装、単体テストやコードレビュー）を担い、それぞれ独立したコンテキストで作業します。分割と集約はメインのエージェントまたはスクリプトが行います。2026 年 10 月時点で、Claude Code、Codex、OpenCode はいずれも独自の方法を公式ドキュメントに掲載しており、形態は異なります。
並行開発
複数のエージェントが同時にコードを書くため、フロントエンドとバックエンドを待たずに並行で進められます。
専門性の分離
各エージェントが一つの分野（アーキテクチャ、実装、テスト、セキュリティ）に集中し、それぞれの強みを活かせます。
品質向上
エージェント同士がコードをレビューし合い、さまざまな角度から問題に気づけます。
Claude Code・OpenCode・Codex のマルチエージェント方式
Claude Code Agent Teams
Claude Code の公式ドキュメントにあるマルチエージェント機能です。リードが複数のチームメイトを率い、タスクリストを共有して直接メッセージを送り合えます。
構成：リード → チームメイト（それぞれ独立インスタンス）→ 共有 Task List
OpenCode マルチエージェント
OpenCode はオープンソースのマルチエージェントアーキテクチャで、Build/Plan/Custom Agent の組み合わせにより多様な開発ワークフローに対応します。公式ドキュメントではエージェントをプライマリエージェントとサブエージェントに分けています。前者と直接やり取りし、後者はプライマリエージェントが呼び出すか、@ で手動で呼び出せます。どちらもカスタムできます。oh-my-opencode のリポジトリは oh-my-openagent に改名され、QCode ドキュメントでは旧型の組み込みエージェントの役割一覧は現在掲載されていません。
構成：プライマリエージェント + サブエージェント。組み込みは Build/Plan と General/Explore/Scout、カスタム可能
Codex サブエージェント
OpenAI の Codex 公式ドキュメントでは、現在のリリースはサブエージェントワークフローが既定で有効です。依頼に応じて複数のエージェントを並列に起動し、結果を 1 つの回答にまとめます。カスタムエージェントは TOML ファイルで定義します。
構成：メインセッション + 並列の agent スレッド（/subagents で確認・切替）
| 機能 | Claude Code | OpenCode | Codex |
|---|---|---|---|
| 通信方式 | 共有 Task List ＋ 直接のメッセージ送受信 | プライマリエージェントが呼ぶか、@ で手動で呼ぶ | 独立実行（非同期） |
| エージェント数 | タスク次第（公式：厳密な上限なし） | 組み込みはプライマリエージェント 2 とサブエージェント 3、カスタムも可 | タスクに応じて起動 |
| タスク管理 | 共有 Task List をチームメイトが受け取り完了 | プライマリがタスクごとに専門サブを割り当てる | スレッド数上限は config.toml で設定 |
| コスト | plan mode では通常セッションの約 7 倍（公式） | エージェントごとに選ぶモデルしだい | 単独実行よりトークンを消費（公式の注意） |
サンプルシナリオ
並行開発
フロントエンド担当のエージェントが UI 部品を作り、バックエンド担当が API を書き、テスト担当が同時にテストケースも書きます――作業を並列で進められます。
コードレビュー
セキュリティ担当が脆弱性を、パフォーマンス担当がボトルネックを、カバレッジ担当がテストの行き届き具合を確認し、問題を多角的に拾い出します。
大規模マイグレーション・リファクタリング
ディレクトリやモジュール単位でエージェントに分担させ、それぞれに移行作業の一部を任せ、マージ後にまとめて検証します。リファクタリングを並行で進められます。
QCode.ccで統一管理
QCode.cc の API キー 1 本で Claude Code、Codex、OpenCode などのツールをまたいで使えます。課金はトークン単位で、各モデルの単価は /models に掲載しています。
キー 1 本で共通 — Claude Code、OpenCode、Codex とも同じキーを使います
コスト管理 — コンソールの使用統計ページで呼び出しごとのモデル、トークン数、費用が確認できます
柔軟な切替 — タスクに応じてツールとモデルを選べます
2026 年 10 月の実践：Claude Code・Codex・OpenCode でマルチエージェントを始める
Claude Code：並列実行の 5 つの方法
2026-10-20 時点の Claude Code 公式ドキュメントは、複数のタスクを同時に進める方法として、サブエージェント、agent view、agent teams、動的ワークフロー、projects の 5 つを挙げています。違いは、誰が作業を調整するか、ワーカー同士がやり取りするか、同じファイルを編集するかです。
- サブエージェント：1 つのセッション内で動くワーカーで、自分のコンテキストで脇のタスクをこなし、要約を返します。Markdown ファイルで定義し、.claude/agents/（プロジェクト）か ~/.claude/agents/（個人）に置きます。必須は name と description だけで、model には sonnet や opus などのエイリアスか、完全なモデル ID を書けます。
- Agent teams：リードと複数のチームメイトがタスクリストを共有し、直接メッセージをやり取りします。実験的な機能で既定ではオフです。有効にするには CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 を設定します。チームメイトが起動されるのは対話型セッションだけです。
- 動的ワークフロー：Claude がスクリプトを書いて多数のサブエージェントを動かします。コードベース全体の監査や 500 ファイルの移行などに向き、プロンプトに ultracode と書くか、ワークフローを使うよう頼めば始まります。
- Agent view：claude agents で開き、1 つの画面からバックグラウンドのセッションを割り当て・監視します（リサーチプレビュー）。
- 同じファイルを触る？agent teams はチームメイトを worktree に分離しないため、ファイル単位で作業を分けてください。サブエージェントは isolation: worktree でそれぞれ独立したコピーを使えます。
Codex：サブエージェントとカスタムエージェント
OpenAI の Codex ドキュメントによると、現在の Codex はサブエージェントのワークフローが既定で有効です。spawn two agents（エージェントを 2 つ起動して）や「論点ごとに 1 エージェント」のように直接頼むと、Codex は複数のエージェントを並列で起動し、結果を 1 つの回答にまとめます。CLI では /subagents でエージェントのスレッドを切り替えます。組み込みのエージェントは default、worker、explorer の 3 つです。
カスタムエージェントは ~/.codex/agents/（個人）または .codex/agents/（プロジェクト）に置く TOML ファイルです。name、description、developer_instructions は必須で、model と model_reasoning_effort も指定できます。カスタムエージェントは親セッションの権限、プロバイダー、MCP サーバーを引き継ぐため、メインのセッションを設定すればサブエージェントも同じ設定で動きます。
全体の設定は config.toml の [agents] に書きます。たとえば agents.max_concurrent_threads_per_session で同時スレッド数を制限し、agents.default_subagent_model でサブエージェントの既定モデルを決めます。公式は、サブエージェントのワークフローは同等のシングルエージェント実行よりトークンを多く使うと注意し、まずは探索、テスト、トリアージ、要約のような読み取り中心の作業から並列化し、書き込みの多い並列作業は慎重に進めるよう勧めています。
OpenCode：プライマリエージェントとサブエージェント
OpenCode のドキュメントはエージェントを 2 種類に分けています。プライマリエージェントは直接対話する相手で、組み込みの Build と Plan を Tab キーで切り替えます。サブエージェントはプライマリエージェントが呼び出す専門アシスタントで、@general のように @ メンションで手動でも呼べます。組み込みのサブエージェントは General、Explore、Scout です。
独自のエージェントは opencode.json の agent セクションに書くか、Markdown ファイルとして ~/.config/opencode/agents/（グローバル）または .opencode/agents/（プロジェクト）に置きます。
1 つの QCode キーで 3 つのツールにモデルを供給する
2026-10-20 時点：Claude Code は ANTHROPIC_BASE_URL=https://api.qcode.cc/api と ANTHROPIC_AUTH_TOKEN（cr_ で始まる QCode のキー）を設定します。Codex は ~/.codex/config.toml にカスタムプロバイダーを追加し、base_url = https://api.qcode.cc/openai と wire_api = responses を指定します（プロバイダー名は任意）。OpenCode は QCode ドキュメントの OpenCode 接続ページどおりに設定します。同ページには、OpenCode の利用には API 直接リクエストの権限が必要で、この権限は既定ではオフで、オンラインサポートに連絡すると有効になると書かれています。
役割分担の例：リードやオーケストレーションには claude-opus-5-5、ワーカーには claude-sonnet-5-5 か claude-haiku-5-5、Codex 側では gpt-6.1-sol、gpt-6-sol、gpt-5.6-terra。OpenAI のドキュメントは軽いサブエージェントに gpt-6-luna を勧めていますが、QCode では現在 gpt-6-luna を提供していないため、別の GPT モデルをお使いください。課金はトークン単位で、各モデルの単価は /models に掲載しています。
コストの目安：Claude Code のドキュメントによると、チームメイトが plan mode で動く場合、agent teams のトークン使用量は通常のセッションの約 7 倍です。マルチエージェントの作業はまず小さな範囲で試し、QCode のダッシュボードでモデルごとの使用量を確認してください。
マルチエージェント開発のよくある質問
マルチエージェントプログラミングとは？
複数の AI エージェントがそれぞれ独立したコンテキストでタスクの一部を受け持ち、リードのエージェントやスクリプトが作業を分割して結果をまとめるやり方です。Claude Code のサブエージェント、agent teams、動的ワークフロー、Codex のサブエージェント、OpenCode のサブエージェントはいずれもこの形です。
Claude Code のサブエージェントと agent teams の違いは？
Claude Code のドキュメントによると、サブエージェントは結果を呼び出し元に返し、結果が要約されてメインのコンテキストに戻るのでトークンコストは低めです。agent teams は完全に独立したセッションで、チームメイト同士が直接メッセージを送り合いタスクリストを共有します。チームメイトはそれぞれ別の Claude インスタンスなので、トークンコストは高くなります。
Codex で複数のエージェントを動かすには？
現在の Codex はサブエージェントのワークフローが既定で有効です。spawn two agents や delegate this work in parallel のように Codex に直接頼み、CLI では /subagents でスレッドを切り替えます。決まった役割を使い回すなら、.codex/agents/ に name、description、developer_instructions を書いた TOML ファイルを追加します。
マルチエージェントにするとコストはどのくらい増える？
増えます。動かすエージェントの数と時間に比例します。Claude Code のドキュメントは、チームメイトが plan mode で動く agent teams のトークン使用量を通常のセッションの約 7 倍としており、ワークフローと Codex のドキュメントも、並列エージェントは単独実行よりトークンを多く使うと注意しています。まず小さく試し、単純なサブタスクには軽いモデルを割り当ててください。個人プランは日ごとの枠で 30 日間有効、当日分が足りないときはブースターパックを使えます。個人プランがなく月額プランも望まない場合、クォータパックは $4 から、7 日以内に使い切るまとめての枠を購入できます（チャージは $5 から）。
並列のエージェントがお互いのコードを上書きしない？
上書きの可能性はあります。ワーカーごとに担当ファイルか専用の worktree を割り当ててください。Claude Code のサブエージェントは isolation: worktree に対応し、agent teams ではファイル単位で作業を分ける必要があります。OpenAI のドキュメントも、Codex で書き込みの多い作業を並列にする際は慎重にと勧めています。
これらのツールで使う QCode の支払い方法は？
クレジットカード（Visa / Mastercard / AMEX）、Apple Pay、Google Pay、Alipay、WeChat Pay、暗号資産（複数の通貨とネットワーク）で支払えます。1 つのキーで Claude、GPT、主要な中国系モデルを呼び出せるので、Claude Code、Codex、OpenCode で共有できます。手続きはすべてセルフサービスで、数分で始められます。
マルチエージェントプログラミングを始めよう
常駐や並列の Agent では QCode のクラウドサーバーを使えます。サーバーは海外に置き、Claude Code や Codex をインストールして、QCode のキーで QCode のエンドポイント経由でモデルを呼び出します。AI サービスとクラウドサーバーは一つの残高を共有し、価格は qcode.cc/en/cloud の回線比較表を見てください。クラウドサーバーの画面表示は現在、中国語と英語のみです。