Claude Codeのサブエージェント機能とは？特徴や使い方・おすすめ設定も紹介

Claude Codeを使い始め「サブエージェントが便利！」といった情報を耳にし、どんな機能か気になっている人は多いですよね。具体的にどのような場面で使うべきなのか、イメージが湧いていない人もいるはず。

サブエージェント機能は複数のAIに役割を持たせ、タスクを分担できる便利な仕組みです。活用すれば、作業を効率化できるだけでなく、任せていた出力の質も向上します。

本記事では活用シーンや使い方も交え、Claude Codeサブエージェント機能の特徴を解説します。サブエージェントのおすすめ設定も紹介するので、ぜひ参考にしてください。

Claude Codeの特徴をおさらいしておきたい人は、次の記事を参考にしてください。

Claude Codeのサブエージェント機能とは？

Claude Codeのサブエージェント機能とは、メインのAIエージェントが特定のタスクを別のAIエージェントに委任して実行させる仕組みです。

通常のClaudeとの会話では、すべての処理を1つのエージェントが担います。そのため、タスクが増えるほど文脈情報（コンテキスト）が蓄積し、精度の低下や処理の遅延を引き起こす原因になります。

一方、サブエージェント機能では、メインのエージェントを指揮官とし、個々の作業を専任のサブエージェントに割り振ることが可能です。

コードレビュー・デバッグ・テスト生成など、役割ごとに専用エージェントを用意できるため、メインのエージェントに対するコンテキストの蓄積を最小限に抑えられます。

つまり、サブエージェント機能を利用することで、メインのエージェントの精度低下や処理遅延を防ぎやすくなります。

Claude Codeサブエージェント機能の特徴

ここからはClaude Codeのサブエージェント機能の特徴を、6つのトピック別に解説します。

メインから分離してタスクを実行できる

サブエージェントはメインのエージェントとは独立したコンテキストでタスクを実行します。

メインのエージェントが抱える情報量とは切り離されているため、サブエージェントは蓄積されたコンテキストが少ない状態でタスクを開始できます。処理が完了したらメインのエージェントに結果だけを返す仕組みです。

たとえば大規模なリファクタリング作業では、ファイル読み取り担当のサブエージェントと修正担当のサブエージェントを別々に動かせます。それぞれが独立して動作するため、片方の処理が他方に影響を与えません。

そのため、ファイル読み取りと修正を並行して行えるようになり、効率的な開発環境を構築できます。

メインの精度低下を防げる

サブエージェントを活用すると、メインエージェントのコンテキスト消費を抑えることが可能です。

Claude Codeを含むLLM（大規模言語モデル）は、コンテキストウィンドウと呼ばれる処理可能な情報量の上限を持ちます。この上限に近づくほど回答の一貫性が低下したり処理速度が遅くなったりする傾向があり、長時間の作業や大規模プロジェクトでは、こうした影響が顕著に現れやすくなります。

Anthropicの技術仕様によると、Claude 3.5 Sonnetのコンテキストウィンドウは20万トークンです。大規模なコードベースを扱う際には、あっという間に上限に達することがあります。

サブエージェントを利用すれば、メインのコンテキストを温存しながら処理を実行できます。結果として、セッション全体を通じた回答品質を高いレベルで維持できます。

エージェントごとに権限を設定できる

各サブエージェントには、実行できる操作の権限を個別に設定できます。

権限の設定項目には、ファイルの読み取り専用・書き込み許可・コマンド実行の許可・禁止などがあります。役割に応じて必要最小限の権限だけを与えることで、意図しない変更や削除のリスクを防げます。

たとえばコードレビューを担当するサブエージェントに対し、ファイルの読み取り権限のみを付与して書き込みを制限する設定は非常に有効な手段です。こうした権限の切り分けを徹底する仕組みが、レビュー結果が意図せずソースコードに直接反映されてしまうといった事故を未然に防いでくれるでしょう。

サブエージェントの権限を適切に分けることで、安全性を確保しながらAIに作業を任せられます。

タスクごとにモデルを指定できる

サブエージェントを呼び出す際に、使用するClaudeのモデルを個別に指定できます。

Anthropicは現在、claude-opus-4・claude-sonnet-4・claude-haiku-4など複数のモデルを提供しています。モデルによって処理速度・コスト・精度のバランスが異なるため、必要な処理に合わせてモデルを選択できるのは大きなメリットです。

たとえば精度よりスピードが重要な単純なファイル操作にはHaikuを使い、複雑なロジック設計が必要な場面ではOpusを使うという使い分けが可能です。

タスクの性質に合わせてモデルを最適化することで、品質を落とさずにAPI利用コストを抑えられます。

特定タスク専用の実行部隊が作れる

特定の作業だけに特化したサブエージェントをあらかじめ作成して、いつでも呼び出せる状態にできます。

`/agents`コマンドを使って管理画面からエージェントを作成し、役割・権限・使用モデルをまとめて設定します。一度作成したエージェントはプロジェクトに保存されるため、次回以降もすぐに使い始めることが可能です。

