要点
- Anthropic 公式アカウント @ClaudeDevs（米国時間 11 月 4 日投稿）によると、実行中のバックグラウンドサブエージェントは 30 秒ごとにステータス行を更新しており、これまでは更新のたびにサブエージェントの会話全体を読み直していました。今後は Haiku 5.5 が短いメモから作成するので、1 回の更新あたり約 99% 少なくなります。
- 続報の投稿によると、サブエージェント本体は自分のモデルのままです。バックグラウンドサブエージェントを使うセッションは使用上限の消費が約 5% 減り、同じ上限で約 6% 多くプロンプトを送れます。大半の Pro・Max・Ultra ユーザーと、すべての Team・Enterprise ユーザーに提供済みで、Claude Code v2.1.316 以降が必要です。
- やることは 1 つだけ：
claude --versionで確認し、2.1.316 未満ならアップデート。AlphaSignal の報道によると、設定の変更は不要です。 - 11 月 5 日に aicodewith の API Key で Claude Code 2.1.318 を使って実測しました。バックグラウンドサブエージェントのステータス行は約 30 秒ごとに変わり（「Reading shop and test files」→「Re-running tests on test_shop.py」）、サブエージェントは 1 分 46 秒で正しい file:line を報告しました。API Key 経由では、取得したステータス更新リクエストはサブエージェント自身のモデルを使っていました。サブエージェントとそのステータス行をどちらも Haiku 5.5 で動かすには
CLAUDE_CODE_SUBAGENT_MODELを設定します。/tasksに「Haiku 5.5」と表示されます。
API Key を作成して、Claude Code でバックグラウンドサブエージェントを動かす →
何が変わったか
| 項目 | これまで | v2.1.316 以降（公式の説明） |
|---|---|---|
| 更新間隔 | サブエージェントの作業中、約 30 秒ごと | 同じ |
| 更新時に読むもの | サブエージェントの会話全体（実行が進むほど長くなる） | サブエージェントが作業しながら残す短いメモ |
| 1 行を書くのは | サブエージェント自身のモデル | Haiku 5.5 |
| 1 回の更新あたり | 会話が長くなるほど増える | 約 99% 減 |
| セッション全体 | — | 使用上限の消費が約 5% 減、プロンプトが約 6% 増 |
| サブエージェントの作業モデル | 設定したモデル | 変わらない |
出典は @ClaudeDevs のメイン投稿と続報です。METAL の報道によると、公式は 6.6 秒の解説動画も公開しました。AlphaSignalによると、投稿は米国時間 11 月 4 日です。
ここでいう「ステータス行」は、/statusline でカスタマイズする画面下部のバーではありません。入力欄の下にあるサブエージェントパネルで、各バックグラウンドサブエージェントの後ろに出る「いま何をしているか」の短い一文です。開発者 Gabriel Anhaia の DEV の記事によると、この一文はこれまで、サブエージェントの会話をそのサブエージェント自身のモデルに送り、直近の動作を 3〜5 語で要約させて作っていました。作業中のバックグラウンドサブエージェントにだけ発生し、待機中は発生しません。サブエージェントを多く、長く動かすほど、この部分の消費が積み上がります。
Claude Code の変更履歴を見ると、この一文はこれまでにも何度か修正されています。2.1.128 で進捗要約がプロンプトキャッシュに当たらない問題、2.1.274 で要約が複数段落の長文になる問題、最新の 2.1.318 ではバックグラウンドサブエージェントの実行中に「Now using usage credits」の通知が約 30 秒ごとに再表示される問題が修正されました。
誰に影響があるか
| あなたの状況 | 影響 |
|---|---|
| Pro・Max・Ultra のサブスクリプションで、バックグラウンドサブエージェントをよく使う | 公式によると大半のユーザーで有効。2.1.316+ なら同じ上限で約 6% 多くプロンプトを送れる |
| Team・Enterprise | 公式によると全員に提供 |
| サブエージェントをほとんど使わない | ほぼ変化なし。変わったのはバックグラウンドサブエージェントのステータス行だけ |
| API Key で Claude Code を接続（ANTHROPIC_BASE_URL） | トークン単位の計量で、サブスクリプションの上限とは別。実測では更新がサブエージェントのモデルに従っていたので、トークンを節約するならサブエージェントを Haiku 5.5 に（後述） |
上限の仕組み（5 時間枠と週の上限）は「Claude Code の使用上限と Max 20x」を参照してください。
2.1.316+ にアップデートしてバージョンを確認
まず現在のバージョンを確認します：
claude --version
2.1.318 (Claude Code)
2.1.316 未満なら、インストール方法に合わせてアップデートします。Claude Code のインストールドキュメントによると、ネイティブ版はバックグラウンドで自動更新されますが、Homebrew と WinGet は既定では自動更新されません：
# ネイティブ版・npm 版：最新版に更新
claude update
# Homebrew：claude-code は stable チャネルで通常約 1 週間遅れ。すぐ新版が欲しいなら @latest
brew upgrade claude-code@latest
# Windows WinGet
winget upgrade Anthropic.ClaudeCode
# インストール方式・自動更新の状態・前回の更新結果を確認
claude doctor
新しいターミナルを開いて、もう一度 claude --version を実行します。公式の投稿には新しいスイッチや設定の記載はないので、アップデート後はそのままバックグラウンドサブエージェントを使えば大丈夫です。
実測：API Key で Claude Code に接続し、バックグラウンドサブエージェントを動かす
テスト日は 2026 年 11 月 5 日、Claude Code 2.1.318（Linux）、メインセッションは Opus 5.5 です。既存の設定に触れないよう、空の HOME ディレクトリを使いました。
ステップ 1：API Key を作成して Claude Code に接続
- aicodewith.ai で登録してログインし、左のナビゲーションバーの「キー管理」をクリックします。
- 「キーを作成」をクリックし、わかりやすい名前（例：「Claude Code サブエージェント」）を付けます。
- すぐにキー全体をコピーして保管します。ダイアログを閉じるとキー全体は二度と表示されません。詳しくは API Key の作成ドキュメントを参照してください。
キーを ~/.claude/settings.json に書きます：
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY"
}
}
ほかの接続方法は「Claude Code をサードパーティ API に接続する方法」を参照してください。
ステップ 2：しばらく動くタスクを用意する
デモ用リポジトリは小さな Python プロジェクトです。shop/ に 3 ファイル、tests/ に 7 つのテストがあり、各テストの setUp でわざと 6 秒待つので、テスト一式は 1 回約 42 秒かかります。shop/pricing.py には「10 個以上で割引」を qty > 10 と書いた境界のバグを仕込んであります。Claude Code で次のように送ります：
Use a general-purpose subagent in the background for a read-only review of this repo:
first run python3 -m unittest discover -s tests -v (about 45 seconds), then read every
file in shop/ and tests/ one by one, then run the test suite a second time, and finally
report each failing test with file:line, a one-line fix, and two other risks you notice.
The subagent must not edit any file. While it runs, just tell me it started.
ステップ 3：バックグラウンドサブエージェントのステータス行を見る
メインセッションはすぐに「開始しました」と返し、入力欄の下にサブエージェントパネルが現れます。同じ行の時間ごとの様子を時系列で抜き出すと次のとおりです：
● Agent(Read-only repo review)
⎿ Backgrounded agent (↓ to manage · ctrl+o to expand)
✻ Waiting for 1 background agent to finish
● main
◯ general-purpose Read-only repo review 48s · ↓ 12.0k tokens
◯ general-purpose Reading shop and test files 1m 10s · ↓ 14.0k tokens
◯ general-purpose Re-running tests on test_shop.py 1m 40s · ↓ 14.1k tokens
● Agent "Read-only repo review" finished · 1m 46s
最初はタスク名「Read-only repo review」が表示され、1 分 10 秒で「Reading shop and test files」、1 分 40 秒で「Re-running tests on test_shop.py」に変わりました。間隔はちょうど約 30 秒で、1 分 46 秒で完了しています。テストを 1 回だけ実行した別の試行（サブエージェントはメインセッションと同じ Opus 5.5）では 59 秒で完了し、ステータス行はタスク名から「Preparing shop unittest discovery run」に変わりました。
サブエージェントの最終レポート（抜粋）：
Tests: 7 ran and 1 failed. Both runs gave the same results, so nothing looks flaky.
Failing test: test_bulk_at_threshold (tests/test_shop.py:10)
- It expects 10 units at 1.0 to total 9.5, but the code returns 10.0.
- The cause is shop/pricing.py:3, which uses if qty > 10.
- Fix: change > to >= at shop/pricing.py:3.
Two other risks:
1. Overselling (shop/inventory.py:4-7): reserve() checks stock and then sets it with no lock.
2. Missing input checks (shop/cart.py:5, shop/cart.py:9).
指摘された shop/pricing.py:3 と > を >= にする修正はどちらも正しく、ファイルは一切変更されていません。
ステップ 4：ステータス行を書いているのはどのモデルか
API の手前に、モデル名とメッセージ数だけを記録するローカルの中継を置いて確認しました：
| タイミング | リクエスト | モデル | 送られた会話 | 出力 |
|---|---|---|---|---|
| 1 分 10 秒前後 | ステータス更新 | claude-haiku-5-5（サブエージェントのモデル） | サブエージェントの現在の会話 7 メッセージ | 「Reading shop and test files」、10 トークン |
| 1 分 40 秒前後 | ステータス更新 | claude-haiku-5-5（サブエージェントのモデル） | サブエージェントの現在の会話 8 メッセージ | 「Re-running tests on test_shop.py」、15 トークン |
つまり、API Key で ANTHROPIC_BASE_URL を使った今回のテストでは、ステータス更新は依然として「サブエージェントの現在の会話をサブエージェント自身のモデルに送る」方式で、公式が説明する従来の方式と一致していました。公式は新方式が大半のサブスクリプションユーザーに提供済みとしていますが、API Key での接続には触れていません。API Key ユーザーにとって最も直接的な方法は、サブエージェントを Haiku 5.5 にすることです。作業もステータス更新も Haiku 5.5 で動きます。
サブエージェントのモデル設定
Claude Code のサブエージェントドキュメントによると、サブエージェントのモデルは次の順で決まります：
- Claude がその呼び出しで渡す
modelパラメーター - サブエージェント定義の
modelフィールド（inheritはメインセッションと同じ） - 環境変数
CLAUDE_CODE_SUBAGENT_MODEL - メインセッションのモデル
方法 1：すべてのサブエージェントの既定モデルを決める
~/.claude/settings.json の env に 1 行追加します。ステップ 3 の実測で使った設定です：
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.aicodewith.ai",
"ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
"CLAUDE_CODE_SUBAGENT_MODEL": "claude-haiku-5-5"
}
}
これはあくまで既定値です。定義ファイルで model を指定したサブエージェントや、Claude が呼び出し時にモデルを指定した場合はそちらが優先されます。また、この変数だけでは組み込みの Explore・Plan サブエージェントのモデルは変わりません。
方法 2：特定のサブエージェントにモデルを指定する
プロジェクトの .claude/agents/ か個人の ~/.claude/agents/ に Markdown ファイルを作ります：
---
name: test-runner
description: Runs the test suite and reports failing tests with file:line. Read-only.
tools: Read, Grep, Glob, Bash
model: haiku
effort: medium
---
Run the tests, read only the files you need, and report each failing test
with file:line and a one-line fix. Never edit files.
model には haiku・sonnet・opus・inherit か、claude-haiku-5-5 のような完全なモデル ID を書けます。より詳しい読み取り専用サブエージェントの書き方は「Claude Code のサブエージェントを Haiku 5.5 で動かす設定」を参照してください。
方法 3：すべてのサブエージェントを同じモデルに固定する
{
"env": {
"CLAUDE_CODE_SUBAGENT_MODEL": "haiku",
"CLAUDE_CODE_SUBAGENT_MODEL_FORCE": "1",
"CLAUDE_CODE_SUBAGENT_EFFORT": "medium"
}
}
CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1 は定義ファイルの model を無視します（v2.1.257 以降）。CLAUDE_CODE_SUBAGENT_EFFORT は 2.1.316 で追加され、サブエージェントの既定の effort をメインセッションから引き継がずに設定できます。
反映されたか確認する
サブエージェントの実行中に /tasks と入力して選ぶと、実際に使われているモデルが表示されます。実測の出力：
/tasks
general-purpose › Read-only repo review
1m 1s · 14.0k tokens · 8 tools · Haiku 5.5
Progress
Read(shop/cart.py)
Read(shop/inventory.py)
Read(shop/pricing.py)
Read(tests/test_shop.py)
› Bash(python3 -m unittest discover -s tests -v 2>&1; echo "EXIT=$?")
2 行目末尾の「Haiku 5.5」が、サブエージェントが実際に使っているモデルです。Haiku 5.5 と Sonnet 5.5 の使い分けは「Claude Haiku 5.5 vs Sonnet 5.5」を参照してください。
ほかに使用量を抑える方法
- 同時に動かすバックグラウンドサブエージェントを減らす：ステータス行は作業中のバックグラウンドサブエージェントごとに更新されるので、5 つ同時なら 5 本分です。
- ファイル検索やテスト実行は Haiku 5.5 に任せる：メインセッションは深く考える部分に使います。
- 繰り返す手順は Skill にまとめる：独立したコンテキストが不要なら、メインセッションで動かすほうが軽く済みます。「Claude Code のサブエージェントを Skills にまとめる」を参照。
- Codex ユーザー：Codex の作業分割の考え方は「Codex サブエージェントのタスク分割戦略」、Claude Code と Codex を別ディレクトリで並行して動かすなら「Conductor なしで Claude Code / Codex を並列実行」を参照してください。
よくある質問
使うには設定の変更が必要ですか？
公式が求めているのは v2.1.316 以降へのアップデートだけで、新しいスイッチの記載はありません。AlphaSignal の報道によると、設定の変更は不要です。
サブエージェントが Haiku に変わってしまいますか？
いいえ。公式によると、Haiku 5.5 が担当するのはステータス行だけで、サブエージェントの作業は設定したモデルのままです。サブエージェント自体も Haiku で動かしたい場合は、CLAUDE_CODE_SUBAGENT_MODEL を設定するか、定義ファイルに model: haiku と書きます。
「99% 減」と「5% 減」の関係は？
99% はステータス行 1 回の更新あたり、5% はセッション全体の使用上限です。ステータス更新はセッション全体のごく一部なので、セッションでは約 5% の節約、同じ上限で約 6% 多くプロンプトを送れる計算です。
バックグラウンドサブエージェントがいま何をしているかはどこで見られますか？
入力欄の下のサブエージェントパネルに、バックグラウンドサブエージェントごとに 1 行、状態・経過時間・トークン数が出ます。↓ で選び Enter で記録を開けます。/tasks ではモデル、ツール呼び出し、進捗を確認できます。
API Key で接続した場合も新方式になりますか？
公式の投稿で挙げられているのは Pro・Max・Ultra・Team・Enterprise だけです。API Key で 2.1.318 を実測したところ、ステータス更新はサブエージェントのモデルに従っており、サブエージェントを Haiku 5.5 にすると更新も Haiku 5.5 で動きました。
API Key を作成して、Claude Code のバックグラウンドサブエージェントを使い始める →
