Claude Codeのsubagents入門。初心者が今日1体作って動かす最短ガイド

Claude起動直後に/grill-meを使うと何が変わる？仕組み・使い方・実感を整理

Claude Codeのagent機能とは？いままでとの違いと簡単な使い方

Q: `/agent` と `/agents` はどちらですか？

2026年4月4日時点で確認した Anthropicの slash commands ドキュメント では /agents です。

Claude Codeの agent機能 が気になっても、最初は何が変わるのか分かりにくいです。

特に混ざりやすいのが、次の2つです。

いつもの会話としてClaudeを使うこと
agentやsubagentsを使って役割分担すること

ここがあいまいだと、便利そうでも手が止まります。

この記事では、Claude Codeのagent機能が何か、いままでの使い方と何が違うのか、/agents をどう使えばよいのかを初心者向けに整理します。

Claude Codeのagent機能を一言でいうと

Claude Codeのagent機能は、1つの会話で全部やる のではなく、役割ごとに仕事を切り分けて進めやすくする仕組み です。

Anthropicの subagents ドキュメントでは、subagents は特定の仕事向けの専用アシスタントとして案内されています。
つまり、Claude Codeのagent機能は、Claudeの中に小さな担当者を作って使い分ける考え方です。

これが、いままでとの大きな違いです。

いままでとの違い

いままで多かったのは、1本の会話の中で全部を進める使い方です。

たとえば、

仕様を相談する
実装を頼む
エラー調査も頼む
最後にレビューも頼む

という流れです。

この方法でも進みます。
ただ、話題が増えるほど、会話が散らかりやすいです。

agent機能を使うと、この形が変わります。

項目	1本の会話で進める使い方	agent機能
進め方	1つの流れに全部入れる	役割ごとに分ける
得意なこと	軽い相談、単発作業	少し複雑な作業の整理
問題になりやすい点	話が混ざる	役割設計が必要
向いている場面	小さい依頼	調査、レビュー、切り分け

要するに、何でも1人で抱える から、担当を分けて進める に変わるわけです。

`/agent` ではなく `/agents`

ここは一度はっきりしておいた方がよいです。

Anthropicの slash commands ドキュメントでは、管理コマンドは /agents と案内されています。
つまり、2026年4月4日時点で確認できる公式表記は /agents です。

この画面から、既存のsubagentを見たり、新しく作ったりできます。

/agents

最初は、ここがagent機能の入口だと覚えれば十分です。

subagentsとは何か

subagentsは、役割を絞った小さな担当です。

たとえば、

debugger
reviewer
test-runner

のように分けられます。

Anthropicの説明では、subagentsはそれぞれ独立した文脈で動きます。
そのため、メインの会話を汚しにくいのが利点です。

ここが初心者にとって大きいです。
全部を同じ会話で進めるより、役割がぶれにくくなります。

なぜagent機能が便利なのか

便利さは単純です。
1つの会話に全部を押し込まなくてよくなる からです。

1本の流れで何でも頼むと、途中で次のようなことが起きやすいです。

何を今やっているのか分かりにくくなる
調査と修正とレビューが混ざる
後で読み返したときに追いにくい

agent機能を使うと、こう整理しやすくなります。

メインの会話で目的を決める
subagentに狭い役割だけを任せる
結果を戻して最後は自分で判断する

大事なのは、全部丸投げする機能 と考えないことです。
むしろ、作業を整理する機能 と見た方が使いやすいです。

最初の1体はdebuggerがわかりやすい

最初に作るなら、debugger のような原因調査役が使いやすいです。

理由は3つです。

役割が狭い
成功したか判断しやすい
実装担当よりぶれにくい

たとえば、こんな役割です。

名前: debugger

説明:
エラーの原因調査を優先して行う担当

指示:
エラー内容、再現条件、関連ファイルを見て原因候補を切り分ける。
いきなり大きく直しすぎず、まず原因と最小修正案を示す。
不明点があるときは、次に見るべき場所を短く整理する。

このくらいなら、初心者でも使いどころがすぐ分かります。

簡単な使い方

最初は次の流れで十分です。

1. Claude Codeを開く

claude

2. `/agents` を開く

/agents

3. 新しいagentを作る

ここで project-level と user-level を選びます。

種類	使える範囲	向いている場面
project-level	今のプロジェクトだけ	案件ごとに試したいとき
user-level	自分の全プロジェクト	いつも同じ担当を使いたいとき

初心者なら、まず project-level で十分です。

4. 名前と役割を書く

ここで大事なのは、1 agent 1役割 にすることです。

悪い例:

何でもやる万能agent
実装もレビューも調査も全部担当

良い例:

debugger
reviewer
test-runner

5. 小さい依頼で試す

最初から大仕事を振らない方がよいです。

たとえば、こうです。

このエラーの原因を切り分けて。debuggerを使って

または、

最近の変更でどこが怪しいか、debuggerで見て

まずは 原因を整理する くらいの小ささがちょうどよいです。

初心者が混乱しやすいポイント

agent機能とsubagentを同じ意味で考えてしまう

初心者の感覚では同じに見えやすいです。
でも実際には、agent機能は全体の考え方で、subagents はその中で作る個別の担当です。

役割を広げすぎる

何でもやる担当にすると、結局もとの会話の混乱が戻ります。

最後の判断まで任せてしまう

結果の確認と採用判断は、最後に自分へ戻した方が安全です。

まずはこの理解で十分

Claude Codeのagent機能は、Claudeを賢くする魔法の新機能 というより、役割分担して作業を整理しやすくする仕組み です。

最初はこれだけつかめば十分です。

入口は /agents
最初は1体でよい
役割は狭くする
最後は自分で確認する

これだけ守ると、かなり使いやすくなります。

FAQ

`/agent` と `/agents` はどちらですか？

2026年4月4日時点で確認した Anthropicの slash commands ドキュメントでは /agents です。

subagentsを作らないとClaude Codeは使えませんか？

使えます。subagents は必須ではありません。ただし、作業が少し複雑になるほど、役割分担の価値が出ます。

最初から3体か4体作った方がよいですか？

おすすめしません。まず1体だけ作って、使いどころが見えてから増やした方が失敗しにくいです。