1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

10/9 の公式ドキュメント更新:バックグラウンド処理の制御とサブエージェント追跡

1
Posted at

この日の更新は、claude -p 実行後のバックグラウンドタスク待機の挙動を明文化した変更と、TypeScript Agent SDK でのサブエージェントメッセージへの識別子付与を中心に、MCP のレスポンスサイズ制限やフック仕様の整備が加わっている。ヘッドレス実行・マルチエージェント構成・MCP サーバー運用の 3 領域にまたがる更新が集中した日である。

ヘッドレス実行後のバックグラウンドタスク待機

claude -p でメインの会話ターンが終わり stdin が閉じた後も、バックグラウンドで起動した処理が残っていれば実行が継続されることが文書化された。

a claude -p run can stay open to wait for background work that Claude started

(出典 [2])

(訳:claude -p の実行は、Claude が開始したバックグラウンド処理を待つために開いたままになることがあります。)

待機対象として列挙されているのはバックグラウンドコマンド、サブエージェントやワークフロー、Monitor ウォッチ、/loop の次回起動の 4 種類である。デフォルトでは継続的なアイドル状態が 10 分続くと残るバックグラウンドタスクへの待機を終了する。この上限は CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS で変更でき、0 に設定すると上限なしで待ち続ける。バックグラウンドコマンドが実行中のあいだはカウントが進まない点も明記されており、長時間のビルドや開発サーバーを起動したまま headless 実行する構成でも待機が早期に打ち切られることはない。環境変数ドキュメントにも「上限に達したとき Claude Code は残るバックグラウンドタスクへの待機を終了する」との記述が追加されており、headless から env-vars の両ドキュメントにまたがって補完されている。

MCP のレスポンスサイズ上限とツール読み込み制御

HTTP および SSE 方式の MCP サーバーに対して、レスポンスサイズの上限が設けられた。JSON レスポンスボディまたはイベントストリームの 1 イベントが解凍後にこの上限を超えると、対象リクエストは失敗として扱われる。

passes 16 MB after decompression

(出典 [1])

(訳:解凍後に 16 MB を超えると。)

自前でサーバーを運用している場合は、結果をページネーションなどで分割して返すことがドキュメントで推奨されている。分割の具体的な実装形式は各サーバーの設計に委ねられており、ドキュメントにはそのように記載されているだけで詳細は不明である。この上限は 2026-10-09 時点で新たに追加された記述であり、既存の MCP サーバーが大きなデータを 1 レスポンスで返す設計になっている場合は対応が必要になることがある。

また、ツールの _meta オブジェクトに anthropic/alwaysLoad を設定することで、起動時に必ず読み込むか遅延読み込みにするかをツール単位で制御できることも文書化された。

Mark a tool to load upfront or stay deferred

(出典 [1])

(訳:ツールを起動時に読み込むか遅延読み込みにするかを制御します。)

TypeScript Agent SDK でのサブエージェントメッセージへの識別子付与

TypeScript Agent SDK において、サブエージェントが生成するアシスタントメッセージおよびユーザーメッセージに agent_id フィールドが追加された。この値はそのサブエージェントのタスクイベントに記録される task_id と一致するため、複数のサブエージェントが並行稼働する構成で各メッセージの発生元をタスクレベルで特定できる。

agent_id requires TypeScript Agent SDK v0.3.292 or later

(出典 [9])

(訳:agent_id の利用には TypeScript Agent SDK v0.3.292 以降が必要です。)

2026-10-09 時点のドキュメントには TypeScript 版への言及のみがあり、他言語向け SDK での対応状況は記載されていない。並行サブエージェントが複数のメッセージを生成するシナリオでは、ログやイベントストリームの突合に直接利用できる追加である。

フックへの WorktreeCreate・WorktreeRemove 対応と Elicitation 仕様の補足

フックのドキュメントに WorktreeCreate と WorktreeRemove の 2 種類のイベントが追加された。WorktreeCreate はゼロ以外の終了コードを返すとワークツリーの作成を失敗させることができる。

Any non-zero exit code causes worktree creation to fail

(出典 [5])

(訳:ゼロ以外の終了コードが返るとワークツリーの作成が失敗します。)

WorktreeRemove はディレクトリが残存している場合に限りゼロ以外の終了コードで削除を失敗させられる。どちらもブロック系フックとして位置付けられており、ワークツリーの作成・削除前に条件を検証する用途に使える。

