サブエージェントの定義
# .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 |
まずは無料で試す
新規アカウントには $5分の無料APIクレジット を、コード CLAUDECODE で提供します。SonnetでClaude Codeを一晩試すのに十分な額です。その後は額面の7.69231倍のクレジットを利用できます。
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_keyよくある質問
Claude Codeのサブエージェントとは何ですか？
.claude/agents/内のMarkdownファイルで定義される独立したエージェントです。独自のシステムプロンプト、ツール権限、モデル選択、コンテキストウィンドウを持ち、メインセッションからタスクを委任されます。
Claude Codeのサブエージェントのドキュメントはどこにありますか？
公式リファレンスは、AnthropicのClaude Codeドキュメントの「サブエージェント」にあります。このページはその実践版で、ファイル形式、委任が行われるタイミング、コストを説明します。
サブエージェントには追加料金がかかりますか？
他のリクエストと同様に、それぞれのトークンが課金されます。大量の読み込みを親のコンテキストから除外することで、長いセッションではコストを節約できます。一方、Opusで多数を並列実行すると、コストは増えます。
エージェントチームとは何ですか？
単一の親と短命な補助エージェントという構成に代わり、複数のClaude Codeセッションが、メッセージと共有タスクリストを使って名前付きのチームメイトとして連携する実験的な拡張機能です。
ゲートウェイでClaude Codeを実行
同じモデルを環境変数の設定だけで利用できます。額面の7.69231倍のクレジット、または定額無制限プランを選べます。 新規アカウント：コードCLAUDECODEで$5分の無料APIクレジット。
APIキーを取得 無制限プランを見るAI Prime Techは独立したAPIゲートウェイであり、Anthropicとの提携関係はなく、同社の推奨や支援も受けていません。「Claude」と「Claude Code」はAnthropicの商標です。ここで説明するClaude Codeの機能は、執筆時点のAnthropicの公開ドキュメントに基づいており、頻繁に変更されます。このページの料金とモデル一覧は、このゲートウェイの現在の設定から取得しています。