Claude Codeの「サブエージェント」を使いこなす

サブエージェントとは

【エンジニア募集中】フルリモート可◎、売上/従業員数9年連続UP、平均残業8時間、有給取得率90％、年休124日以上 etc.　　詳細はこちらから＞

 Claude Codeには「サブエージェント」という機能があります。

これは、メインの会話とは別に、独自のシステムプロンプトとツール権限、そして独立したコンテキストウィンドウを持つ、特化型のAIアシスタントです。

特定のタスクをサブエージェントに任せることで、検索結果やログなどの大量の出力がメインの会話に混ざらず、本来の作業に集中できます。

Claude Codeには最初からExploreやPlanといったビルトインのサブエージェントが用意されており、依頼内容に応じて自動的に呼び出されます。

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

独自のサブエージェントを作るには、.claude/agents/(プロジェクト単位)や~/.claude/agents/(全プロジェクト共通)にMarkdownファイルを作成します。
構成はYAMLフロントマターと本文というシンプルな形式です。

Markdownファイル例）

 フロントマターにはname(識別名)、description(どんな場面で使うかの説明)、tools(使わせるツールの一覧)、model(使用モデル)を書き、その下の本文にシステムプロンプトとして具体的な指示を記述します。

descriptionはClaudeが自動委任の判断材料にする部分なので、発動条件を具体的に書くほど精度が上がります。toolsは必要なものだけに絞ることでセキュリティを高められ、modelは軽いタスクを安価なモデルに回すといった使い分けができます。

ファイルを直接編集する以外に、Claudeに「〇〇するサブエージェントを作って」と頼んで自動生成してもらう方法もあります。

使用時に気を付けるポイント

サブエージェントはメインの会話の文脈を引き継がず、基本的に何も知らない状態からスタートします。必要な情報は依頼のプロンプトに明示的に含める必要があります。

また、ファイルとして定義したサブエージェントはセッション開始時にのみ読み込まれるため、作成・編集後は原則としてセッションの再起動が必要です。

同じ名前のサブエージェントが複数存在すると片方しか読み込まれないため、命名の重複にも注意しましょう。

サブエージェント自体がClaudeを「賢く」するわけではなく、あくまで文脈を整理し、コストと安全性を両立させるための仕組みだと理解しておくとよいでしょう。

【エンジニア募集中】フルリモートも◎(リモート率85.7％)、平均残業8時間、年休124日以上、有給取得率90％ etc.　詳細はこちらから＞