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?

11/6 の公式ドキュメント更新:Monitor コマンドへのフック適用と環境変数の追加

1
Posted at

この日の更新で内容を読み取れるのは、フックの適用対象に Monitor コマンドが含まれることの明文化と、環境変数まわりの追加の 2 点です。ほかの 5 ページは、検出された追加文がページの説明文にとどまっています。そのため、本文でどこが変わったかは追加文からは確認できません。

フックの matcher が Monitor コマンドにも及ぶ:Bash 向けフックの見直し点

フックのリファレンスには、matcher に Bash を指定したときの絞り込みの説明が加わっています。matcher は Bash ツール呼び出しと Monitor コマンドに絞り込みます。そのうえで if 条件が、Bash(rm *) に一致するサブコマンドへさらに絞ります。両方のフィルターに一致したときだけ、block-rm.sh が起動する設定例です。スクリプトは標準入力から JSON を読み、コマンドを取り出します。rm -rf を含む場合は permissionDecision として "deny" を返します。このページの目次には、Match Monitor commands という見出しも並んでいます。

Agent SDK のフックのページには、同じ内容がバージョン付きで書かれています。

On Claude Code v2.1.314 or later, they also run on PreToolUse and PermissionRequest for Monitor commands

(出典 [1])

(訳:Claude Code v2.1.314 以降では、コールバックは Monitor コマンドに対する PreToolUse と PermissionRequest でも実行されます。)

同じページには、Bash を matcher に指定するとコールバックが Bash コマンドに対して実行される、という文も追加されています。追加文の末尾には、Monitor コマンドに対しては deny はできるが approve はできない、とあります。

運用上の読み方は次のとおりです。Bash に対する拒否ルールをフックで書いている場合、v2.1.314 以降ではそのルールが Monitor 経由のコマンドにも届く可能性があります。一方、Bash 向けに自動承認するフックを書いている場合、Monitor コマンドについては承認の効果がありません。承認できなかった場合の挙動や、v2.1.314 より前に Monitor コマンドがフックの対象外だったかどうかは、追加文には書かれておらず、詳細は不明です。Monitor 用に別の matcher を書く必要があるかどうかも、追加文からは判断できません。

環境変数:リクエスト本文への追加項目と IDE 拡張の既定動作

環境変数のページには、CLAUDE_CODE_EXTRA_BODY の説明が追加されています。

JSON object to merge into the top level of model request bodies

(出典 [3])

(訳:モデルへのリクエスト本文のトップレベルにマージする JSON オブジェクト。)

追加文には続きがあります。会話の外で行われる一部のリクエスト、たとえば /model の確認には適用されません。つまり、通常のやり取りで送るリクエストにだけ項目を足し、モデル確認のような周辺の呼び出しには影響させない設計だと読めます。トップレベルにマージされる点も押さえておく必要があります。既存のリクエスト項目と同じキーを指定した場合にどちらが優先されるかは、追加文には書かれておらず、不明です。

もう 1 件、IDE 拡張に関する変数の説明が追加されています。内容は autoInstallIdeExtension を false に設定するのと同等、というものです。IDE 拡張の自動インストールを止める設定が、設定ファイルのキーと環境変数の両方で扱えることを示しています。ただし、この文が載っている変数の名前は、追加文の範囲では確認できません。

権限モードの切り替え手段が説明文に明記された

権限モードのページでは、説明文に切り替え手段が書かれています。

Switch permission modes with Shift+Tab in the CLI, the mode indicator in VS Code, or the mode selector in Desktop.

(出典 [4])

(訳:権限モードは、CLI では Shift+Tab、VS Code ではモードインジケーター、Desktop ではモードセレクターで切り替えます。)

CLI、VS Code、Desktop の 3 つの環境ごとに操作が異なります。チームで Claude Code を使っている場合、環境が違うメンバーに手順を案内するときの参照先になります。サンドボックスのページの説明文も更新されており、組み込みサンドボックスで Claude Code のシェルコマンドが届くファイルとネットワークホストを制限する、という趣旨です。権限モードとサンドボックスは、どちらも「確認なしに何をさせるか」を決める設定です。ただし、本文側にどんな変更があったかは追加文からは分かりません。

その他の更新

  • skills ページ(slash-commands の URL でも同じ内容を検出):説明文に、カスタムコマンドと同梱スキルを含む旨が記載されています。
  • agent-sdk/structured-outputs:説明文に、複数ターンのツール使用のあとで型安全な構造化データを得る旨が記載されています。
  • worktrees:説明文に、--worktree フラグ、サブエージェントの分離、.worktreeinclude、クリーンアップ、git 以外の VCS 向けフックを扱う旨が記載されています。
  • sandboxing:説明文に、有効化、境界の設定、問題が出たときの対処を扱う旨が記載されています。

まとめ

2026-11-06 時点で運用に影響しうるのは、Bash 向けのフックを書いている人と、リクエスト本文を環境変数で調整したい人です。前者は、v2.1.314 以降で同じ matcher が Monitor コマンドにも及ぶことと、Monitor には拒否しかできないことを確認する必要があります。後者は、CLAUDE_CODE_EXTRA_BODY が会話内のリクエストのトップレベルにだけ作用することを前提に設計することになります。ほかのページは説明文の更新が検出されただけで、機能や挙動の変更が確認できたわけではありません。実際に何が変わったのかは、各ページの本文を直接確認してください。

出典

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

[1] https://code.claude.com/docs/en/agent-sdk/hooks
[2] https://code.claude.com/docs/en/hooks
[3] https://code.claude.com/docs/en/env-vars
[4] https://code.claude.com/docs/en/permission-modes
[5] https://code.claude.com/docs/en/sandboxing
[6] https://code.claude.com/docs/en/slash-commands
[7] https://code.claude.com/docs/en/skills
[8] https://code.claude.com/docs/en/agent-sdk/structured-outputs
[9] https://code.claude.com/docs/en/worktrees

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?