組織のAI活用をAIポータルと伴走支援で加速

Claude Codeのサブエージェントの使い方。使う場面と使わない場面の分け方

Claude Codeのサブエージェントの使い方。使う場面と使わない場面の分け方

執筆:寺田昇平

AI Portalize株式会社 代表取締役/AI Digital Community 代表理事

仕組みとコンサルティング伴走支援の両面で、組織のAI活用の加速を支援。

Claude Codeのサブエージェントは、メインの会話とは別の文脈で調べものや点検をして、結果の要約だけを返すAIの助手です。
作るときは、Claude Codeに役割と保存先を伝えて、「.claude/agents/」にファイルを作ってもらうのが手軽です。

使うのは、大量のファイルやログを読む作業や、書き換えさせずに点検させたい作業です。
何度もやり取りしながら直す作業や、前後の話を共有する作業は、メインの会話のまま進めます。

Claude Codeでサブエージェントに任せる作業(大量のファイルやログを読む、書き換えさせずに点検する、道具や権限を絞りたい、要約を返せば済む)と、メインの会話で進める作業(何度もやり取りしながら直す、計画から試すまで同じ前提を使う、1か所だけ手早く直す、すぐに返事がほしい)を左右に並べた図

ただ、サブエージェントは自分の分のトークンを使うので、増やすほど利用の枠も多く使います。
製品の事実は、2026年11月11日にClaude Codeの公式ドキュメントで確かめた内容です。
公式ドキュメントには、日本語版のページもあります。

Claude Codeのサブエージェントを作るまでの5つの操作

いちばん手軽なのは、作りたいサブエージェントをClaude Codeに文章で説明し、ファイルを作ってもらう方法です。
公式ドキュメントのクイックスタートも、この形で案内しています。

1. 作業するフォルダでClaude Codeを開く
2. 役割・保存先・使ってよい道具・モデルを文章で伝える
3. できたファイルを開き、名前と説明が意図どおりか確かめる
4. 「draft-checkerのサブエージェントで点検して」のように頼んで動かす
5. 見つからないと言われたら、Claude Codeを開き直す

2で伝える文は、例えば「.claude/agents/ に、原稿の表記ゆれを点検するサブエージェントを作って、ファイルは書き換えさせず、Haikuで動かして」のようになります。
開いた時点で保存先のフォルダがなかったときは、開き直すまで新しいサブエージェントが見つかりません。

Claude Codeでサブエージェントを作るまでの5つの操作として、作業するフォルダでClaude Codeを開く、役割・保存先・道具・モデルを文章で伝える、できたファイルの名前と説明を確かめる、名前を書いて頼んで動かす、見つからないときは開き直す、の順番を示した図

以前の版(v2.1.197まで)では、「/agents」と打つと作るための画面が開きました。
今の版の「/agents」は、Claudeに頼むか、フォルダのファイルを直接書くよう案内する表示に変わっています。

サブエージェントのファイルに書く項目

できあがるのは、先頭に設定を書き、その下に役割の説明を書いたMarkdownのファイルです。
先ほどの例なら、次のようなファイルになります。

---
name: draft-checker
description: 原稿の表記ゆれと数字の食い違いを点検する。原稿を書き終えたあとに使う
tools: Read, Grep, Glob
model: haiku
---
あなたは原稿の点検役です。
渡されたファイルを読み、表記ゆれと数字の食い違いを探します。
ファイルは書き換えません。
見つけた所は、ファイル名・行・直し方の案を1行ずつ返します。

必ず書くのは「name」と「description」の2つだけで、ほかは書かなければ初期の設定で動きます。

項目

書く中身

書かないとどうなるか

name

ほかと重ならない名前

書く必要がある

description

どんなときに任せるか

書く必要がある

tools

使ってよい道具

サブエージェントで使える道具をすべて使える

model

haiku・sonnet・opus など

メインの会話と同じモデルで動く

本文

役割と、結果の返し方

何をどう返すかがあいまいになる