コードレビュー専用エージェント・テスト生成専用エージェント・ドキュメント作成専用エージェントのように、チームのワークフローに合わせた実行部隊を構築できます。

専用エージェントを揃えておくことで、作業のたびに一から指示を書く手間がなくなります。

最適なエージェントにタスクを自動割り振り

メインエージェントは、受け取ったタスクの内容を判断して適切なサブエージェントに自動で作業を割り振ります。

ユーザーから指示されたタスクを分析したうえで、最適なサブエージェントを選択してくれるため、ユーザー側は複雑な割り振り設定を行う必要がありません。

また、複数のサブエージェントが関わるタスクでは、メインエージェントが進行を管理しながら各エージェントの結果を統合して最終的な出力を返します。

ユーザーは大きなタスクを指示するだけで良いため、作業効率を大きく高められます。

Claude Codeサブエージェント機能の活用にかかる費用

Claude Codeのサブエージェント機能を利用するには、Anthropicが提供するAPIの従量課金費用がかかります。

Claude Codeは月額約3,000円のClaude Proプラン、または月額約1万5,000円のClaude Maxプランで利用可能です。ただしサブエージェントを使う場合、APIを直接呼び出す構成になるため、入出力トークン数に応じた追加費用が発生します。

主要モデルにおける、100万トークンあたりのAPI料金は次のとおりです。

モデル名	入力料金	出力料金
Claude Opus 4.7	約750円	約3,750円
Claude Sonnet 4.6	約650円	約2,250円
Claude Haiku 4.5	約150円	約750円

※2026年4月時点の情報を記載しています。価格は1ドル＝150円で換算しています。

なお、サブエージェントが並列で動くほど、一度の処理で消費するトークン数が増えるため料金が上がりやすくなります。

たとえば5つのサブエージェントを同時に動かし、それぞれが1万トークンを消費する場合、1回の処理で合計5万トークン分の費用がかかる計算です。

費用を把握せずに使い続けると、月末に想定外の請求が届くケースがあります。従量課金が膨張しないよう、利用前にAnthropicのコンソール画面でAPIの使用量上限を設定しておくことがおすすめです。

Claude Codeのサブエージェントおすすめ設定3選

ここからは実際の開発現場で役立つサブエージェントのおすすめ設定を、3つにまとめて紹介します。

読み取り専用のコードレビュアー

コードレビューに特化したサブエージェントは、ファイル読み取り専用の権限のみを付与する設定が最も安全です。

コードレビューの本来の目的は、既存コードの問題点を発見して報告することです。コード修正までを処理に含めてしまうと、レビュー中に意図しないコード変更が発生し、バグの原因を特定する作業がかえって複雑になります。

権限を読み取り専用に限定することで、レビュー結果をメインエージェントに返すだけとなり、意図しないコード修正が起こるリスクをなくせます。

設定の例として、役割の説明に「コードの品質・セキュリティ・可読性を評価して指摘一覧を返す。ファイルへの書き込みは行わない」と記載します。モデルはclaude-sonnet-4を指定すると、精度とコストのバランスが取れるため、おすすめです。

コードレビュー専用エージェントを用意しておくと、プルリクエストのたびに毎回同じプロンプトを書く手間をなくせます。

修正コードを提案する専属デバッガー

デバッグ専用のサブエージェントは、エラーログの解析から修正コードの提案まで一気通貫で担当する役割を持たせるのがおすすめです。

デバッグ作業はエラーの調査・原因の仮説立て・修正案の検討という一連の流れすべてがコンテキストに蓄積されます。そのため、専用のサブエージェントを作ることで、メインエージェントのコンテキスト消費を抑えられます。

設定例として、役割の説明に「エラーログと該当ファイルを受け取り、原因分析と修正コードの提案を行う。修正はdiff形式で出力する」と明記します。ファイルへの書き込み権限を与えず、提案のみを返す設定にすると安全性を高めることが可能です。

また、diff形式で出力させることで、メインエージェントが最終確認した後に変更を適用するフローを維持できます。

テスト・仕様書の生成エージェント

テストコードと仕様書の生成を専任で担当するサブエージェントを用意すると、ドキュメント管理の効率が大幅に上がります。

テストコードと仕様書の作成は、開発者が後回しにしがちな作業の代表格です。専用エージェントにこれらを任せることで、実装と並行して自動的にドキュメントを整備できます。

設定の例として、役割の説明に「受け取ったコードを解析し、Jest形式のユニットテストとMarkdown形式の仕様書を生成する。既存のテストファイルは上書きせず、新規ファイルとして出力する」と記載します。

上記のように既存ファイルの上書きを禁止する指示を加えることで、うっかり既存のテストを消去する事故を防ぐことが可能です。

このエージェントをCIの前処理として組み込むことで、プルリクエスト作成時にテストと仕様書が自動で揃う状態を作れます。

Claude Codeのサブエージェントの使い方

ここからはClaude Codeでサブエージェントを設定して呼び出すまでの手順を、3つのステップにまとめて解説します。

1.「/agents」コマンドで管理画面を開く

まずは、Claude Codeのチャット画面でスラッシュコマンド`/agents`と入力して、エージェント管理画面を開きます。

