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

TL;DR

Claude Codeでは、役割、システムプロンプト、利用ツールを定義し、特定タスク向けのサブエージェントを作成できる。独立したコンテキストで重い処理を任せ、必要な結果だけをメイン側へ返すことで、コンテキスト消費を抑えながら専門作業を分担できる。

Transcript

おすマです。本日はですね、クロード コード、こちらからエージェンツ機能が、 え、表に登場してきたんで、これについて お話ししていきたいなという風に思います 。え、今までもですね、クロードコードに は、え、裏で動いてくれるサブ エージェンツという機能が、え、実は存在 していたんですが、え、例えばね、1つの 大きいタスクの中で、え、分散して、え、 サブエージェンツで、え、やってください みたいな感じで、え、指示脱出ことで、え 、ま、分散してAIエージェントが、え、 並列でタスクをこなすみたいなことができ たんですけども、え、今回は、え、 スラッシュコマンド、え、クロードコード 上でここでね、え、スラッシュで、え、 打ち込むとエージェンツというのが登場し て、ま、これがですね、え、自分が カスタマ... Read More

Key Insights

• サブエージェントは、特定の役割とタスクを割り当てられ、メインのエージェントとは別のコンテキストで処理を実行するAIエージェントである。
• 独立したコンテキストは、画像やサイトデータなど処理量の大きい情報を別領域で扱い、結果だけをメイン側へ返すことで消費を抑える仕組みである。
• ツール制限は、Web検索、ファイル書込み、MCPサーバー経由の機能などから、サブエージェントに必要なものだけを選択できる設定である。
• システムプロンプトは、コードレビューなどの専門的な役割、振る舞い、出力方針を定義し、目的に近い成果物へ誘導するために調整できる。
• プロジェクトエージェントは、対象ディレクトリ内の定義として保存され、そのプロジェクト固有の作業に繰り返し利用できるエージェントである。
• 個人用エージェントは、特定プロジェクトに限定されず、複数のプロジェクトをまたいで利用したい共通作業に向く保存形式である。
• ツールの厳選は、不要な選択肢を減らしてエージェントの迷いを抑え、意図した範囲で専門タスクを実行させるための設計手段である。
• 結果の受渡しは、結論だけでなく判断理由や参照した文脈も含めないと、メイン側との認識差が生まれて成果を利用しにくくなる可能性がある。
• 🎬 このチャンネルの他の動画:
  • Grok BuildでClaude資産を使う方法
  • Claude自動化制限後の移行先を選ぶ方法
  • GPT-5.6 LunaとTerraの選び方は？
• 📺 このチャンネル: まさおAIじっくり解説ch

Questions & Answers

Q: Claude Codeのサブエージェントとは何ですか？

Claude Codeのサブエージェントとは、特定の役割やタスクを任せるために定義できるAIエージェントです。メインのエージェントとは独立したコンテキストで動作し、専用のシステムプロンプトや利用可能なツールを設定して、必要な処理結果をメイン側へ返せます。

Q: Claude Codeでサブエージェントを作成する方法は？

Claude Codeでエージェント画面を開き、新規エージェントの作成を選択します。保存範囲をプロジェクト用または個人用から決め、担当させたい役割を入力して定義を生成します。その後、利用ツールと表示色を選び、内容を確認して保存すれば作成できます。

Q: サブエージェントでコンテキストを節約する方法は？

画像分析やサイトデータの処理など、コンテキストを多く使う作業をサブエージェントへ渡し、処理結果だけをメイン側へ返します。入力としてファイルのパスなどを渡せば、メイン側が重い情報を直接読み込まずに済み、中心となる作業領域の消費を抑えられます。

Q: サブエージェントに許可するツールの選び方は？

担当する役割の実行に必要なツールだけを選びます。選択肢には読取や編集に関する機能、Web関連機能、MCPサーバー経由で追加された機能などが含まれます。不要なツールを外すことで選択肢を減らし、意図した範囲で処理させやすくなります。

Q: プロジェクト用と個人用エージェントの違いは何ですか？

プロジェクト用は対象ディレクトリ内に定義され、そのプロジェクト固有の役割や作業に利用します。個人用はユーザー領域に作成され、複数のプロジェクトをまたいで使えます。特定案件だけで使うならプロジェクト用、頻繁に共通利用するなら個人用が適しています。

Q: サブエージェントのシステムプロンプトを調整する方法は？

生成されたエージェント定義を確認し、役割、実行方針、期待する出力にずれがあれば手動で修正します。たとえば厳しいコードレビューを担当させる場合は、その目的が伝わる説明や指示を具体化します。英語の定義が扱いにくければ、日本語へ直して調整できます。

Q: サブエージェントを意図した場面で呼び出す方法は？

必要な場面では明示的にサブエージェントを指定するか、Claude Codeのルールやワークフローに呼出条件を記述します。作成しただけでは期待どおりに選ばれない場合があるため、どの種類の作業で、どのエージェントを使うかを定義して運用を調整します。

Q: サブエージェントの回答を実用的にするには何が必要ですか？

結論だけでなく、どの情報を受け取り、なぜその判断や結果に至ったのかも返すように設計する必要があります。適切なコンテキストが渡されず、判断過程も共有されない場合、メイン側との情報認識に差が生まれ、返された結果を活用しにくくなる可能性があります。

Summary & Key Takeaways

• サブエージェントは、Claude Codeから特定のタスクを任せられる、独立したコンテキストを持つAIエージェントである。画像分析、サイトデータの処理、コード作成、ファイル読込などを別のコンテキストで実行し、結果だけをメイン側へ戻せるため、中心となるエージェントのコンテキスト消費を抑えながら作業を分担できる。

• 作成時はClaude Codeでエージェント画面を開き、新規作成を選び、プロジェクト用または個人用の保存範囲を指定する。続いて役割を文章で入力し、生成された定義を確認する。利用可能なツールは個別に選べ、読取、編集、Web関連、MCPサーバー経由の機能などを役割に応じて制限できる。最後に表示色を選択して保存する。

• 運用では、頻繁に使うエージェントを個人用、特定案件に閉じたものをプロジェクト用として再利用できる。成果を安定させるには、説明文やシステムプロンプトを目的に合わせて修正し、必要なツールだけを許可することが重要である。また、いつ呼び出すかをルールやワークフローに記述し、入力だけでなく判断理由も返させる設計が求められる。