Monitorツールの対応範囲拡大
CHANGELOG 原文(英語)
Added the Monitor tool and plugin monitors on Bedrock, Vertex, and Foundry, and when telemetry or nonessential traffic is disabled; long foreground sleeps are now blocked there too 公式の変更履歴を開く ↗ 日本語での補足
Bedrock、Vertex、Foundryでの利用時、およびテレメトリや非必須通信を無効にしている場合に、Monitorツールとプラグインmonitorを追加。これらの環境でも長時間のフォアグラウンドsleepがブロックされるように。
ドキュメント
ドキュメントの抜粋(参考訳)
Monitor ツール
Monitorツールを使うと、Claudeは会話を一時停止させずにバックグラウンドで何かを監視し、変化があれば反応できます。Claudeに次のようなことを頼めます。
- ログファイルをtail監視し、エラーが現れたら知らせる
- PRやCIジョブをポーリングし、ステータスが変わったら報告する
- ディレクトリを監視し、ファイルの変更を検知する
- 指定した任意の長時間実行スクリプトの出力を追跡する
- WebSocketフィードに接続し、メッセージが届くたびに報告する
ほとんどの監視では、Claudeが小さなスクリプトを書いてバックグラウンドで実行し、出力行が届くたびに受け取ります。すでにイベントをプッシュしているサーバーに対しては、Claudeはスクリプトを実行する代わりにWebSocketを開くこともできます。
あなたは同じセッションで作業を続けられ、イベントが届くとClaudeが割り込んで知らせます。
Claudeが開始する監視には必ず期限があります。既定では 5 分、最長で 30 分、非対話で-pに単一のプロンプトを渡して実行する場合は最長で 10 分です。
期限に達すると監視は終了します。Claudeには一度だけ通知が届くので、まだ必要であれば監視をもう一度開始できます。
監視を止めるには、Claudeに取り消しを頼むか、セッションを終了してください。監視を開始したサブエージェントを、たとえば/tasksから止めた場合、その監視も一緒に止まります。
Monitorがコマンドを実行する際は、Bashと同じ権限ルールが使われるため、Bashに設定したallow・denyパターンはここにも適用されます。自動モードが有効な間、Claude CodeはMonitor自体を名指しするallowルールを、他の分類器が除外する広いallowルールと同様に除外するため、分類器はMonitorのコマンドもBashのコマンドと同じように審査します。
次の場合、Monitorには最小バージョンまたはGit Bashが必要です。
- 最小バージョン: Amazon Bedrock、AWS上のClaude Platform、Google CloudのAgent Platform、Microsoft Foundryのいずれかを使っている場合、または
DISABLE_TELEMETRYかCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICを設定している場合、MonitorにはClaude Code v2.1.310以降が必要です。この条件は、フィーチャーフラグの取得がオフのときに適用されます - Windows: このツールはGit Bashがインストールされている場合にのみ利用できます
プラグインは、Claudeに開始を頼む代わりに、プラグインが有効なときに自動的に開始する監視を宣言できます。プラグインのmonitorsを参照してください。
WebSocketソース
サーバーがすでにWebSocket経由でイベントをプッシュしている場合、Claudeはポーリングスクリプトを書く代わりに直接それへ接続できます。ソケットの各種アクティビティは、イベントになるか監視を終了させるかのいずれかです。
- テキストメッセージ: メッセージが複数行にわたっていても、1件がそのまま1件のイベントになります。
- バイナリメッセージ: そのままでは渡されません。Claudeは代わりに
[binary frame, 512 bytes]のようなプレースホルダー行を受け取ります。 - 1 MiBを超えるメッセージ: 監視は終了するため、絞り込んだフィードがあればそれを購読してください。
- ソケットのクローズ: 監視は終了し、Claudeはクローズコードを受け取ります。
WebSocketの監視はcommandの代わりにws入力を取り、1回のMonitor呼び出しで両方を組み合わせることはできません。ws入力には2つのフィールドがあります。
| Field | Required | Description |
|---|---|---|
url |
はい | 接続先のエンドポイント。認証情報や空白を含まない、ASCII文字のみを使ったws://またはwss://のURLである必要があります |
protocols |
いいえ | ハンドシェイク時に提示するWebSocketサブプロトコル名。各エントリは有効なサブプロトコルトークンである必要があり、リストに重複を含めることはできません |
timeout_msの期限はWebSocketの監視にも適用されます。監視は期限で終了し、TaskStopはそれより早く取り消します。
Monitor の allow ルールがない場合、Claude が WebSocket を開く前に確認を求められます。自動モードでは、代わりに分類器が判断します。ただしask ルールが適用される場合は除きます。このプロンプトには、同じホストに対する今後のプロンプトをスキップする選択肢はありません。
WebSocketの監視で拒否されるアドレスとホスト
Claude Code は、プライベートアドレス、リンクローカルアドレス、クラウドメタデータアドレスを指す URL(そのようなアドレスに解決されるホスト名を含む)を拒否します。プロキシの背後では、プロキシがブロックしない限り、監視はプライベートアドレス、リンクローカルアドレス、クラウドメタデータアドレスに到達できます。これは、Claude Code がプロキシの見つけたアドレスを確認しないためです。Claude Code は sandbox.network.deniedDomains にあるホストも拒否し、管理設定で allowManagedDomainsOnly が設定されている場合は、管理対象のアローリスト外のホストもすべて拒否します。
プロキシの背後での監視が could not resolve <host> で失敗する場合は、プロキシがホスト名を解決できるように、CLAUDE_CODE_PROXY_RESOLVES_HOSTS を 1 に設定して Claude Code v2.1.319 以降を再起動してください。
WebSocketの監視を拒否・確認するBashルール
Claude Code が WebSocket を開く Monitor 呼び出しを拒否する場合は、Bash または Bash(*) と書かれたdeny ルールや ask ルールを確認してください。Monitor の allow ルールがあるにもかかわらずその呼び出しで確認を求められる場合も同様です。すべての Bash コマンドに対するルールは、これらの WebSocket の監視にも適用されます。
- deny ルール:セッション開始時にこのルールが設定されていると、Claude は Monitor ツールを持たないため、監視を開始できません。セッション中にルールを追加した場合、Claude の次の
Monitor呼び出しは拒否されます。拒否はPermission to use Monitor has been denied: it runs code as Bash does, and a rule denies Bash.と表示されます。 - ask ルール:監視の承認を求められます。allow ルール、
PreToolUseフック、bypassPermissionsモード、自動モードの分類器のいずれも、代わりに承認することはできません。PermissionRequestフックから承認できます。dontAskモードなど誰も回答できない場合、Claude Code は監視を拒否します。
これらの監視を実行させるには、ルールを Bash(rm *) のように、意図するコマンドに絞り込んでください。
ask ルール、およびセッション中に追加した deny ルールは、Claude Code v2.1.319 以降でこれらの監視をカバーします。
取得日 · 2026-11-20