管理画面では、登録済みのサブエージェントの一覧を確認可能です。初めて開いた場合は一覧が空の状態なため、「新規作成」または「Add Agent」に相当するボタンを選択して作成画面に進みます。

作成画面にはエージェント名・役割の説明・権限設定・使用モデルの選択欄があります。エージェント名はメンションで呼び出す際に使うため、役割がひと目でわかる名前をつけることがおすすめです。

`/agents`コマンドはClaude Codeのバージョン1.0以降で利用できます。バージョンが古い場合はアップデートが必要です。

2.役割・権限を指示する

エージェントの作成画面で、役割（システムプロンプト）と権限の2項目を設定します。

役割の説明欄には、そのエージェントが行う処理内容を具体的に記載してください。「コードをレビューする」という抽象的な指示より、「PythonファイルのPEP 8準拠・型ヒントの有無・セキュリティリスクを確認し、指摘点を番号付きリストで返す」のように詳細に記述するほど精度が上がります。

次に権限の設定では、ファイルの読み取り・書き込み・コマンド実行のそれぞれを許可するかを個別に選択します。コードレビュー用なら読み取りのみ、デバッグ用なら読み書きを許可するなど、役割に合わせて最小限の権限を与えることが原則です。

使用モデルの選択欄では、タスクの複雑さに合わせてモデルを指定します。単純な作業にはclaude-haiku-4.5、複雑な推論が必要な作業にはclaude-opus-4.7を選ぶと費用対効果が高まります。

3.メインチャットからメンション（@）で呼び出す

設定が完了したサブエージェントは、メインチャットで`@エージェント名`とメンションして呼び出すことが可能です。

メンションに続けてタスクの内容を書くと、指定したサブエージェントに処理が委任されます。たとえば`@code-reviewer src/auth.py のコードをレビューしてください`のように入力しましょう。

するとメインエージェントがメンションを認識してサブエージェントを起動し、処理が完了した時点で結果をメインチャットに返します。複数のエージェントを同時にメンションすることで、並列処理で実行可能です。

なお、呼び出し後の動作ログは管理画面から確認できます。エージェントがどのファイルにアクセスしたか、どの操作を行ったかを後から追跡できます。

Claude Codeサブエージェント機能を使う際の注意点

ここからはサブエージェント機能を利用する際の注意点を、2つにまとめて解説します。

従量課金のAPI費用に気を配る

サブエージェントを活用するほどAPI呼び出しの回数とトークン消費量が増え、利用費用が積み上がります。

特にサブエージェントを並列で動かす場合、1回の処理で複数のAPI呼び出しが同時発生します。各エージェントが大きなコードファイルを読み込む設定にしていると、1つの指示だけで数万トークンを消費することがあるため注意が必要です。

従量課金による使いすぎを防ぐには、Anthropicのコンソール画面で月ごとの支出上限を設定しておくことがおすすめです。まず月額5ドルから10ドル程度の上限を設定して使い始め、実際の消費量を確認しながら徐々に上限を引き上げることで安全に運用できます。

また、単純なタスクには軽量なclaude-haiku-4.5を使うなど、モデル選択でコストを調整することも有効です。費用を把握せずに大規模な並列処理を走らせることは避けてください。

Claude CodeのAPI活用についてより詳しく知りたい人は、次の記事を参考にしてください。

エラーでループし続ける可能性がある

サブエージェントがエラーを検出して修正を試みる設定にしている場合、修正が成功しないとループ状態に入るリスクがあります。

たとえばデバッガーエージェントが「エラーを修正して再テストする」という役割を持っている場合、修正後のテストでも同じエラーが出続けると修正→テスト→修正のサイクルが止まりません。この状態が続くとトークンを大量消費するだけでなく、コードが意図しない方向に書き換えられる危険もあります。

対策として、サブエージェントの役割の説明に「同じエラーが3回以上連続した場合は処理を停止してメインに報告する」という指示を明記することがおすすめです。

またAnthropicのコンソール画面でAPIのレート制限を設定しておくと、ループが発生した際の被害を最小限に抑えられます。定期的に管理画面のログを確認し、異常なトークン消費がないかをチェックする習慣も重要です。

まとめ

Claude Codeのサブエージェント機能は、タスクごとに役割を分担しながらAIを活用できる点が特徴です。メインエージェントの負荷を抑えつつ、レビュー・デバッグ・テストなどを並行して進められるため、開発効率と品質の両立がしやすくなります。

また、権限設定やタスクの自動割り振りにより、安全性を保ちながら作業を任せられる点も大きなメリットです。とくに実務に近い環境や複数タスクを扱う場面では、その効果を実感しやすいでしょう。

はじめはシンプルな構成から導入し、コードレビューやデバッグなど特定の役割を持つサブエージェントを設定するのがおすすめです。慣れてきたら役割を細かく分けることで、より高度なワークフローを構築できます。

Claude Codeのサブエージェント機能を活用し、AIとの役割分担を最適化することで、日々の開発や学習の効率をさらに高めていきましょう。

こちらの記事もおすすめ