Claude Code の使用制限:バックグラウンドエージェントの状態表示が99%安く
Claude Code の使用制限の減りが緩やかに。バックグラウンドエージェントの状態表示を Haiku 5.5 が書くようになり、更新1回のコストは約99%減。
この記事の他の言語版:العربيةDeutschEnglishEspañolFrançaisItalianoPolski简体中文
11月4日の夜、ClaudeDevs アカウントが X で発表したところによると、Claude Code のバックグラウンドエージェント(background subagents)が消費する使用制限が少なくなりました。こうしたエージェントの状態表示は30秒ごとに更新され、これまでは更新のたびにエージェントの会話全体を読み直していました。今後は Haiku 5.5 が短いメモをもとに書くため、更新1回あたりのコストは約99%減になります。
Claude Code の使用制限の計算で何が変わったのか?
対象は、バックグラウンドで動く各エージェントの横に表示される短い状態行です。ClaudeDevs の投稿によると、これまでの仕組みは次のとおりでした。
- 30秒ごとに、動いているエージェントそれぞれについて、Claude Code が新しい状態を生成していた。
- その更新のたびに、時間とともに長くなるエージェントの会話全体を読み直していた。
- 今後は、トランスクリプト全体を読む代わりに Haiku 5.5 が短いメモから状態を書く。
Claude Code の変更履歴によると、Haiku 5.5 の API 料金は入力100万トークンあたり0.10ドル、出力100万トークンあたり0.50ドルです。
投稿はすぐに広がり、11月5日の朝までに1万6千件を超える「いいね」と約120万回の表示を集めました。毎日 Claude Code を使う人にとって、制限は最もよく話題になるテーマの一つなので、当然の反応でしょう。
なぜ重要なのか?
1週間前に話題になった計測結果の原因が、まさにこの仕組みだったからです。この件は Claude Code のトークン消費の記事で取り上げました。Flamerix AI の gist によると、agent_summary の要約が**セッションの推定コストの16.4%**を占め、メインの会話よりも多かったのです。
その後、Issue #86879 には新たな分析が加わりました。10月31日には、あるユーザーがバージョン2.1.314のログから、要約1回あたりキャッシュ外の入力トークンを2,800〜13,000送っていたと算出し、多数のエージェントを使う1週間の作業を想定した試算では、要約が**支出の約13〜32%**を占めるとしました。環境変数から起動時に読み込むスクリプトまで、独自の回避策を公開する人もいました。
興味深いことに、この Issue 自体には Anthropic の誰もまだコメントしていません。11月5日時点で Issue はオープンのままで、変更は GitHub のスレッドではなく X で発表されました。
バックグラウンドエージェントでほかに改善された点は?
11月4日のバージョン2.1.318の変更履歴には、同じ領域の変更がいくつか載っています。
- バックグラウンドエージェントは、実行中にプロンプトキャッシュが切れないよう、すべてのプロバイダーで3分後にシェルコマンドをバックグラウンドへ移す。
- Bedrock、Vertex、Foundry(およびテレメトリを無効にしている場合)では、キャッシュが冷えているとき、エージェントの進捗要約がエージェントの応答を最大5分待つことがある。
- バックグラウンドエージェントの動作中に約30秒ごとに表示されていた「Now using usage credits」というメッセージを修正。
ClaudeDevs の投稿にはバージョン番号もアップデートが必要かどうかも書かれていません。変更履歴にもこの変更は直接記載されていないので、最新版を使っておくのがいちばん簡単です (claude --version で確認しましょう)。
注意すべき点は?
まず、規模感です。99%は状態表示の更新1回あたりの話で、請求額全体ではありません。実際にどれだけ節約できるかは、同時に動かすエージェントの数と稼働時間しだいです。バックグラウンドエージェントを使わないセッションでは、変化はほぼ感じないはずです。
次に、オフにする手段がないことです。投稿には状態表示を無効にする設定への言及がなく、ユーザーは Issue で今もその機能を求めています。
最後に、計測の数字です。先に紹介した13〜32%という割合は、ユーザーによる推計(cost_usd フィールドとコストモデルにもとづくもの)で、請求書ではないため、割り引いて受け止めましょう。いちばん確実なのは、前回の記事で説明したように、OpenTelemetry のテレメトリでリクエストを query_source ごとに集計し、自分の環境で確かめることです。エージェントを使った作業全般については Claude Code チュートリアルをご覧ください。
よくある質問
Claude Code の使用制限はなぜすぐに上限に達するのか?
リクエストのたびに会話のコンテキストがモデルに送られるため、長いセッションや多数のエージェントの同時実行は制限をすぐに消費します。ユーザーの計測では、バックグラウンドエージェントの状態表示もコストの大きな部分を占めていましたが、11月4日からは更新1回あたり約99%安くなっています。
変更の恩恵を受けるには何か設定が必要?
ClaudeDevs の投稿によると、設定は不要です。ただし、Claude Code は最新版にしておくのがおすすめです。
バックグラウンドエージェントの状態表示を完全に無効にできる?
今のところ公式の設定はありません。Issue #86879 ではユーザーによる回避策が出回っていますが、どこでも動くわけではなく、Anthropic のサポート対象でもありません。