Source: https://aiprimetech.io/ja/claude-code/subagents/

[ホーム](/ja/) › [Claude Code](/ja/claude-code/) › サブエージェント

[概要](/ja/claude-code/)[インストール](/ja/claude-code/install/)[CLIリファレンス](/ja/claude-code/cli/)[料金と制限](/ja/claude-code/pricing/)[Agent SDK](/ja/claude-code/sdk/)[スキルとプラグイン](/ja/claude-code/skills/)[GitHub](/ja/claude-code/github/)[ウェブ、デスクトップ、IDE](/ja/claude-code/web-and-desktop/)[モデル](/ja/claude-code/models/)[エラー](/ja/claude-code/errors/)[オープンソース？](/ja/claude-code/open-source/)[チュートリアル](/ja/claude-code/tutorial/)[学生向け](/ja/claude-code/for-students/)[QA自動化](/ja/claude-code/qa-automation/)[Cursorとの比較](/ja/claude-code/vs-cursor/)[Codex・OpenCodeとの比較](/ja/claude-code/vs-codex/)[サブエージェント](/ja/claude-code/subagents/)[フック](/ja/claude-code/hooks/)[MCP](/ja/claude-code/mcp/)[エコシステム](/ja/claude-code/ecosystem/)[VS Code](/ja/claude-code/vscode/)[OpenRouter](/ja/claude-code/openrouter/)[レート制限](/ja/claude-code/rate-limits/)[中国語ガイド](/claude-code/zh/)

最終更新：2026年10月11日

# Claude Codeのサブエージェント：仕組み、定義方法、エージェントチーム

サブエージェントは、独自のシステムプロンプト、独自のツール権限、そして特に重要な独自のコンテキストウィンドウを持つ、別のClaude Codeワーカーです。メインセッションはタスクを委任して要約を受け取り、コンテキストを整理された状態に保ちます。うまく使えば、サブエージェントの有無が、一時間で品質が低下するセッションと、一日中稼働できるセッションの違いになります。

## TLDR
- 次の場所にMarkdownファイルとして定義します .claude/agents/ （プロジェクト用）または ~/.claude/agents/ （ユーザー用）：フロントマターにname、description、tools、modelを記述し、本文をシステムプロンプトにします。
- 説明がタスクに一致するとClaudeが自動的に委任します。エージェント名を指定して明示的に委任することもできます。
- 各サブエージェントは独自のコンテキストを持ち、それぞれのトークン使用量が課金されます。結果は要約されて返されます。
- /agents で作成と管理ができます。エージェントチームは、この考え方をセッション間の連携へと拡張します。

## サブエージェントの定義 

```
# .claude/agents/code-reviewer.md
---
name: code-reviewer
description: Reviews a diff for correctness, security and test coverage. Use after any non-trivial change.
tools: Read, Grep, Glob, Bash(git diff *)
model: sonnet
---
You are a senior reviewer. Read the staged diff, list concrete defects with file:line,
flag untested paths, and stop. Do not edit files.
```

name は、呼び出すときに使う名前です。 description は、Claudeが自律的に呼び出すかどうかを判断するために使います。そのため、役職名ではなく、振り分けルール（「軽微ではない変更の後に使用する」など）として記述してください。 tools は、実行できる操作を制限します。編集できないレビュアーのほうが安全です。 model は、モデルのティアを固定します。 haiku は調査や分類に、 sonnet は大半の作業に、 opus は難しい工程に使います。または inherit で親セッションに従います。 

## プロジェクトエージェントとユーザーエージェント 

次の場所にあるファイルは .claude/agents/ リポジトリに属し、リポジトリとともに共有されます。コミットすれば、チーム全員が同じレビュアー、テスト作成エージェント、移行エージェントを利用できます。次の場所にあるファイルは ~/.claude/agents/ すべてのプロジェクトで使える個人用です。名前が重複した場合は、プロジェクトエージェントが優先されます。 /agents をセッション内で使うと、ファイルを手動で操作せずに、どちらの種類も一覧表示、作成、編集できます。 

