サブエージェント入門 — タスクを分割して並列に走らせる

このコースの内容

サブエージェントが別のコンテキストウィンドウを立ち上げ、入力を受け取り要約を返す仕組みを解説。/agents コマンドでのカスタム作成、構造化された出力形式・障害報告・ツール権限の絞り込みによる信頼性設計、そして「使うべきでない場面」のアンチパターンまで。全4レッスン45分と最短。

学習目標

• サブエージェントの仕組みを、別のコンテキストウィンドウが立ち上がり、入力が渡り、要約が戻るまでの流れで説明できるExplain how subagents work: how Claude Code spins up a separate context window, how inputs flow in, and how summaries come back
• /agentsコマンドで、コードレビューやドキュメント生成といった用途のカスタムサブエージェントを作れるCreate custom subagents with the /agents command for workflows like code review and documentation generation
• 出力形式の指定、行き詰まりの報告、ツール権限の制限で、安定して動くサブエージェントを設計できるDesign reliable subagents with structured output formats, obstacle reporting, and limited tool access
• サブエージェントが効く場面を見極め、避けるべきアンチパターンを認識できるDecide when subagents help most and recognize the common anti-patterns to avoid

日本語は AICU による要約です。Anthropic 公式の翻訳ではありません。

カリキュラム — 全4レッスン

1. 1
   サブエージェントとはWhat are subagents?

   サブエージェントの役割と使いどころがわかる回です。タスクを小さな専門役割に分割して別のコンテキストウィンドウで並列処理させ、メインの会話履歴を汚さずに結果だけ受け取る方法や、ClaudeCode">Claude Code に同梱された Explore／Plan 等の組み込みサブエージェントの用途を学べます。さらにカスタムサブエージェントの作り方と活用例を通じて、長時間のワークフローでコンテキストを保つ手法が身につきます。

2. 2
   サブエージェントを作るCreating a subagent

   このレッスンでは、サブエージェントを実際に作成して運用する流れを学べます。/agents コマンドで新規作成する手順、アクセスさせるツールや使用モデル（Haiku/Sonnet/Opus/Inherit）の選び方、設定ファイル（CLAUDE.md の YAML）とシステムプロンプトの書き方を理解します。さらに「proactively」を使った自動委譲の仕組みや動作確認の方法まで、実務で使える実装知識が身に付きます。

   • サブエージェントの作成
   • ツールのカスタマイズ
   • モデルと色の選定
   • Config ファイル
   • システムプロンプト
   • Claude に自動サブエージェント使用をさせる方法
   • サブエージェントのテスト
3. 3
   効果的なサブエージェントの設計Designing effective subagents

   この回では、タスクを分担するサブエージェントを安全かつ効率的に運用するための実践ルールを学びます。具体的には、起動タイミングと振る舞いを決める説明文の書き方、出力フォーマットで終了条件を明確にする設計、作業中に見つけた回避策や問題を報告させる方法、不要なツール権限を絞ることで副作用を防ぐ手法が身につきます。これにより並列処理の信頼性と再利用性が高まります。

   • サブエージェント設定データの利用法
   • 入力プロンプトを導く説明文の作成
   • 出力フォーマットの定義
   • 障害の報告
   • ツールアクセスの制限
   • 全体の統合
4. 4
   サブエージェントを使いこなすUsing subagents effectively

   サブエージェントをいつ使うべきか、実践的な判断基準が身につきます。探索的な調査やコードレビュー、専用の system prompt を必要とする作業はサブエージェントに向く一方で、段階間の情報依存が強い逐次パイプラインやテスト実行のように中間結果が重要な場面では逆効果になる理由が理解できます。どの作業をメインスレッドで追うべきかを見極める「Decision Rule」を使って設計判断ができるようになります。

   • サブエージェントが活躍する場面
   • リサーチ業務
   • コードレビュー
   • カスタムシステムプロンプト
   • サブエージェントが害になる場合
   • 専門家主張の問題点
   • 逐次パイプライン
   • テストランナー
   • 意思決定ルール

見出しは公式の構成にもとづく日本語の要約です。レッスン本文は公式サイト上でのみ提供されています。各行から公式ページへ移動します。

この講座に出てくる用語 — 8語

この講座で扱う概念です。意味が分からない語で止まったら、ここから辞典を引けます。数字は難易度（1が易しく5が難しい）。
本文中でも初めて出てきた箇所にリンクを張っています。

• プロンプト1
• 機械学習1
• Claude2
• Claude Code2
• CLAUDE.md2
• コンテキストウィンドウ2
• サブエージェント2
• ステム2

用語の解説は AICU term（AICU が独自に編集している用語辞典）。