Elicitation フックと ElicitationResult フックについても仕様が整理された。ElicitationResult は hookSpecificOutput として action(accept/decline/cancel)と content(フォームフィールドの値)を返すことでレスポンスをブロックできる。MessageDisplay フックでは hookSpecificOutput の displayContent によって画面上の表示テキストを差し替えられることも記載されている。

CLAUDE.md のサブディレクトリスコープ遅延読み込み

CLAUDE.md ファイルの読み込みタイミングに関して、サブディレクトリ単位での遅延読み込み動作が文書化された。起動時に全ファイルをまとめて読み込む代わりに、該当サブディレクトリ内の別ファイルを Claude が操作したタイミングで対応する CLAUDE.md を読み込む。

loads each one once Claude reads, writes, or edits another file in that subdirectory

(出典 [6])

(訳:そのサブディレクトリ内の別ファイルを Claude が読み書き・編集した時点で初めて読み込みます。)

パス指定ルールも同様に、Read・Write・Edit ツールの使用時、または cat・head のような単一ファイル読み取りを伴う Bash コマンドの実行時に読み込まれる。多数の CLAUDE.md がサブディレクトリごとに分散したリポジトリで起動時の挙動を予測するうえで参照できる記述である。

v2.1.295 の変更概要

CHANGELOG に v2.1.295 が追加された。フックの onFailure: "block" 対応に加え、次の機能が追加されている。

Added Program Status Protocol (OSC 7501) support

(出典 [7])

(訳:Program Status Protocol(OSC 7501)のサポートが追加されました。)

このプロトコルを実装しているターミナルでは、Claude Code が作業中か入力待ちか完了かをターミナル側で把握できるようになる。またこのバージョンでは、1M コンテキストに対応しないゲートウェイ経由でリクエストが全件失敗する問題の修正、Remote MCP サーバーの再接続ロジックの改善、複数のプラグインおよびフック関連の修正が含まれている。変更の全量は CHANGELOG に記載されている。

その他の更新

  • 環境変数 CLAUDE_CODE_DISABLE_1M_CONTEXT を 1 に設定すると 1M コンテキストウィンドウのサポートが無効化され、1M ウィンドウを前提とするモデルも 200K ウィンドウで動作する(2026-10-09 時点の env-vars ドキュメントより)。
  • モニタリング用メトリクスの一部フィールドが文字列ではなく Boolean として出力されることが明記された(monitoring-usage ページより)。
  • Anthropic ホスト環境では、複数リポジトリを持つセッションが各リポジトリの .claude/settings.json から enabledPlugins と extraKnownMarketplaces の 2 項目のみを読み取り、パーミッションルールやフック、env などのキーは読まないことが記載された(settings ページより)。
  • サブエージェントのドキュメントに isolation キーが追加され、worktree を指定するとデフォルトブランチからブランチされた一時 git ワークツリー上でサブエージェントを動作させられることが記載された(sub-agents ページより)。

まとめ

この日の更新をまとめると、ヘッドレス実行を常用する開発者にはバックグラウンド待機の動作とその制御用環境変数が直接影響し、想定外の待機やタイムアウトを事前に設計できるようになっている。TypeScript Agent SDK でマルチエージェント構成を組んでいる開発者には agent_id による発生元追跡が利用できるようになった。MCP サーバーを自前で運用している場合は 16 MB という制限を意識したレスポンス設計が必要になる。フックやワークツリーを活用しているチームには WorktreeCreate・WorktreeRemove によるブロック制御が加わる。いずれも既存機能の動作を明文化・制限するドキュメント追加であり、暗黙的だった挙動を整備した日として位置付けられる。

出典

本稿の引用はすべて一次資料と逐語照合(verify_article 通過)のうえ掲載しています(2026-10-13 検証)。

[1] https://code.claude.com/docs/en/mcp
[2] https://code.claude.com/docs/en/headless
[3] https://code.claude.com/docs/en/env-vars
[4] https://code.claude.com/docs/en/monitoring-usage
[5] https://code.claude.com/docs/en/hooks
[6] https://code.claude.com/docs/en/memory
[7] https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md
[8] https://code.claude.com/docs/en/sub-agents
[9] https://code.claude.com/docs/en/agent-sdk/subagents
[10] https://code.claude.com/docs/en/settings

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?