## Claudeが委任するタイミング 

方法は二通りあります。暗黙的な委任では、メインエージェントがすべてのサブエージェントの説明を読み、タスクが一致すると委任します。説明に使用する条件が書かれていれば、「これにcode-reviewerサブエージェントを実行して」と指示する必要はありません。明示的な委任では、プロンプト内で名前を指定します。いずれの場合も、サブエージェントは独自のコンテキストで実行され、渡された情報と自分で読み取った情報だけを参照し、結果を返します。メインセッションはその結果を要約して自身の履歴に取り込みます。サブエージェントが別のサブエージェントを起動することはなく、階層は一段だけです。 

## セッションのコストを抑えられる理由 

Claude Codeでは、ターンごとに会話全体が再送されます。サブエージェントが四十個のファイルを読む場合、その読み込みは独自のコンテキストウィンドウ内で行われ、親には一段落の要約が渡されます。サブエージェントを使わなければ、その四十個のファイルはセッションの残りの間ずっとメインのコンテキストに残り、毎ターン再送されます。そのため、大規模なコードベースでは、Haikuのサブエージェントで調査し、Sonnetのサブエージェントでレビューし、親のコンテキストは意思決定のために確保する、という使い方が適しています。各サブエージェントのトークンは個別に課金されます。無料になるのではなく、コンテキストが分離されるのです。 

## 並列実行とレート制限 

複数のサブエージェントを同時に実行でき、それぞれが並列のストリーミングリクエストになります。これは、どのエンドポイントでも同時リクエスト数の上限に最も早く達する使い方です。そのため、新しいゲートウェイアカウントでは二つか三つの並列実行から始め、実際のワークロードが固まってから同時実行数の引き上げを依頼してください。そうしない場合に発生する429については、エラーガイドで説明しています。 

## エージェントチーム 

新しいClaude Codeのビルドには、エージェントチームが追加されています。単一の親が短命なサブエージェントに委任する代わりに、複数のセッションが名前付きのチームメイトとして、共有タスクリストと相互のメッセージを使って連携します。これにより、リーダーは作業を割り振り、状況を確認し、チームメイトを停止できます。これは設定で有効にする実験的な機能で、リリースごとに変わります。現在のフラグはブログ記事ではなく、次の資料を確認してください： claude --help および変更履歴。基本的な考え方は、サブエージェントに持続性と通信を加えたものです。コストの仕組みも同じで、チームメイトの数に応じて増えます。 

## ゲートウェイでの利用 

サブエージェントとチームは、親セッションと同じエンドポイントとキーを使うため、次の設定が ANTHROPIC_BASE_URL=https://aiprimetech.io そのすべてに適用されます。定額の無制限プランでは、並列実行は課金ではなくフェアユースの問題になります。そのため、マルチエージェントを多用するユーザーは、そのようなプランに落ち着く傾向があります。 

 | 計画 | 期間 | 料金

 | 1時間使い放題 | 1時間 | $1

 | 24時間使い放題 | 24時間 | $10

 | 1週間使い放題 | 1週間 | $49

 | 15日間使い放題 | 15日間 | $89

[すべての使い放題プラン →](/ja/plans/)

## まずは無料で試す

新規アカウントには $5分の無料APIクレジット を、コード CLAUDECODE で提供します。SonnetでClaude Codeを一晩試すのに十分な額です。その後は額面の7.69231倍のクレジットを利用できます。

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[コードCLAUDECODEでアカウントを作成](/register?promo=CLAUDECODE)

## よくある質問

Claude Codeのサブエージェントとは何ですか？

.claude/agents/内のMarkdownファイルで定義される独立したエージェントです。独自のシステムプロンプト、ツール権限、モデル選択、コンテキストウィンドウを持ち、メインセッションからタスクを委任されます。Claude Codeのサブエージェントのドキュメントはどこにありますか？

