2026年9月30日のClaude Code公式ドキュメント更新：WorktreeRemoveフックの挙動定義と新フックイベントの追加

この日の更新は、WorktreeRemoveフックの終了コード別挙動の定義、MCPエリシテーションとバックグラウンドエージェントを対象とした新しいフックイベントの追加、クラウドセッションとClaude Tagへのテレメトリ設定方法の整理という3本柱を中心に展開している。バージョン2.1.285と2.1.284の2バージョンが同日CHANGELOGに記録された。

WorktreeRemoveフックの挙動とクリーンアップルール

WorktreeCreateフックを設定している場合、WorktreeRemoveフックも対として設定することが強く推奨されることが明記された。フックなしでセッション終了時に削除を選択した場合、gitが認識するワークツリーであればgit worktree remove --forceにフォールバックするが、git以外のバージョン管理システムで作成したワークツリーはディスクに残される。

フックの終了コードによって挙動が分岐する点も整理された。終了コード0で終了した場合、ワークツリーは削除済みとみなされる。

Hook exits 0 : the worktree counts as removed.

（出典 [1]）

（訳：フックが終了コード0で終了すると、ワークツリーは削除済みとみなされます。）

終了コードが0以外でかつworktree_pathのディレクトリが残存している場合、削除は失敗し、gitによるフォールバックも実行されない。フックがディレクトリを削除してから非ゼロで終了した場合は削除済みとみなされる。Claude CodeはWorktreeCreateフックが返したパスしか把握していないため、WorktreeCreateフックがブランチを作成した場合はWorktreeRemoveフック内で明示的にブランチを削除する必要がある点も追記されている。

管理者向けには、マネージド設定のallowManagedHooksOnlyを使うことで、ユーザー・プロジェクト・ローカル・プラグインのフックを制限できることが明文化された。

Administrators can use allowManagedHooksOnly in managed settings to restrict which hooks run

（出典 [1]）

（訳：管理者はマネージド設定のallowManagedHooksOnlyを使うことで、実行されるフックを制限できます。）

フックイベントにエリシテーション系・エージェント系マッチャーが追加

フックのMatchers一覧に、MCPエリシテーション関連とバックグラウンドエージェント関連の新しいイベントが加わった。elicitation_dialog（MCPサーバーがエリシテーションフォームを開いてから約6秒未入力の時）、elicitation_url_dialog（MCPサーバーがブラウザURLを要求してから約6秒未入力の時）、elicitation_complete（URLモードのエリシテーション完了時）、elicitation_response（MCPエリシテーションのレスポンス送信時）の4イベントが追加されている。

エージェント系では、バックグラウンドセッションがエージェントビュー表示中のターミナルで入力待ちになった時に発火するagent_needs_inputと、バックグラウンドセッションの完了または失敗時に発火するagent_completedが追加された。

agent_needs_input A background session starts waiting on your input while agent view is open in a terminal.

（出典 [1]）

（訳：agent_needs_inputは、エージェントビューを表示中のターミナルでバックグラウンドセッションが入力待ちになったときに発火します。）

これらの追加により、MCP操作の完結やエージェントの終了を契機とした自動化フローを組めるようになる。

クラウドセッションとClaude Tagへのテレメトリ設定

クラウドセッションはユーザーデバイスではなくクラウド環境で動作するため、デバイス上のシェルプロファイルやマネージド設定ファイルではテレメトリの設定が届かない。2026-09-30時点、設定を届かせる方法として2つの経路が整理されている。

サーバーマネージド設定のenvブロックへの追加は、ユーザーマシンとほとんどのクラウドセッションに適用されるが、Claude Tagチャンネルセッションには届かない。Claude Tagセッションへ届かせるには、クラウド環境の環境変数に直接追加する経路を使う必要がある。

ただし、環境変数はその環境を使うユーザー全員が読み取れるため、コレクタートークンなどの認証情報を置いてはならない。

Anyone who uses an environment can read its variables, so don't put a credential there

（出典 [2]）

（訳：その環境を利用する誰もが変数を読み取れるため、認証情報を環境変数に置かないでください。）

認証情報が必要な場合はサーバーマネージド設定経由が推奨されており、Claude Codeがマネージド設定外に設定されたエンドポイント変数を削除する仕組みを活用する設計になっている。

メトリクスのカーディナリティ制御用の環境変数も追加された。どの属性をメトリクスに含めるかを制御するもので、OTEL_METRICS_INCLUDE_SESSION_IDについてはデフォルトがtrueとなっている。

OTEL_METRICS_INCLUDE_SESSION_ID Include session.id and, on cloud sessions, ccr.session.id attributes in metrics

（出典 [2]）

（訳：OTEL_METRICS_INCLUDE_SESSION_IDは、セッションのsession.idと、クラウドセッションのccr.session.idをメトリクスに含めるかどうかを制御します。）