descriptionは、Claudeがそのサブエージェントに任せるかどうかを決める材料です。
公式は、「use proactively」のような言葉を入れると、Claudeが進んで任せやすくなるとしています。
また、作ったサブエージェントのdescriptionの合計が15,000トークンを超えると、起動したときに警告が出ます。

本文は、そのサブエージェントへの指示として読まれます。
書き換えさせたくない点検役なら、toolsに「Read」「Grep」「Glob」のような読むための道具だけを書いておきます。
読む道具だけにする方法のほかに、仕組みで止める安全設定を作る手順は、Claude Codeのhooksとは。お願いではなく仕組みで止める安全設定の作り方で説明しています。

サブエージェントのファイルに書く項目として、必ず書くnameとdescription、書かなければ初期の設定で動くtoolsとmodel、指示として読まれる本文を、それぞれの中身と書かないときの動きとともに並べた図

作ったサブエージェントを呼び出す3つの方法

作ったサブエージェントは、Claudeが自分で選んで使うほか、名前を指定して呼び出せます。
公式ドキュメントにある呼び出し方は、次の3つです。

  • 自動:頼んだ内容とdescriptionが合えば、Claudeがそのサブエージェントに任せる

  • 名前を書いて頼む:「draft-checkerのサブエージェントで、この原稿を点検して」のように書く

  • 「@」で指定する:入力欄で「@」に続けてサブエージェントを指定すると、そのサブエージェントが必ず動く

作らなくても使える、組み込みのサブエージェントもあります。
ファイルを探して読むだけの「Explore」、プランモードで下調べをする「Plan」、調べてから手を動かす「General-purpose」などです。
ExploreとPlanは読むための道具だけを使い、CLAUDE.mdを読まずに始まります。
英語の公式ドキュメントでは、この機能を「Subagents」と呼んでいます。

Claude Codeの組み込みのサブエージェントExplore・Plan・General-purposeを、向いている作業、ファイルの書き換え、CLAUDE.mdを読むかの3つの観点で比べた図

Claude Codeのサブエージェントを使う場面と使わない場面

「作業を分けるほど、精度が上がるのでは?」と考える人もいます。
公式ドキュメントには、どちらで進めるかの目安が、作業の様子ごとに載っています。

作業の様子

進める場所

何度もやり取りしながら直す

メインの会話

計画・作る・試すの段階で、同じ前提を使う

メインの会話

1か所だけを手早く直す

メインの会話

すぐに返事がほしい

メインの会話

結果の量が多く、要約だけあればよい

サブエージェント

使う道具や権限を絞りたい

サブエージェント

ほかと切り離せて、要約を返せば済む

サブエージェント

すぐに返事がほしい作業がメインの会話に向くのは、サブエージェントが前提を集めるところから始めるためです。
公式の例では、テストの実行、ドキュメントの取得、ログの処理が、サブエージェントに向く作業として挙げられています。

業務に当てはめると、例えば数十本の原稿から表記ゆれを探す点検や、長いログから誤りの行を拾う作業が近い形です。
一方で、企画書を相談しながら少しずつ直していく作業は、前の話を覚えているメインの会話のほうが向いています。
Claudeを業務で使うときの全体の考え方は、Claudeを業務で使う。Geminiとの使い分けと、組織に入れるときの考え方にまとめています。

サブエージェントの費用と精度の見方

「サブエージェントに分ければ、費用も抑えられるのでは?」という声もあります。
実際には、サブエージェントはメインの会話とは別に、自分でAIへのリクエストを送ります。
公式によると、そのリクエストもメインの会話と同じ利用の上限に数えられます。

つまり、サブエージェントを増やすほど、使うトークンも増えます。
公式は、多くのサブエージェントが詳しい結果を返すと、メインの会話の文脈も大きく使うと注意しています。

費用を抑える方法として、公式は簡単な作業のサブエージェントに「model: haiku」を指定するよう案内しています。
また、Pro・Max・Team・Enterpriseなどのプランなら、「/usage」でサブエージェントが使った割合も確かめられます。

