最近AIを活用したコーディングが当たり前になってきましたが、中でもAnthropicのClaude Codeは、その自律性の高さで注目を集めていますね。特に気になるのが「サブエージェント」という機能。一体どうやって設定すればいいのか、何が便利なのか、具体的な使い方が分からず手が止まってしまっている方も多いかもしれません。この記事では、初心者の方でも迷わずに済むよう、Claude Codeのサブエージェントの使い方について、基本的な概念から実際の動かし方まで丁寧に解説していきます。これを読めば、あなたの開発効率が劇的に変わるはずですよ。
- サブエージェントを導入することで得られる具体的なメリット
- コンテキストの腐敗を防ぎ、精度を高く保つための仕組み
- 初心者でも簡単にできるサブエージェントの基本設定手順
- コストを抑えつつ最大限のパフォーマンスを引き出すモデルの選び方
Claude Codeとサブエージェント使い方の基本
まずは、サブエージェントがなぜ今の開発シーンでこれほど重要視されているのか、その背景と基本的な仕組みについて深掘りしていきましょう。これを理解すると、使いこなしの質がグッと上がります。
サブエージェントのメリットとコンテキストの分離
AIと長くチャットをしていると、だんだん返答が曖昧になったり、さっき言ったことを忘れられたりした経験はありませんか？これが「コンテキストの腐敗」と呼ばれる現象です。Claude Codeのサブエージェントは、この問題を構造的に解決するために設計されています。通常のチャットでは、過去の会話履歴がすべて一つの「袋」に入れられます。会話が長くなればなるほど、AIにとって重要な情報がノイズに埋もれ、指示の遵守率が低下してしまうのです。
サブエージェントの最大のメリットは、メインの会話とは別に「特定のタスク専用の独立したメモリ空間」を持てることです。例えば、アプリ全体のアーキテクチャを管理する「メインエージェント」が、特定のUIコンポーネントのバグ修正を「サブエージェント」に依頼するとします。サブエージェントが修正のために何十行ものエラーログを読み込み、試行錯誤を繰り返したとしても、その雑多なプロセスはメインエージェントのメモリには同期されません。メインエージェントには「修正が完了し、〇〇ファイルを更新しました」というクリーンな結果だけが報告されます。
コンテキスト分離による劇的な利点
- 思考の純度維持：メインの思考が常にクリアに保たれ、プロジェクト全体の整合性を見失うような判断ミスが激減します。
- トークンの節約：無関係なデバッグログをメインエージェントが持ち続ける必要がないため、APIコスト（トークン消費）を大幅に効率化できます。
- 並行処理の安全性：複数の複雑な問題を同時に扱っても、Aのバグ情報とBの機能要望が混ざってしまうような「AIの混乱」を防げます。
なぜ「情報の隔離」が必要なのか
大規模なリポジトリで開発を行う際、AIに全てのファイル構成を把握させようとすると、すぐにコンテキストウィンドウ（一度に扱える情報量）の限界に達します。サブエージェントは、必要な時に必要な範囲のファイルだけを読み取る「使い捨ての作業員」として機能するため、メインエージェントは常に高い俯瞰視点を維持できるわけです。これは、複雑なソフトウェア開発において、エンジニアが関数やクラスをモジュール化して関心の分離を行うのと全く同じ理屈ですね。
実際に、大規模なコードベースでの自律型エージェントの挙動については、多くの開発者がその有効性を報告しています。 （出典：Anthropic公式ブログ『Claude 3.5 Sonnet』の性能検証）
役割に応じた専門特化型AIの仕組み
サブエージェントは、単にメインエージェントをコピーした「分身」ではありません。それぞれに固有の「人格」や「専門知識」を与えられた「スペシャリスト」として振る舞わせることができます。これを「専門特化（Specialization）」と呼びますが、これが実に強力な武器になるんです。一人のAIに「何でもやって」と頼むよりも、「君はセキュリティの権威として振る舞って」と限定的な役割を与える方が、出力の精度は飛躍的に向上します。
具体的には、サブエージェントごとに異なる「システムプロンプト」を割り当てます。例えば、フロントエンドの修正を行うサブエージェントには、使用しているフレームワーク（ReactやVueなど）の最新ベストプラクティスを徹底的に守るよう指示し、一方でバックエンド担当には、DBのクエリ効率やセキュリティ対策を最優先するよう叩き込みます。このように役割を分担させることで、人間が専門家チームを編成するのと同様の「多角的な視点」をAI開発に取り入れることができるのです。
専門特化させることによる実務上の変化
専門特化型エージェントを導入すると、アウトプットの「ブレ」がなくなります。汎用的なAIは時として、指示していないことまで良かれと思って書き換えてしまうことがありますが、専門特化エージェントは与えられた任務に忠実です。
- ドキュメント作成専門：コードの変更を検知し、常に最新のREADMEやAPIリファレンスをメンテナンスし続ける。
- テストエンジニア専門：書かれたコードに対して、境界値テストや異常系テストを執拗に提案・実装する。
- リファクタリング専門：ロジックを変えずに、コードの可読性と保守性だけを極限まで高める提案を行う。
人間でも「フルスタックエンジニア」に全責任を負わせるより、フロント、バック、インフラの各リーダーがレビューし合う方が品質が高まるのと同じですね。サブエージェントを使い分けることで、あなたのターミナル内に「最強の開発チーム」が出来上がるイメージです。
初心者でも分かるオーケストレーターの役割
Claude Codeのサブエージェント運用において、中心的な役割を果たすのが「オーケストレーター（Orchestrator）」という概念です。言葉の通り、オーケストラの指揮者のような役割ですね。あなたがClaude Codeに対して「ECサイトの決済機能を実装して」という大きな、あるいは抽象的な依頼を投げたとき、このオーケストレーターが即座に起動します。
オーケストレーターの主な仕事は、タスクの「分解」と「割り振り」です。まず、決済機能の実装という大きな塊を、「API仕様の確認」「データベースのスキーマ作成」「フロントエンドのUI構築」「ユニットテストの作成」といった小さなタスク（サブタスク）に切り分けます。そして、それぞれのタスクに適した能力を持つサブエージェントを生成、あるいは呼び出し、具体的な作業を命じます。この「AIがAIをマネジメントする」という多層的な構造こそが、Claude Codeが従来のAIチャットと一線を画すポイントです。
指揮者がいることで実現する「自律性」
もしオーケストレーターがいなければ、人間であるあなたが「次はこれをして、その次はこれを読んで……」と一歩ずつ指示を出し続けなければなりません。しかし、優秀な指揮者がいれば、あなたは最終的なゴールを示すだけで済みます。
オーケストレーターの行動パターン
- プランニング：現在のコードベースをスキャンし、作業の全体計画を立てる。
- デリゲーション（委譲）：特定のアクション（ファイルの読み書き、検索など）をサブエージェントに任せる。
- レビュー：サブエージェントから戻ってきた成果物をチェックし、不備があれば再指示を出す。
- 統合：すべての成果をまとめ、一つの完成形としてユーザーに提示する。
このプロセスにより、ユーザーは細かい実装の詳細に溺れることなく、プロジェクトの進捗管理や仕様の最終決定という、より「人間らしい」仕事に集中できるようになります。まさに、AI時代の新しいPM（プロジェクトマネージャー）の姿と言えるかもしれません。
モデル選択によるコストパフォーマンスの最適化
AIを開発に導入する上で、どうしても無視できないのがコスト管理の問題ですよね。Claude Codeでは、タスクの重要度や複雑さに応じて、サブエージェントが使用する「モデル（AIの脳のレベル）」を賢く使い分けることが推奨されています。全ての作業を最高スペックのモデルで行えば精度は上がりますが、その分トークン料金も跳ね上がってしまいます。これを最適化するのがプロの使いこなし術です。
| モデル名 | 得意なタスク | コスト効率 | 推奨される用途 |
|---|---|---|---|
| Claude 3.5 Haiku | 高速な検索、定型的な置換、ドキュメントの要約 | 最高（非常に安価） | 単純作業を大量にこなす「ワーカー」 |
| Claude 3.5 Sonnet | コード実装、高度な推論、デバッグ、リファクタリング | 良好（バランス重視） | 標準的な開発作業を担う「メインエンジン」 |
| Claude 3 Opus | 超複雑なアルゴリズム設計、厳格なセキュリティ監査 | 低い（高価） | 重要な局面での「シニアコンサルタント」 |
「適材適所」がもたらす長期的な運用メリット
例えば、1,000個のファイルを検索して特定のキーワードを探すようなタスクに高価なSonnetやOpusを使うのは、宝くじを買うために高級リムジンをチャーターするようなものです。こういった「パワーは不要だが量が多い」作業には、爆速で安価なHaikuをサブエージェントとして割り当てるのが正解です。
一方で、システムの根幹に関わる認証ロジックの修正などは、1円を惜しんでバグを出すリスクを冒すよりも、最も賢いモデルを召喚すべきです。このように、サブエージェントごとにモデル設定を切り替えることで、全体の開発精度を100%に保ちつつ、実行コストを30%〜50%程度削減することも夢ではありません。賢いモデル選びは、単なる節約術ではなく、AIを継続的に使い続けるための必須スキルなんです。
開発効率を最大化する自律的なワークフロー
最終的にClaude Codeのサブエージェント機能を使いこなすということは、人間が「指示待ち」のAIを動かすのではなく、AIが「自律的」に動くワークフローを構築することを意味します。理想的なワークフローでは、人間が「〇〇機能を実装して、テストも通しておいて」と一言投げるだけで、AI側で「調査・計画・実行・検証」のサイクルが自動的に回り始めます。
サブエージェントは、まずターゲットとなるコードの周辺状況を自律的にリサーチします。関連するライブラリのバージョン、既存の関数の命名規則、テスト環境の設定などを勝手に把握し、その情報を元に最適な実装案を練り上げます。人間がその都度「このファイルも読んで」「あのドキュメントも見て」と教える必要はありません。彼らは必要だと思えば、自分で ls や grep を駆使して情報を集めてくるのです。
「作業代行」から「問題解決」へのシフト
この自律的なワークフローが定着すると、エンジニアの役割は「コードを書く人」から「コードの品質を保証するディレクター」へと進化します。
- 自動エラー修復：テストが失敗すれば、サブエージェントが自らエラーメッセージを解析し、修正案を適用して再テストを試みます。
- 継続的ドキュメンテーション：コードの変更に合わせて、サブエージェントがコミットメッセージを生成し、関連する技術ドキュメントも更新します。
- フィードバックの最小化：人間は最後のPR（プルリクエスト）の確認だけで済むようになり、開発のスループットが極限まで高まります。
まさに、自分専用のジュニアエンジニアが何人も同時に働いてくれているような感覚。この圧倒的な開発体験を一度味わってしまうと、もう以前のような手動コーディングには戻れなくなるかもしれませんね。
実践Claude Codeとサブエージェント使い方の手順
ここからは、実際に自分のPCでClaude Codeを動かし、サブエージェントを設定・運用するための具体的なステップを見ていきましょう。難しく考える必要はありません。Claude Codeはユーザーフレンドリーに設計されているので、基本的なコマンドさえ覚えればすぐに使い始められますよ。
/agents コマンドによる対話的な初期設定
もっとも手軽で、かつおすすめの始め方が、Claude Codeのセッション内で /agents コマンドを実行する方法です。このコマンドを打つと、対話形式で新しいサブエージェントを作成するための専用メニューが立ち上がります。
画面の指示に従って、「どんな役割のエージェントにしたいか」を日本語で入力するだけでOKです。例えば、「このプロジェクトのReactコンポーネントをAtomic Designに基づいてレビューする専門家を作って」と伝えれば、Claudeがその役割に適した複雑なシステムプロンプトを自動的に生成してくれます。初心者がゼロから完璧なプロンプトを書くのは大変ですが、この対話モードを使えば、AIの力を借りて「最強の部下」を即座に作成できるわけです。生成された設定を見て、「あ、こんなふうに指示を出せばいいんだな」と学ぶことも多いはずですよ。
プロジェクトとパーソナルのスコープ管理
サブエージェントを作成する際、必ず意識してほしいのが「スコープ（適用範囲）」の概念です。Claude Codeでは、エージェントの設定ファイルを保存する場所によって、そのエージェントがどこから呼び出せるかが決まります。これを理解していないと、「せっかく作ったエージェントが別のプロジェクトで見つからない！」なんてことになりかねません。
| スコープ名 | 保存場所 | 特徴と使い分け |
|---|---|---|
| Project スコープ | [プロジェクト]/ .claude/agents/ | そのプロジェクト専用。Gitで共有すればチーム全員が同じエージェントを使える。 |
| Personal スコープ | ホームディレクトリの ~/.claude/agents/ | 自分専用。どのプロジェクトを開いていても呼び出せる。汎用的な便利ツール向け。 |
共有か、独占か、それが問題だ
使い分けの基準はシンプルです。特定のプロジェクトのコーディング規約やライブラリ構成に深く依存するようなエージェント（例：「このアプリ専用のテスト生成くん」）は、Projectスコープで保存し、 .claude フォルダごとGit管理に含めるのが正解です。チームメンバーが同じコマンドを打った時に、全く同じ品質のレビューが受けられるようになります。
一方で、「Markdownをきれいに整形する」とか「コミットメッセージを日本語で格好よく書く」といった、プロジェクトを問わずに使える個人的な相棒は、Personalスコープに置いておきましょう。自分だけの「秘伝のタレ」として、あらゆる開発現場へ持ち運ぶことができます。
システムプロンプトによる役割定義とカスタマイズ
サブエージェントの「魂」とも言えるのが、Markdown形式の定義ファイル内に記述するシステムプロンプトです。ここでどれだけ具体的に「あなたは誰で、何をすべきか（あるいは何をすべきでないか）」を定義できるかで、エージェントの有能さが決まります。曖昧な指示は、曖昧な結果しか生みません。
効果を倍増させるプロンプトのテクニック
- 役割の明示：「あなたは10年以上の経験を持つシニアSREエンジニアです」のように、権威性を定義する。
- 行動指針の固定：「新しいファイルを作る前に必ず既存の
/utilsを検索し、再利用できる関数がないか確認してください」といった具体的な手順を指定する。 - 制約事項の厳守：「いかなる理由があっても、
package.jsonのバージョンを勝手に書き換えてはいけません」のように、禁止事項を明記する。 - 出力フォーマットの指定：「返答は必ずJSON形式で返し、ルートキーに ‘analysis’ と ‘actions’ を含めてください」といった指定。
面白いのは、サブエージェントに「性格」を与えることもできる点です。「初心者にも優しく解説するメンター風」に設定すれば、コードの修正箇所を教えるだけでなく、なぜその修正が必要なのかという教育的なフィードバックをくれるようになります。逆に「厳格なコードレビュアー」にすれば、インデントの一つまで妥協を許さないプロの目線でチェックしてくれます。自分が必要としている「最高の同僚」を、言葉だけで作り上げることができる。これがカスタマイズの醍醐味ですね。
権限モードの設定とセキュリティの確保
AIにターミナル操作やファイルの読み書きを許可することに、不安を感じる方もいるかもしれません。「勝手に大事な設定ファイルを消されたらどうしよう？」という懸念は、プロフェッショナルであれば当然の感覚です。Claude Codeでは、サブエージェントごとに「権限モード」を細かく設定することで、このリスクを完全にコントロールできます。
例えば、調査だけを依頼したい場合はread-onlyモードが最適です。このモードのエージェントは、コードを読むことはできますが、一切の変更を加えることができません。不慣れなコードベースを解析させる際も、これなら安心して任せられますよね。また、実際の書き換えを伴う作業であっても、planモードを活用すれば、エージェントが具体的な変更案を作成した後、実行する前に必ずユーザー（あなた）の「承認（Yes/No）」を求めるようになります。
セキュリティの多重防護
さらに、特定のディレクトリ（例えば .env や秘密鍵を含むフォルダ）を触らせないようにするには、 .claudeignore ファイルを活用しましょう。これは .gitignore と同じ要領で、AIがアクセスしてはいけない場所を指定できる仕組みです。
「便利だけど危なそう」というイメージを、「制御可能で安全なツール」へと変える。これが、プロジェクトのリーダーやセキュリティ担当者に Claude Code の導入を納得させるための鍵となります。権限を適切に絞ることで、AIを「野放し」にするのではなく、あくまで「あなたの監督下にある優秀なツール」として安全に運用できるのです。
無限ループを防ぐトラブルシューティングのコツ
AIエージェントを使っていると、稀に「同じエラーメッセージを出し続け、何度も同じ修正を試みるが失敗する」という、いわゆる無限ループ（トートロジー）に陥ることがあります。これは多くの場合、エージェントが直面している問題に対して、コンテキストが足りないか、あるいは逆に情報が多すぎて何が真因か見失っている時に起こります。
そんな時の特効薬は、/compact コマンドです。これは、これまでのダラダラと長くなった会話履歴をAIに「要約」させ、重要なポイントだけを抽出してメモリを整理するコマンドです。脳内のゴミを掃除して、思考をリフレッシュさせるようなものですね。これで解決しない場合は、一度サブエージェントのセッションを終了し、より具体的な制約やヒントを与えて再スタートさせましょう。
トラブルを防ぐためのチェックリスト
- 依存関係の肥大：
node_modulesやvenvなどをAIが全スキャンしようとしていませんか？.claudeignoreで除外しましょう。 - 曖昧な指示： 「いい感じに直して」ではなく、「〇〇のエラーが出ているので、△△の関数にヌルチェックを追加して」と具体的に伝えましょう。
- トークン上限： コンテキストが満杯になると、AIの推論能力は極端に低下します。定期的に
/compactを実行する癖をつけましょう。
もしAIが「自分では解決できません」と弱音を吐いたら、それは人間が介入すべきサインです。そこまでの試行錯誤の過程をAIにまとめさせれば、あなたがゼロから調査するよりも遥かに早く正解に辿り着けるはず。AIの限界を理解し、適切に手助けしてあげることも、優れた「AI使い」になるための第一歩です。
ターミナルで完結するサブエージェント使い方のまとめ
ここまで紹介した通り、Claude Codeのサブエージェント機能は、個別のタスクを専門家に任せることで、開発の精度とスピードを両立させる素晴らしい仕組みです。「claude code サブエージェント 使い方」をマスターすることは、もはや単なる操作方法の習得ではなく、これからのAI協働時代におけるマネジメントスキルそのものだと言えますね。
最初は /agents コマンドで簡単なアシスタントを作ることから始め、慣れてきたら自分専用のプロンプトでカスタマイズを深めていってください。AIに丸投げするのではなく、適切な権限を与え、適切なモデルを選び、そして時には指揮者として導く。このプロセス自体が、あなたのエンジニアとしての視座を一段高くしてくれるでしょう。
きっと、今まで苦労していたデバッグやリサーチが、驚くほど楽に感じられる日が来るはずです。AIを単なる「ツール」から「頼れるチームメイト」へと変える。ぜひ、今日からあなたのターミナルに、頼もしいサブエージェントを召喚してみてください。
