Claude Codeのサブエージェント、なんとなく使っていませんか？

subagent_type: "Explore" と書けば、なんか動く。でも「いつ使うべきか」「そもそもどういう仕組みなのか」は、正直あまり調べていなかった。そういう使い方をしている人、意外と多いんじゃないかと思う。

2026年4月にAnthropicが「How and when to use subagents in Claude Code」という公式ブログ記事を公開した。サブエージェントを使うべき5つの場面が整理されていたので、自分が実際に判断している基準と照らし合わせながらまとめた。

サブエージェントとは何か

一言で言うと、メインのClaude Codeセッションとは独立した別のClaudeインスタンスだ。

Claude Codeを使っていると、会話が長くなるほど「コンテキストウィンドウ」が膨らんでいく。コンテキストが大きくなると応答が遅くなるし、トークンコストも増える。サブエージェントはこの問題を解決するために登場した仕組みだ。

メインセッションからサブエージェントを呼び出すと、そのエージェントは独自のコンテキストウィンドウでタスクを処理して結果だけを返す。メインセッションは「この作業をしてきて」と委ねるだけで、詳細な中間経過を抱え込まずに済む。

Claude Codeでは現在、3つのタイプのサブエージェントが使える。

• 「汎用エージェント」: コード調査から実装まで幅広いタスクに対応

• 「計画エージェント」: 実装前の設計・アーキテクチャ検討に特化

• 「探索エージェント」: コードベースの調査・検索に特化（読み取り専用で安全）

使うべき5つの場面

Anthropicのブログでは、サブエージェントが有効な5つのシナリオが整理されている。

1. リサーチ集約的なタスク

ファイルを数十個読み込んで要約する、設定ファイルを横断的に調査するといった「読んで理解する」作業が典型的な場面だ。

メインセッションで同じことをやると、読んだファイルの内容が全部コンテキストに積み上がっていく。サブエージェントに任せれば、必要な情報だけが戻ってくる。

自分はコードの現状調査をするとき、まず探索エージェントに「このディレクトリ構成を把握して、主要なファイルを教えて」と頼む使い方をよくしている。メインセッションが生データを抱え込まないので、そのあとの実装がスムーズになる。

2. 独立した並列タスク

相互依存がないサブタスクを同時に走らせる場面だ。3つの独立したモジュールのコードレビューを並行して依頼する、といったケースに向いている。

ただし「並列なら速い」とは限らない。後述するが、使い方を誤ると逆効果になることもある。

3. 客観的な検証

自分（メインセッション）が実装したコードを、別の視点でレビューしてもらう場面だ。

同じセッションで「作る」と「確認する」を両方やると、どうしても実装者バイアスが入る。サブエージェントは別のコンテキストから見るので、見落としを拾ってくれることがある。コードレビューをサブエージェントに任せるのはかなり有効だと感じている。

4. コミット前の確認

実装が完了したタイミングで、品質チェックをサブエージェントに依頼する場面だ。

「このPRにlintエラーや明らかなバグがないか確認して」という用途は、メインセッションのコンテキストを汚さずに済む。実装フェーズと確認フェーズを分離できる点が良い。

5. パイプラインワークフロー

設計→実装→テスト→レビューという流れを、ステージごとにサブエージェントを使って分離する場面だ。

前のステージの成果物だけを次のエージェントに渡すことで、各エージェントのコンテキストをクリーンに保てる。複数人でのチーム開発に近いワークフローを1人でも実現できる。

使わないほうがいいとき

サブエージェントが有効な場面がある一方、使わないほうが良いシナリオもある。Anthropicはこれも明示している。

• 順序依存が厳密なタスク: 前の工程の出力が次の工程の入力になる場合。A→B→Cの順番で処理しないといけないものは、並列化できない。

• 同一ファイルへの並列編集: 複数のエージェントが同じファイルを同時に書き換えようとするとコンフリクトが起きる。

• 小規模なタスク: 1行の変更、単純な質問への回答。サブエージェントを立ち上げるオーバーヘッドのほうが大きい。

• エージェント間の密な調整が必要な場合: リアルタイムで情報を共有しながら進める必要があるタスクは、1つのセッションでやったほうが速い。

• エージェントを増やしすぎる場合: 専門エージェントが多くなりすぎると、どのエージェントに何を任せるかが曖昧になり、委譲の信頼性が下がる。

「とりあえずサブエージェントを使えば速くなる」という思い込みが一番危ない。小さいタスクに多用すると、むしろコストと時間が増える。

呼び出し方と設定方法

有料部分では以下を公開しています。

• サブエージェントを呼び出す4つの方法（会話的・Markdownファイル定義・CLAUDE.md・スキル/フック）

• カスタムエージェント定義ファイルの構造とフィールド解説

• 目的別のエージェント定義テンプレート3種（調査専用・実装・セキュリティレビュー）

• CLAUDE.mdへの組み込みパターン3選

ここから先は有料です。