精度の面では、サブエージェントが今までの会話を見ていない点に気をつけます。
公式によると、サブエージェントは新しい文脈で始まり、メインの会話の履歴や、Claudeがすでに読んだファイルを見ていません。
受け取るのは、自分の指示、Claudeが書いた作業の依頼文、CLAUDE.mdなどです。

そのため当社では、条件と返してほしい形を、依頼文にはっきり書くのを目安にしています。
「点検は第2章だけ、見つけた所はファイル名と行で返して」のように書いておくと、メインの会話で確かめ直す手間が減ります。

前の話を知っていてほしい作業には、「フォーク」という形もあります。
フォークは今までの会話をすべて引き継いだサブエージェントで、入力欄で「/subtask」に続けて作業を書くと始められます。
公式は、同じ前提が要る作業なら、フォークのほうが新しいサブエージェントより費用が少ないとしています。

サブエージェントで気をつける所として、増やすほど利用の枠を使うことには簡単な作業をHaikuにする、詳しい結果が多いとメインの文脈も使うことには返す形を短く決める、今までの会話を知らずに始まることには条件を依頼文に書くかフォークを使う、という抑え方を対にした図

チームでサブエージェントを共有するときの決まり

作ったサブエージェントは、置く場所によって使える範囲が変わります。
プロジェクトの「.claude/agents/」に置くとそのプロジェクトで使え、「~/.claude/agents/」に置くと自分のすべてのプロジェクトで使えます。

公式は、プロジェクトのサブエージェントをバージョン管理に入れて、チームで共有するよう案内しています。
同じ名前のサブエージェントが重なったときは、組織の管理設定(managed settings)に置いたものがいちばん優先されます。
チームで共有する設定として、複数の道具で共通に使える指示ファイルの書き方は、AGENTS.mdとは。Claude Code・Codex・Cursorで共通に使える指示ファイルの書き方で整理しています。

社内で配る前に決めておく項目は、当社では次の4つを目安にしています。

サブエージェントをチームで共有する前に決める4つの項目として、置き場所と直す人、書き換えまで許すものと読むだけのものの分け方、使うモデル、descriptionの書き方を並べた図

  • 共有するサブエージェントの置き場所と、直す人

  • 書き換えまで許すものと、読むだけのものの分け方

  • 使うモデル(簡単な作業はHaikuにするか)

  • descriptionの書き方(ほかと役割が重ならないか)

決まった手順を毎回同じように進めさせたいだけなら、別の文脈を使わないスキルのほうが向く場合もあります。
スキルの書き方と配り方は、SKILL.mdとは。Claudeのスキルの書き方と、作ったスキルを社内に配る手順に書いています。

なお、Claude Codeは、無料のプランでは使えません。
公式の案内では、Pro・Max・Ultra・Team・EnterpriseかClaude Consoleのアカウントが要ります。
作業させるフォルダの決め方は、Claude Codeを社内で使い始める。初期設定と安全設計にあります。
CLAUDE.mdと禁止設定の分担は、Claude Codeを非エンジニアに配る。CLAUDE.mdと禁止設定の分担が参考になります。

作ったサブエージェントやスキルが社内で使われないときは、AIツールやプロンプトが、社内で共有されないのページもご覧ください。

業務への当てはめから一緒に考えるAIパーソナルトレーニング

サブエージェントに任せる作業を選ぶ前に、そもそも自社の業務のどこからAIを使うかで迷う方もいます。
私たちのAIパーソナルトレーニングは、経営者・役員・AI担当者の方に向けた、マンツーマンの2時間の場です。

1回だけの利用もでき、事業や業務の内容をうかがったうえで、最初に取り組む領域を助言します。
内容の例には、AIボットを一緒に作る時間や、Claude Coworkなどを使ったブラウザ操作とAIワークフロー化の体験があります。
始める前に今の課題をうかがい、そのうえで進め方のプランをご提案します。

Claude Codeのサブエージェントは、分ける理由がある作業にだけ使う

Claude Codeのサブエージェントは、役割と保存先を伝えてClaude Codeにファイルを作ってもらう形が、いちばん始めやすい作り方です。
結果の量が多い作業や読むだけの点検に絞って使い、やり取りの多い作業はメインの会話で進めます。

