【Claude Codeサブエージェント入門 第10回】費用を測って小さく使う ― 担当も同じ使用量の枠、/usageの内訳、小さく使う工夫、連載の早見表

Claude Codeサブエージェント入門 第10回 費用を測って小さく使う 生成AI

「担当に任せれば、本体の負担が減ると聞いたのに、使用量の枠がいつもより早く減ります」
「/usage を開いても、担当がどれだけ使ったのか、どこを見ればよいのか分かりません」

サブエージェント(担当)は、本体の会話のコンテキストを守ってくれます。しかし、担当に任せても、使う量が消えるわけではありません。担当は自分でリクエストを送り、それは本体と同じ使用量の枠に数えられます。安いモデルに回すのは費用を抑える手段の1つですが、担当を増やせば合計は増えます。

第10回では、担当も同じ枠を使うこと、API の定価、筆者の例(資料1つで約67ドル相当)、/usage の内訳の見方、小さく使う7つの工夫を扱い、最後に連載の早見表をまとめます。冒頭の2つの相談は、1つ目が「担当も同じ枠を使う」の節、2つ目が「/usage の内訳の見方」の節の答えです。画面は Claude デスクトップアプリの Code タブを前提に書き、CLI の操作は「CLI では」と添えます。数値と仕様は2026年10月時点です。


担当も同じ使用量の枠を使う

公式の文書は、担当の要求も使用量に数えられると書いています。

  • 公式の費用の文書(costs):「The subagent’s own requests still draw on your usage.」(担当の要求も、あなたの使用量から引かれる)
  • 担当に任せる利点は、テストの実行・ドキュメントの取得・ログの処理のような量の多い出力を担当のコンテキストの中に閉じ込め、要約だけを本体に戻せること。使用量が消えるのではなく、本体のコンテキストが守られる

整理すると、次の3点です。

  • 担当の要求も、本体と同じ使用量の枠に数える。並行で多く走らせれば、それぞれが使い、結果は本体のコンテキストにも戻る
  • 担当は本体とは別のキャッシュで動く。担当は本体とは別の会話なので、最初のリクエストは本体のプロンプトキャッシュを読まず、自分の分を温める(公式のプロンプトキャッシュの文書。担当のキャッシュの有効期限は、サブスクリプションでも既定で5分と書かれています)。本体のキャッシュには影響しない
  • 安いモデルに回しても、増やせば合計は増える。担当を増やしたり、返す量を決めずに任せたりすれば、費用も増える

