結論:全threadの監督が必要な時だけ--webを使い、URLを公開リンクにしない
Claude Managed Agentsのsessionをブラウザで監督するには、ant beta:sessions connect SESSION_ID --webを使います。CLIが127.0.0.1でlocal serverを起動し、Claude Consoleのsession viewerをブラウザから開きます。terminal viewがprimary thread中心なのに対し、browser viewerはmultiagent sessionのevery threadを追跡できるため、委任先のtool callまで一画面で確認したい時に向きます。
ただし、このURLをチーム共有の公開URLや恒久的な監視画面として扱ってはいけません。公式文書では印刷されたURLを2分以内に一度開け、認証情報はCLIから外へ出ず、API requestはlocalのant processが行うと説明されています。監督者、端末、session ID、閲覧時間を決め、viewerを閉じるまでを運用手順に含めてください。
根拠はClaude Platform公式connect文書と公式release notesです。sessionの状態とeventはManaged Agents公式session文書で確認します。
terminal viewとbrowser viewerを比較する
| 画面 | 見える範囲 | 向く場面 |
|---|---|---|
| terminal connect | primary thread、tool call、status | 一人が短時間で介入する |
| browser viewer | multiagentのevery thread | 委任先を含めて全体を監督する |
| events stream | eventをscriptで受け取る | 定型監視や記録を自動化する |
browser viewerは便利ですが、見える範囲が広いことと権限が強いことは同じではありません。tool callが承認待ちならAllow tool call?の状態を確認し、対象、入力、影響、承認者を判断します。実行中のagentへ追加指示を送る、interruptする、承認をdenyする操作は、見学ではなくsessionを変える操作です。閲覧担当と承認担当を同じ人にするか、分離するかを業務リスクで決めます。
127.0.0.1と2分のURL有効時間を管理する
--webは外部の共有サーバへviewerを公開する指定ではありません。公式文書の説明は、CLIが127.0.0.1でlocal serverをserveし、URLを印刷してブラウザで開く方式です。認証情報はCLIの外へ送られず、viewerからのrequestは同じlocal processがAPIへ出します。したがって、remote端末で別の人が同じURLを開けば見える、といった共有モデルを前提にしません。
URLは印刷後2分以内に一度開ける仕様です。これは閲覧セッションを長期間保存するためのURLではありません。端末のscreen lock、shell history、CI log、チャットへの貼り付け、スクリーンショットにURLやtranscriptが残らないようにします。--no-browserを使う場合も、表示されたURLをどこへ渡すか、誰が使うか、viewerのprocessをいつ終了するかを決めてください。
導入手順:viewerの監督範囲を検証する8ステップ
- 対象sessionのID、workspace、agent、environment、目的、監督者を台帳で照合します。
- まずterminalの
ant beta:sessions connect SESSION_IDでstatusとprimary threadの対象を確認します。 - every threadの確認が必要な理由を一文で書き、terminal viewで足りる作業と分けます。
ant beta:sessions connect SESSION_ID --web --no-browserを実行し、印刷されたlocal URLを担当端末だけで開きます。- ブラウザのviewerが127.0.0.1で動き、session、thread、agent名、tool callの履歴が台帳と一致するか確認します。
- running、idle、waiting for approvalの状態と、primary以外のthreadで進行中の作業を確認します。
- 承認待ちではtool、入力、データ境界、影響を読み、allow、deny、message、interruptを目的別に選び記録します。
- 監督終了後はbrowser tabとlocal processを閉じ、URLとtranscriptの保存・共有先に機微情報が残っていないか点検します。
viewerを開いたからといって、全threadの内容を人が同時に読めるわけではありません。長時間sessionでは重要イベント、承認待ち、外部送信、失敗、再試行の通知基準を定義します。全件を録画する設計は、個人情報や秘密の二次保管を増やす可能性があります。必要な証跡の粒度を決め、session IDとeventの要約で足りるか、原文保管が必要かを分けてください。
script監視が必要なら、公式が案内するant beta:sessions:events streamを候補にします。viewerの操作を自動化するために画面をscrapeする設計は、画面変更に弱く、秘密情報の露出も増えます。eventを受ける側にも保存期間、アクセス権、通知先、停止条件を設定し、無人でallowする処理を安易に追加しません。
既存のRemote Controlの安全運用は別surfaceの遠隔操作、subagentの遠隔追跡はClaude Code側の監督を扱います。Managed Agentsのbrowser viewerはlocal processとsession eventの境界を中心に設計します。auto permissionの設計も併読し、見えることと自動実行できることを混同しないでください。
チェックリスト:viewerを使う前後に確認する
□session IDとworkspaceを照合した □全threadを見る必要性を定義した □terminal viewとの違いを理解した □127.0.0.1のlocal processであることを確認した □2分のURL有効時間を記録した □URLを公開共有しない □screen historyとlogへの残留を確認した □承認担当を決めた □閲覧・message・interrupt・allow・denyを区別した □終了時にtabとprocessを閉じ、証跡の保存範囲を確認した。
よくある質問
--webのURLは社外へ共有できますか?
共有前提ではありません。公式文書は127.0.0.1のlocal serverと、印刷後2分以内に開くURLを案内しています。公開URLや恒久リンクとして保管しないでください。
terminal viewとviewerは何が違いますか?
terminal viewはmultiagent sessionのprimary threadを追跡し、browser viewerはevery threadを追跡します。必要な監督範囲で選びます。
--no-browserは何のためですか?
local viewerのURLを印刷し、ブラウザを自動で開かないためです。URLをどの端末で使い、いつ破棄するかは別に管理します。
公式情報と無料診断
--web、--no-browser、127.0.0.1、threadの見え方、URLの有効時間は公式connect文書、session lifecycleは公式session文書、更新日は公式release notesを公開直前にreadbackしました。Miraigentの無料診断では、監督範囲、閲覧権限、承認、記録、停止条件を業務別に整理します。