公式リファレンスは、AnthropicのClaude Codeドキュメントの「サブエージェント」にあります。このページはその実践版で、ファイル形式、委任が行われるタイミング、コストを説明します。サブエージェントには追加料金がかかりますか？

他のリクエストと同様に、それぞれのトークンが課金されます。大量の読み込みを親のコンテキストから除外することで、長いセッションではコストを節約できます。一方、Opusで多数を並列実行すると、コストは増えます。エージェントチームとは何ですか？

単一の親と短命な補助エージェントという構成に代わり、複数のClaude Codeセッションが、メッセージと共有タスクリストを使って名前付きのチームメイトとして連携する実験的な拡張機能です。

## ゲートウェイでClaude Codeを実行

同じモデルを環境変数の設定だけで利用できます。額面の7.69231倍のクレジット、または定額無制限プランを選べます。 新規アカウント：コードCLAUDECODEで$5分の無料APIクレジット。[APIキーを取得](/register?promo=CLAUDECODE) [無制限プランを見る](/ja/plans/)

AI Prime Techは独立したAPIゲートウェイであり、Anthropicとの提携関係はなく、同社の推奨や支援も受けていません。「Claude」と「Claude Code」はAnthropicの商標です。ここで説明するClaude Codeの機能は、執筆時点のAnthropicの公開ドキュメントに基づいており、頻繁に変更されます。このページの料金とモデル一覧は、このゲートウェイの現在の設定から取得しています。

## その他のClaude Codeガイド

[Claude Code：完全ガイド](/ja/claude-code/)[Claude Codeのインストール方法](/ja/claude-code/install/)[Claude Code CLIドキュメント：コマンドとフラグ](/ja/claude-code/cli/)[Claude Codeの料金と制限を解説](/ja/claude-code/pricing/)[Claude Code SDKからClaude Agent SDKへ](/ja/claude-code/sdk/)[Claude Codeのスキルとプラグイン](/ja/claude-code/skills/)[GitHubでのClaude Code：App、Action、@claude](/ja/claude-code/github/)[Claude Codeにウェブインターフェースはある？ウェブ、デスクトップ、IDEを解説](/ja/claude-code/web-and-desktop/)[Claude Codeが使用するモデルと変更方法](/ja/claude-code/models/)[Claude Codeのエラーと修正方法](/ja/claude-code/errors/)[Claude Codeはオープンソースですか？](/ja/claude-code/open-source/)[Claude Codeチュートリアル：初めての実践セッション](/ja/claude-code/tutorial/)[学生向けClaude：Claude Code、API、教育向け提供で実際に得られるもの](/ja/claude-code/for-students/)[QA自動化にClaude Codeを使う方法](/ja/claude-code/qa-automation/)[Claude CodeとCursorの比較：どちらをいつ使うか、そして両方を併用する方法](/ja/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode：ターミナルエージェントの比較](/ja/claude-code/vs-codex/)[Claude Codeのフック：エージェントの動作を決定論的に制御する](/ja/claude-code/hooks/)[Claude CodeのMCP：サーバー接続、スコープ、リモートMCPと実例](/ja/claude-code/mcp/)[Claude Codeのエコシステム：ルーター、フレームワーク、プラグインと、それらをまとめたリスト](/ja/claude-code/ecosystem/)[VS Codeで使うClaude Code：拡張機能、ターミナル経由の利用、エラー](/ja/claude-code/vscode/)[Claude CodeでOpenRouterを使う方法（使わないほうがよい場合も）](/ja/claude-code/openrouter/)[Claudeのレート制限エラー：「API error: rate limit reached」の意味と解決方法](/ja/claude-code/rate-limits/)[Claude Codeの使い方：インストールから日常的な利用まで](/claude-code/zh/)