本文へスキップ
AI活用

サブエージェントとは?Claude Codeでの使い方と、スキルとの違い

公開 約4分で読めます

TL;DRこの記事の要点

  • サブエージェントは、メインのAIから作業を任されて、別のコンテキストで動く担当者のようなもの
  • メインには結果の要約が返るので、長い調べものなどに向いている
  • スキルは手順書で、基本はメインの会話の中で動く
  • 小さい修正や何度も相談する作業は、メインのほうが早い
目次8項目
  1. サブエージェントとは?作業を任せる担当者
  2. どんなときに見かける?
  3. Claude Codeでの使い方
  4. サブエージェントとスキルの違い
  5. 自分はこう使ってます
  6. サブエージェントでハマった例
  7. 迷ったときの確認ポイント
  8. 出典

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千トークンで、執筆だけの量を切り出せず・・・

迷ったときの確認ポイント

  1. 途中の経過はいらなくて、結果だけほしい作業か(ほしいなら向いている)
  2. 必要な情報を、指示の中に全部書けるか(通常のサブエージェントは会話の履歴を見られない)
  3. 同じファイルを、同時に直そうとしていないか(自分は同じCSSなら順番にしてます)
  4. 報告を読んだだけで終わりにしていないか(ファイルや画面で確かめる)

あわせて知っておきたい用語

ハーネス
AIエージェントがちゃんと作業を進められるように、まわりに置くしくみ。
hooks
Claude Codeの決まったタイミングで、自分のスクリプトを動かす機能。
トークン
生成AIが文章を数える単位。サブエージェントの作業でも消費する。

出典

この記事が参考になったら、応援クリックをお願いします

Cat's Handこの記事を書いた人

Web制作歴10年以上。WordPressのテーマカスタマイズやコーディングを中心に、副業・本業ともにweb制作に携わっています。このブログでは、実際に手を動かして分かったことを書いています。