# 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#