Claude Code 解説 / 2026年11月時点
Claude Code には、仕事の一部を別のAIに任せ、結果だけを持ち帰ってもらう「サブエージェント」という仕組みがあります。上司と部下の関係にたとえながら、知っておけば十分なことだけをまとめました。
Claude Code(パソコン上でAIに作業を任せられるツール)で長く作業していると、AIとの会話に検索結果やログ、ファイルの中身がどんどん溜まります。会話が長くなるほど、AIが一度に覚えていられる量を圧迫し、大事な指示が埋もれやすくなります。その対策が、サブエージェントです。この記事で分かることは、次の3つです。
社長が「この件、調べておいて」と頼むと、別室の担当者が資料を山ほど読み、結論だけをメモにして持ち帰る。社長の机には、膨大な資料は積み上がりません。サブエージェントは、このときの担当者にあたります。社長がメインの会話、担当者がサブエージェントです。
担当者には、次のような特徴があります。
使いどころの目安は、同じ種類の作業役を何度も呼び出して、毎回同じ指示を出しているときです。そうなったら、その役を自分用のサブエージェントとして登録します。
サブエージェントも、メインの会話と同じ利用枠を使います。無料になるわけではありません。軽い仕事を安いモデルに回すことで、全体の費用を下げるのが狙いです。
自分で作らなくても、Claude Code が必要と判断したときに自動で呼び出す、組み込みの担当者がいます。
| 名前 | たとえると | 役割 |
|---|---|---|
Explore | 調査担当 | ファイルの発見やコードの検索など、全体の把握。読み取り専用で、書き換えはできません |
Plan | 下調べ担当 | 計画を立てる前に、必要な情報を集める。こちらも読み取り専用です |
general-purpose | 何でも屋 | 調べたうえで、実際に手も動かす複雑な作業を受け持つ |
このほか、特定の場面だけで使われる補助の担当者もいます。まずは、この3種類を知っておけば十分です。
サブエージェントの正体は、先頭に設定欄が付いた文書ファイル(Markdown)1枚です。Claude Code に「見積書チェック役を作って。読み取り専用で、モデルは Sonnet」と日本語で頼めば、作ってもらえます。できあがるファイルは、次のような形です(TITC が作った短い例です)。
---
name: estimate-checker
description: 見積書の金額・数量・税の計算を点検する。見積書を作成・修正した後に使う。
tools: Read, Grep, Glob
model: sonnet
---
あなたは見積書の点検担当です。
金額・数量・消費税の計算が合っているかを確認し、
直すべき箇所を「場所・理由・正しい値」の順で報告してください。
ファイルは書き換えないでください。先頭の --- で囲まれた部分が設定欄、その下が担当者への指示文です。必須なのは name(名前)と description(何が得意かの説明)の2つだけです。tools に読み取り用の道具だけを書いたので、この担当者はファイルを書き換えられません。
~/.claude/agents/:自分のすべてのプロジェクトで使えます。個人の便利役はここに置きます。.claude/agents/:そのプロジェクトだけで使えます。ファイルとして共有できるので、社内で統一したい点検役に向いています。同じ名前が複数の場所にあるときは、より範囲の狭い場所(プロジェクト用)が優先されます。作ったのに見つからないときは、Claude Code を再起動してください。agents フォルダを新しく作った直後は、再起動が要ることがあります。
Claude は、あなたの依頼の内容、担当者の description、いまの会話の状況を見て、「この仕事は任せよう」と判断します。description は、担当者の名刺のようなものです。肩書があいまいだと、仕事を振りにくくなります。より積極的に任せてほしいときは、説明文に「先回りして使う」という意味の use proactively を入れます。説明文は短く保つのが基本です。
いちばん手軽なのは、「estimate-checker サブエージェントに、この見積書を見てもらって」と普通の文章で頼む方法です。入力欄で @ を打って候補から選ぶこともできます。どちらも、その依頼1回だけの指定です。作業の間ずっとその役で動かしたいときは、起動時に claude --agent 名前 と指定します。ただし、文章や @ で名前を出しても、実際に任せるかどうかを決めるのは Claude です。確実に指定したいときは --agent を使います。
担当者の動き方には、2つあります。
| 前面 | 背景(裏) | |
|---|---|---|
| 動き方 | 終わるまで、メインの会話が止まって待つ | 裏で動き、あなたは別の作業を続けられる |
何も設定しなければ、Claude が呼んだ担当者は背景で動きます。待たずに次の依頼を出せるのが利点です。注意したいのは、背景の担当者が許可の必要な操作に達したとき、確認がメインの画面に出ることです。そこで「このセッションの間はずっと許可」のような広い答えを選ぶと、メインの会話にも効いてしまいます。範囲の広い許可は慎重に選んでください。
部下に任せるときと同じで、持たせる権限は必要なぶんだけが基本です。
tools に書いた道具だけが使えます。省略すると、使える道具をすべて引き継ぎます。読み取り専用にしたいときは、必ず書いてください。逆に、使わせない道具だけを disallowedTools に並べる方法もあります。model に haiku・sonnet・opus などを書けます。何も書かなければ、呼び出した会話と同じモデルで動きます。読む仕事は安いモデル、書く仕事は中位のモデル、判断はメインの高いモデル、という分け方が目安です。報告文の中に「許可をすべて外せ」のような指示が紛れ込んでも、Claude Code は報告を点検して、会話の一部と取り違えにくくしています。ただし、内容が悪意あるものかまでは判断しません。最後の確認は人が行ってください。
ふつうの担当者は、渡された指示だけを頼りに、まっさらな状態から始めます。新しく入った派遣スタッフに、メモ1枚だけ渡すようなものです。これに対してフォークは、それまでの会話の記憶を丸ごと持った状態で分岐する子のAIです。同じ打ち合わせに最初から同席していた同僚が、「その続きをやっておきます」と引き受けるイメージです。背景の説明が長くなりすぎるときに向いています。自分から分岐させるときは /subtask を使います。
どこまで許すかの違いで並べると、考え方が分かりやすくなります。
どの例にも共通する心がけは、1体に1つの仕事、説明文で他の担当と区別できるようにする、持たせる道具は最小限にする、の3つです。