Claude Codeを使っていると、「サブエージェント」という言葉が出てきます。
ざっくり言うと、AIが仕事の一部を別のAIに任せて、結果の要約を受け取るしくみです。
意味と、スキルとの違い、自分の使い方を書いてみます。
サブってことは、AIの部下?
そんな感じ。別室で作業して、結果をまとめて報告してくる部下。
サブエージェントとは?作業を任せる担当者
サブエージェントは、メインのAIから作業を任されて、別のコンテキストで動く担当者のようなものです。
エージェントは、自分で作業を進めるAIのこと。
Claude Codeのサブエージェントには、こんな特徴があります。
- メインの会話とは別のコンテキスト(会話の作業領域のようなもの)で作業する
- 使える道具やモデルを、メインとは別に決められる
- メインに返すのは、基本的に結果の要約
大量のファイルを調べても、読んだ中身でメインの会話が埋まらないんです!
メインには要約が返ってきます。
どんなときに見かける?
- Claude Codeが、調べものを裏で別のAIに任せるとき
- Opusで考えて、Sonnetで作業する、のようにモデルを分けたいとき
- 「Agent」という道具の表示や、
.claude/agents/というフォルダを見かけたとき
Claude Codeでの使い方
最初から入っているものがある
自分で作らなくても、組み込みのサブエージェントがあります。
Explore: コードを探す。読むだけで、ファイルは変更しないPlan: 計画を立てるための調査。これも読むだけgeneral-purpose: 調べて作業もする。すべての道具を使える
普段は、頼みごとに合わせてClaude Codeが任せてくれます。
「サブエージェントで調べて」と頼んでもOKです。
自分で作る場合
たとえばcode-reviewer.mdというMarkdownのファイルを1つ、どちらかに置きます。
.claude/agents/: そのプロジェクトだけ~/.claude/agents/: 自分の全プロジェクト
---
name: code-reviewer
description: コードの品質を確認する。コードを変更したあとに使う
tools: Read, Glob, Grep
model: sonnet
---
あなたはコードレビューの担当です。
問題点を重要な順に報告してください。
必須はnameとdescriptionです。
Claude Codeはdescriptionを見て、任せるかどうかを判断します。
なので「いつ使うか」まで書いておくのがいいと思います。toolsで使える道具を絞って、modelでモデルを指定できます。
別のAIに任せたら、タダになる?
ならない。サブエージェントの分も、同じ利用枠にカウントされるよ。
サブエージェントとスキルの違い
ここ、混ざりやすいです!
サブエージェントは「別の担当者」、スキルは「手順書」と考えると分かりやすいと思います。
| サブエージェント | スキル | |
|---|---|---|
| 中身 | 作業を任せる別のAIの設定 | 必要なときに読む手順や知識 |
| 動く場所 | メインとは別 | 基本はメインの会話の中 |
| 会話の履歴 | 基本は見えない | 基本は見える |
| 置き場所 | .claude/agents/ |
.claude/skills/ |
| 向いていること | 調べものなど、結果だけほしい作業 | 毎回同じ手順でやりたい作業 |
ただ、きれいに分かれているわけでもないんです・・・。
スキルを別の場所で動かす設定(context: fork)や、サブエージェントにスキルを読ませる設定もあります。
自分はこう使ってます
考える役と、手を動かす役を分ける
副業のLP案件で修正を頼んだときは、メインのOpusが指示書を書いて確認し、Sonnetのサブエージェントが実装する形にしました。
修正はPCとスマホで1回ずつ、それぞれ10分ほどです。
指示書を細かく書けたから分けやすかった、というのが大きいと思います。
長い調べものを任せる
この記事でも、公式ドキュメントの確認をサブエージェントに任せました。
長いページを読んでもらって、メインにはまとめだけ返ってきます。
組み込みのclaude-code-guideを使っただけなので、設定は何もしていません。
じゃあ、全部任せればいいのでは?
そうでもない。小さい修正や、何度も相談する作業はメインのほうが早いよ。
サブエージェントでハマった例
- 話の流れを知らないので、「さっきのあれ」だけでは伝わらない。報告の一部が間違っていたこともある → Opusが指示、Sonnetが実装する分担の記事
- OpusとSonnetの使用量を比べようとしたら、測れなかった。Opus側で取れたのはサブエージェント全体の約6万6千トークンで、執筆だけの量を切り出せず・・・
迷ったときの確認ポイント
- 途中の経過はいらなくて、結果だけほしい作業か(ほしいなら向いている)
- 必要な情報を、指示の中に全部書けるか(通常のサブエージェントは会話の履歴を見られない)
- 同じファイルを、同時に直そうとしていないか(自分は同じCSSなら順番にしてます)
- 報告を読んだだけで終わりにしていないか(ファイルや画面で確かめる)
あわせて知っておきたい用語