個人の Pro・Max では、使用量は金額ではなく、5時間ごと・週ごとの枠で数えられます。公式のサポートの記事は、この枠がClaude と Claude Code で共有され、どちらの利用も同じ枠から引かれると説明しています(出典:https://support.claude.com/en/articles/11145838 )。枠の仕組みは、連載「Claude活用入門」第1回の「使用量の上限」、第3回の「使用量の上限と費用の考え方」、連載「Claude Code実践入門」第1回の「使用量の確認とコスト」を参照してください。

API の定価

API の従量課金で使う場合は、モデルの単価が効きます。2026年11月時点の定価(100万トークンあたり)は次のとおりです。

モデル入力出力
Haiku 5.5$0.10(プロンプトが10万トークン以下のとき)$0.50
Sonnet 5.5$2$10
Opus 5.5$4$20
  • Haiku 5.5 は、プロンプトが10万トークンを超えるリクエストでは、入力 $0.50・出力 $2.50 になります。超えたリクエスト全体がこの単価です(連載「Claude Code実践入門」第1回の「使用量の確認とコスト」にある表と同じ値)
  • 10万トークン以下の Haiku 5.5 は、入力・出力とも、Opus 5.5 の40分の1、Sonnet 5.5 の20分の1の単価です(上の表から計算した比)
  • 組織が modelPricing を設定している場合(Team・Enterprise の補足)は、/usage などの金額がその単価で計算されます。後の「/usage の内訳の見方」を参照

出典:https://platform.claude.com/docs/en/about-claude/pricing

Pro・Max は、この単価ではなく枠で数えます。単価は、「同じ作業をどのモデルに回すと、枠の減り方が変わりやすいか」の見当をつける目安として使います。


筆者の例:資料1つで約67ドル相当

次の数字は、筆者の例(API の定価で換算した値)で、公式の数値ではありません。

  • スライド150枚の資料1つを、担当に分担させて作った例では、API の定価で換算して約67ドルだった(内訳の記録は残っていない)
  • この連載の元になった資料(58枚)づくりは約23ドル(担当11人の分を含む、API の定価で換算)
1デッキの費用を示した図。縦の灰色の棒が1本あり、上に「約67ドル」、下に「スライド資料1つ(150枚)」と「API の定価で換算(筆者の例)」とある。棒の右には、棒を描かずに文字だけを入れた破線の枠があり、「この連載の元の資料(58枚)づくり:約23ドル」と書かれている。最下行の帯に「筆者の例(API の定価で換算)。公式の数値ではない。Pro・Max は枠から引かれる」とある。

この数字は、大きさの目安として読んでください。Pro・Max では、この金額が請求されるのではなく、5時間・週の枠から引かれます。枠の中で使っている限り、ドルで請求されるわけではありません(枠を超えて使う追加の使用量〔usage credits〕を有効にしている場合は別です。連載「Claude活用入門」第3回の「使用量の上限と費用の考え方」を参照)。

  • 担当の数と、返す量を決めずに増やせば、費用も増える
  • 担当を多く使う作業は、枠の使い方を決めてから始める

組織のプラン(Team・Enterprise)の補足:公式の費用の文書は、席ごとの枠が5時間の窓と1週間の窓で数えられ、枠の中の使用量はドルでは計らない、と書いています(usage credits を有効にした分の支出は、管理画面の分析で見られます)。


/usage の内訳の見方

2つ目の相談の答えです。/usage は、Pro・Max・Ultra・Team・Enterprise のプランでは、プランの枠に何が数えられているかの内訳も出します(公式の費用の文書の「Plan usage breakdown」)。

/usage の内訳の見方を示した図。上の濃い箱「/usage」から、「Pro・Max・Team・Enterprise のプランで内訳が出る」という添え書きとともに、2×2の4つのカードへ矢印が伸びる。緑「Attribution」は、スキル・担当・プラグインごとの割合。担当がどれだけ使ったかが分かる。オレンジ「Behavior flags」は、長いコンテキストやキャッシュの外れが、直近の使用量の10%以上を占めると印が付く。青「端末ごとの概算」は、この端末のセッション履歴から計算した概算。ほかの端末や claude.ai の分は入らない。灰色「セッションの費用」は、定価で計算した推定。請求の額ではない。最下行に「担当も本体と同じ使用量の枠を使うので、担当がどれだけ使ったかを内訳で見る」とある。
  • Attribution(内訳):直近の使用量が、スキル・担当・プラグイン・個々の MCP サーバーのどれに当たるかを、全体に対する割合で出す。担当がどれだけ使ったかが分かる
  • Recommendations(改善の勧め):改善の案が1行に1つ並び、各行の先頭に、その行が当てはまる直近の使用量の割合(10%以上)が出る(例:25% Trim ~/code/api/CLAUDE.md · 49k tokens per request)。割合は節約できる量ではなく、1つの要求が複数の行に数えられるので、合計が100%を超えることもある。長いコンテキストやキャッシュの外れなどの動きが対象。画面の下に f to fix 2 of 3 のような案内が出たら、f で Claude Code が対応できる勧めを実行する(v2.1.305 以降。Claude は変更する前に、その中身を1つずつ見せる)
  • Loops(定期タスク):直近に動いた /loop などのセッションの中の定期タスクのうち、使用量の多いものが1行ずつ並ぶ。動く間隔・回数・合計と1回あたりのトークン・最後に動いた時刻が出る(v2.1.242 以降)。内訳は d・w で直近24時間と7日間を切り替えられる
  • 端末ごとの概算:この端末のセッション履歴から計算した概算で、ほかの端末や claude.ai の分は入らない
  • セッションの費用:トークン数から定価で計算した推定で、請求の額ではない。組織が modelPricing を設定していれば、その単価で計算する(v2.1.242 以降)
  • Code タブでは:筆者の Code タブでも /usage は使えました(2026年10月18日に確認)。担当ごとの内訳が CLI と同じに出るかは、確かめていません。公式の desktop のページに、Code タブの /usage の記述は見つかっていません
  • モデル選択の隣のリング:公式の desktop のページは、このリング(英語の名前は usage ring)で、現在のコンテキストの使用量と、その期間のプランの使用量が見える、と書いています。コンテキストの使用量はセッションごとで、プランの使用量は Claude Code のすべての画面で共有されます。日本語の画面での名前は、筆者は確かめていません

出典:https://code.claude.com/docs/ja/costs 、https://code.claude.com/docs/ja/desktop 。定価とキャッシュは https://platform.claude.com/docs/en/about-claude/pricing と https://code.claude.com/docs/ja/prompt-caching 。

演習の後編(第13回)の手順7で、演習の前後の使用量を測ります。筆者が試した claude -p(非対話)には /usage が無いので、費用は -p が返す total_cost_usd(API の定価で換算した値)で見ました。


小さく使う工夫

担当の費用を抑える工夫を、公式の文書に書かれているものと、筆者の工夫に分けて並べます。

公式の文書に書かれているもの

  • 任せるのは、中間作業が要らないときだけ。調べもののように、途中の経過が要らず、結果の要約だけで足りる作業に限る(第2回の「使う・使わないの判断ルール」。問いの言い方は Academy のレッスン4。公式の費用の文書も、量の多い出力の作業を担当に任せるよう勧めています)
  • モデルは役割で下げる(第6回の「公式の推奨と筆者の例」)。公式は、担当の利点に「Control costs by routing tasks to faster, lower-cost models like Haiku」(Haiku のような速く安いモデルに仕事を回して費用を抑える)を挙げています。全担当を1つのモデルにしたいときは、環境変数 CLAUDE_CODE_SUBAGENT_MODEL と CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1 を使います(v2.1.257 以降)。このとき定義の model は無視され、Claude が起動時にモデルを渡すこともできません。設定ファイルの env には次のように書きます(公式の例)。フォーク(今の会話を引き継ぐ担当)や、model: inherit のスキルの担当は、本体のモデルのままです
  • 返す形で止まりどころを作る(第4回の「返す形と、障害の報告」)。maxTurns で担当の動く回数の上限を決められ、上限で止まると、部分的な結果として返ります(v2.1.246 以降)。Claude はその担当を再開して続けさせることもできます
  • description は短く:全担当の description は本体のコンテキストに入ります。組み込み以外の担当の description の合計が15,000トークンを超えると、起動時に警告が出ます(担当は読み込まれます)。詳しい中身は、担当の本文(システムプロンプト)に移します
{
  "env": {
    "CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
    "CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1"
  }
}

設定が効いたかは、担当が動いている間に /tasks を打つと、担当の行にモデルが出るので確かめられます(v2.1.242 以降)。出典:https://code.claude.com/docs/ja/sub-agents

筆者の工夫(公式の数値ではありません)

  • 報告は短く、詳しい中身はファイルへ。次の担当にはファイルのパスで渡す(第7回の「スキルに「誰に頼むか」を書く」)
  • 原文は最初に1回だけ保存し、担当はまずそれを読む。同じページを取り直さない
  • 続けて頼むのは2回まで。3回目は、要点をファイルにして、新しい担当に頼む(続けて頼むほど、担当の会話が積み重なって重くなるため)

「2回まで」などの数は、筆者の資料づくりでの目安です。公式の数値ではありません。


連載の早見表

第1〜10回の要点を、表にまとめます。

テーマ押さえること
サブエージェントとは別のコンテキストで動く担当。要約が本体に戻る。中間作業が要らないときだけ任せる
定義の書き方.claude/agents/<名前>.md。name・description・tools・model・effort、本文が担当のシステムプロンプト。返す形に障害の欄
モデルの決まり方呼び出し時の指定 → 定義の model → 環境変数 → 本体。別名(haiku など)は版で指す先が変わり、完全なモデル名は版を固定する(公式はどちらかを勧めていない)。この連載のひな形(3役)は別名で書く
スキルから呼ぶskills: で担当に読ませる。context: fork でスキルを担当に動かす。確実に使うなら名前か @ で指定
筆者の例と3役調べる=haiku、作る=sonnet、確かめる=sonnet・high。判断は本体と人。本実行と prod は人(公式の推奨ではなく筆者の例)
費用担当も同じ使用量の枠。筆者の例は資料1つで約67ドル(API の定価で換算)。/usage で内訳を見る

考えてみよう

  1. 自分の最近の作業のうち、担当に任せて使用量が増えたと思うものはどれでしょうか。それは、中間作業が要らない作業でしたか。
  2. 担当を3つ作り、並行で走らせると、使用量はどうなるでしょうか。冒頭の1つ目の相談に、この回の言葉で答えてください。
  3. CLAUDE_CODE_SUBAGENT_MODEL だけを設定したとき、定義に model: sonnet と書いた担当は、どのモデルで動くでしょうか。CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1 も設定したときは、どう変わるでしょうか。

ヒント:1つ目と2つ目は「担当も同じ使用量の枠を使う」の節、3つ目は「小さく使う工夫」の節と、第5回の「モデルの決まる順番」を見直してください。


まとめ

  • 担当の要求も、本体と同じ使用量の枠に数えられる。Pro・Max の枠は、Claude と Claude Code で共有する。担当は本体と別のキャッシュで動く
  • API の定価は、Haiku 5.5 が $0.10/$0.50(プロンプトが10万トークン以下のとき)、Sonnet 5.5 が $2/$10、Opus 5.5 が $4/$20。Pro・Max は単価ではなく枠で数える
  • 筆者の例は、資料1つ(150枚)で約67ドル相当(API の定価で換算。公式の数値ではない)。担当を多く使う作業は、枠の使い方を決めてから始める
  • /usage の Attribution で、担当の使った割合が分かる。Recommendations は直近の使用量の10%以上に当たる改善の案を出す。端末ごとの概算で、ほかの端末と claude.ai の分は入らない
  • 小さく使う工夫は、中間作業が要らないときだけ任せる・役割でモデルを下げる・返す形で止まりどころを作る・報告は短くファイルへ・description は短く
  • 連載の早見表は、この回の表を見る

次回の第11回は、演習の前編です。練習用のリポジトリに3つの担当を置く準備と、準備プロンプトの全文を扱います。一覧・呼び出し・モデルの確認と、組み込みの Explore のモデルは第12回(手順1〜4)、レビュー・スキル・使った量は第13回(手順5〜7)で試します。


連載「Claude Codeサブエージェント入門」全13回

全回の目次と、読む順番・目的別の読み方は、Claude Codeサブエージェント入門の入口のページにまとめています。

  1. サブエージェントとは
  2. 組み込みの担当と使い分け
  3. 担当を定義する
  4. toolsと返す形
  5. 担当のモデルの決まり方
  6. 役割とモデル・effort
  7. スキルから担当を呼ぶ
  8. 順に使う・前と裏
  9. ログの要約とレビューの担当
  10. 費用を測って小さく使う(この記事)
  11. 演習(前編):準備
  12. 演習(中編):読み込む・呼ぶ・モデルを見る
  13. 演習(後編):レビュー・スキル・費用
seichan

プロフィール詳細は「プロフィール」をご覧ください。
AWS Certified Solutions Architect – Professional (https://www.credly.com/badges/fd8feb88-6f1f-42ff-a94b-445bb6661cb8/public_url)
Nutanix Certified Professional - Multicloud Infrastructure 6 (https://www.credly.com/badges/5c081bef-a425-42e4-809c-85138e676630/public_url)
Palo Alto Networks System Engineer (PSE) - Hardware Firewall Professional (https://www.credly.com/badges/69dc3880-4a51-47eb-8843-47ba6ea7d013/public_url)

seichanをフォローする
生成AI
シェアする
seichanをフォローする

コメント

タイトルとURLをコピーしました