参照した情報(2026年11月11日に確認)

すぐ使える業務アプリが300以上

開いてそのまま使えて、AIで自社用にも直せます。15の分野から、やりたい作業で探せます。業務アプリを見る

執筆:寺田昇平

AI Portalize株式会社 代表取締役/AI Digital Community 代表理事

仕組みとコンサルティング伴走支援の両面で、組織のAI活用の加速を支援。

keyboard_backspace

お知らせ・組織AI推進ノウハウ一覧

無料 自社に当てはめて知りたい方へ

読んだ内容を、

御社の数字

で確かめませんか。

利用データから、御社のAI活用がいまどこにいるのかを判定します。
同業他社との比較と、次にやることをお渡しします。

組織のAI活用力診断のメインビジュアル(ノートPCの利用データと結果表)

Related

関連記事

Service

サービス一覧

AI Portalizeの管理画面イメージ:AI活用数・効率化時間の見える化とチームへの広がり

AIツールが見つかる。社内に広がる。使われ方が見える。

組織のAIポータル「AI Portalize」

  • check_circle

    やりたいことで検索すると、業務アプリ300以上とナレッジ250本以上から見つかる

    check_circle

    社内で作ったツールやナレッジが共有され、よく使われるものが上に並ぶ

    check_circle

    誰が何をどれだけ使っているかが、集計の手間なしで分かる

デジタル系企業特化のAIコンサルティング&伴走支援のイメージイラスト

実務に組み込むまで伴走

組織のAI活用を加速「AIコンサル&伴走支援」

  • check_circle

    従業員が安心して使うためのガイドライン策定

    check_circle

    ドメイン知識が豊富なコンサルタント

    check_circle

    業務分解からAIワークフロー作成

    check_circle

    研修から実務への組み込みまで

法人向けAI研修のイメージ:受講者が自分の業務でAIを使いながら学ぶ研修の様子

自社の業務で、使える知識に

実務で使える知識を「法人向けAI研修」

  • check_circle

    いま使っているAIと受講者の業務を伺って、誰に・どのAIで・どの業務を題材にするかを提案

    check_circle

    Gemini・Claude・AIエージェントなど、8つの研修例と230以上のテーマ例

    check_circle

    基本はオンライン。研修の資料と録画もお渡し

デジタル系企業特化のAIコンサルティング&伴走支援のイメージイラスト

豊富な新規事業立ち上げ実績

AIを活用した
新規事業の立ち上げ支援

  • check_circle

    検討からサービス構築まで

    check_circle

    豊富な新規事業構築実績

    check_circle

    すでにあるAIボットなどを活用も可能

AI活用支援のビフォーアフター:迷っている状態からGemini等を使いこなす状態への変化

経営者・役員・AI担当向け

AIパーソナル
トレーニング

  • check_circle

    まだAI活用できていない状態でも大丈夫

    check_circle

    1回2時間のみからご利用いただけます

    check_circle

    実務で使える「今のAI活用」を学ぶ

    check_circle

    トップ層こそAIに詳しく

AIガイドライン作成+定着研修の紹介バナー:御社に合ったルールづくりから社内への定着まで

生成AIの社内ルールを一緒に作る

AIガイドライン作成+
定着研修

  • check_circle

    御社の現状をヒアリングしながら一緒に作成

    check_circle

    AIツールごとの仕組みや契約の違いを踏まえて線を引く

    check_circle

    従業員の方への定着研修までご支援

AIガイドライン作成+定着研修の紹介バナー:御社に合ったルールづくりから社内への定着まで

AIの答えに、自社の名前を

LLMO・GEO・AIO
対策

  • check_circle

    御社の現状をヒアリングしながら一緒に作成

    check_circle

    AIツールごとの仕組みや契約の違いを踏まえて線を引く

    check_circle

    従業員の方への定着研修までご支援

まずは、いまのAI活用の
状況をお聞かせください。

何から始めるか決まっていなくても、ご相談いただけます。

無料相談・お問い合わせ