# Claude Codeの機能と実践的な使い方
🤖 ログや検索結果でメイン会話を汚したくない。そんなとき、専用のコンテキストで作業して要約だけ返すサブエージェントが役立ちます。読み取り専用のレビュアーや調査役を切り出せます。
📌 タイトルと機能のURL
タイトル: サブエージェント
URL:
📝 概要
サブエージェントは特定タスクを担当する専用AIアシスタントです。独自のコンテキストウィンドウ、固有のシステムプロンプト、ツールアクセス、権限を持ち、独立して動いて結果の概要だけをメイン会話に返します。詳細な出力をメインから隔離でき、ツール制限でできることを絞れます。
🔧 機能の説明
・組み込みサブエージェントとしてExplore(Haikuの読み取り専用・コードベース探索)、Plan(プランモードの調査役)、general-purpose(探索と変更の両方を行う複雑タスク向け)があります。
・カスタムサブエージェントはYAMLフロントマター付きMarkdownで定義します。必須は name と description のみです。
・主なフィールドは tools(許可ツール)、disallowedTools(拒否ツール)、model(sonnet/opus/haiku/inherit)、permissionMode、skills、memory などです。
・description をもとにClaudeが委譲を判断します。「use proactively」などの語を入れると積極的に委譲されます。
・サブエージェントは他のサブエージェントを生成できません(無限ネスト防止)。
🛠 実践的な使い方
・/agents コマンドでタブ付きUIを開き、ガイド付きまたはClaude生成でサブエージェントを作成・編集・削除できます(推奨)。
・保存先でスコープが決まります。プロジェクト用は .claude/agents/ 、全プロジェクト用は ~/.claude/agents/ です。前者はバージョン管理でチーム共有に向きます。
・明示的に呼ぶには自然言語(「test-runnerサブエージェントで〜」)、@メンション、またはセッション全体を claude --agent code-reviewer で実行する方法があります。
・読み取り専用レビュアーなら tools: Read, Grep, Glob, Bash のように絞ります。
・memory: project を設定すると、会話をまたいで知見を蓄積する永続メモリを持てます。
🎯 ユースケース
・コードを変更しないコードレビュアーや、長い調査を担う読み取り専用の調査役を定義する。
・テスト実行やログ処理など大量出力を生む作業を隔離し、失敗テストの概要だけを返させる。
・独立した複数モジュールの調査を、別々のサブエージェントで並行実行する。
・安価で高速なHaikuにタスクをルーティングしてコストを抑える。
⚠️ 注意点
・サブエージェントは毎回新しいコンテキストで開始し、会話履歴や既読ファイルは引き継ぎません。立ち上げに時間がかかる場合があります。
・多数のサブエージェントが詳細な結果を返すと、かえってメインのコンテキストを消費します。
・ディスク上のファイルを直接編集した場合、読み込みにはセッション再起動が必要です(/agents経由なら即時反映)。
・bypassPermissions は権限チェックを飛ばすため慎重に使ってください。
#
ClaudeCode# #
DevTools#