このほかOTEL_METRICS_INCLUDE_VERSION（デフォルトfalse）、OTEL_METRICS_INCLUDE_ACCOUNT_UUID（デフォルトtrue）、OTEL_METRICS_INCLUDE_ENTRYPOINT（デフォルトfalse）など複数の制御変数が追加されており、それぞれデフォルト値が異なる点に注意が必要です。

サブエージェントのフック継承とsession-wideモード

サブエージェントは親会話のパーミッションルールを継承し、多くの場合は制限されたツールセットで動作することが明記された。

Each inherits the parent conversation's permission rules; most run with a restricted tool set.

（出典 [3]）

（訳：各サブエージェントは親会話のパーミッションルールを継承し、多くの場合は制限されたツールセットで動作します。）

自然言語での依頼、@メンション、セッション全体への適用という3段階のエスカレーションパターンも整理されている。--agentフラグを使うとセッション全体でそのサブエージェントのツール制限とモデルが引き継がれる。

Pass --agent to start a session where the main thread itself takes on that subagent's tool restrictions and model

（出典 [3]）

（訳：--agent <name>でセッションを開始すると、メインスレッド自体がそのサブエージェントのツール制限とモデルを引き継ぎます。）

カスタムサブエージェントのプロンプトが空でない場合、デフォルトのClaude Codeシステムプロンプトは完全に置き換えられる点も明記されている（--system-promptと同様の挙動）。

バージョン2.1.285と2.1.284の主な変更

2.1.284ではClaude Sonnet 5.5が追加され、AnthropicAPIにおけるデフォルトSonnetモデルとなった（1Mコンテキスト、$2/$10 per Mtok、キャッシュリード$0.20/Mtok）。

now the default Sonnet model on the Anthropic API

（出典 [5]）

（訳：AnthropicAPIのデフォルトSonnetモデルとなりました。）

また、ワーキングディレクトリ外への読み取りに「今回だけ許可し次回は再確認する」という回答選択肢が追加された。

2.1.285では新機能として、WebFetchツールを無効化する環境変数CLAUDE_CODE_DISABLE_WEB_FETCH、claude --desktopコマンド、APIプロバイダーをallowedProviders管理設定で制限する機能、claude plugin configureコマンドが実装された。修正件数は多く、auto modeのサブエージェントが余分なターンを消費する問題、RemoteControlでのメッセージ消失、Artifact toolのパーミッション判定の誤動作など計100件近い修正が含まれている。詳細はCHANGELOGを参照されたい。

その他の更新

• CLAUDE.mdのインポートパスにスペースが含まれる場合、各スペースの前にバックスラッシュが必要。引用符で囲むとインポートが一切動作しない（memoryページ）
• 環境変数とsettingsファイルのenvブロックが重複する場合、多くのセッションではsettingsファイル側の値が優先される（env-varsページ）
• DISABLE_PROMPT_CACHING_FABLE、DISABLE_PROMPT_CACHING_HAIKU、DISABLE_PROMPT_CACHING_OPUS、DISABLE_PROMPT_CACHING_SONNETとモデル別のプロンプトキャッシュ無効化変数が追加（env-varsページ）
• auto modeのブロック閾値は「連続3回」と「合計20回」で、どちらも設定変更不可（permission-modesページ）
• ルーティンのスケジュール実行は1時間あたり100回の制限。使用クレジットが有効であれば、サブスクリプション使用量の上限超過後もメータリングで実行継続が可能（routinesページ）
• /claude-apiスキルにpreserved-thinking-migrationサブコマンドが追加（v2.1.282以降）。preserved thinkingブロックを無効化している箇所を特定し、修正を提案する（slash-commandsページ）
• スキル評価の自動化を支援する2つのツールが整備された（skillsページ）

まとめ

2026-09-30時点のドキュメント更新は、Claude Codeを組織で運用する立場のユーザーに最も影響が大きい内容となっている。WorktreeRemoveフックの挙動定義によって、git以外のVCS環境や非標準クリーンアップを組み込んでいるチームはフック設計を見直す必要が生じる。allowManagedHooksOnlyとallowedProvidersという2つの管理者制限機能の追加は、エンタープライズ環境でのポリシー適用範囲を拡張するものです。クラウドセッションとClaude Tagへのテレメトリ設定経路の整理は、可観測性の設計を行っているチームにとって直接参照すべき変更です。バージョン2.1.285の修正件数の多さは、安定性改善が継続していることを示しています。

出典

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

[1] https://code.claude.com/docs/en/hooks
[2] https://code.claude.com/docs/en/monitoring-usage
[3] https://code.claude.com/docs/en/sub-agents
[4] https://code.claude.com/docs/en/permission-modes
[5] https://raw.githubusercontent.com/anthropics/claude-code/main/CHANGELOG.md
[6] https://code.claude.com/docs/en/memory
[7] https://code.claude.com/docs/en/env-vars
[8] https://code.claude.com/docs/en/routines
[9] https://code.claude.com/docs/en/slash-commands
[10] https://code.claude.com/docs/en/skills