Claude Platform Docs

ターミナルからManaged Agentsセッションに接続する

ant CLIをClaude Managed Agentsセッションにアタッチして、トランスクリプトをライブで追跡したり、メッセージを送信したり、ツール呼び出しを許可または拒否したり、ブラウザでセッションビューアーを開いたりします。

ant beta:sessions connectは、ターミナルを既存のClaude Managed Agentsセッションにアタッチします。セッションのトランスクリプトを読み込み、エージェントの作業に合わせてライブで追跡します。また、メッセージの送信、エージェントの中断、承認待ちのツール呼び出しの許可または拒否といった介入も可能です。--webを指定すると、代わりにブラウザのClaude Consoleのセッションビューアーでセッションを開きます。

このコマンドには、CLIのバージョン1.32.0以降が必要です。CLIのインストールまたは更新と認証については、CLIクイックスタートを参照してください。

セッションに接続する

ワークスペース内のセッションのIDを渡します。IDは、作成時のレスポンス、ant beta:sessions list、またはConsoleからコピーできます。

CLI
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7

--webを指定しない場合、このコマンドには対話型ターミナルが必要です。スクリプトでは、代わりにant beta:sessions:events streamant beta:sessions:events sendを使用してください。CLIのスクリプトと自動化を参照してください。

Ctrl+Cを押すとデタッチします。セッションは実行を続け、再度接続すると完全な履歴が読み込まれます。

セッションを追跡して操作する

ターミナルビューには、会話がライブで表示されます。メッセージとツール呼び出しが、各呼び出しの所要時間と結果とともに表示されます。ステータスバーには、セッションが実行中、アイドル状態、または承認待ちのいずれであるかが表示されます。マルチエージェントセッションでは、ビューはセッションのプライマリスレッドを追跡します。これには、コーディネーターが委任先のエージェントとやり取りするメッセージが含まれます。

キー操作
Enter入力内容をuser.messageイベントとして送信します。Alt+EnterまたはCtrl+Jで改行します。
Esc実行中のエージェントを中断します(user.interrupt)。
Ctrl+O詳細(ツールの入力と結果、トークン使用量、ステータスイベント)の表示と非表示を切り替えます。--verbose-v)を指定すると、詳細が表示された状態で開始します。
Page Up、Page Downトランスクリプトをスクロールします。上にスクロールすると追跡が一時停止し、Endで再開します。
Ctrl+Cデタッチします。空の入力行でCtrl+Dを押してもデタッチします。

ツール呼び出しが承認待ちになると、入力行がAllow tool call?に変わります。これは、always_askポリシーの場合、またはautoでサーバーが判断を下せなかった場合に発生します。YesNo、またはNo, and tell the agent whyを選択してください。CLIは選択内容をuser.tool_confirmationイベントとして送信し、入力した理由があればそのdeny_messageとして送信します。

セッションがterminated状態であるか削除されている場合、ビューは読み取り専用になります。

ブラウザでセッションビューアーを開く

CLI
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7 --web

--webは、127.0.0.1上のローカルサーバーからConsoleのセッションビューアーを提供し、そのURLを出力してブラウザで開きます。ブラウザを開かないようにするには、--no-browserを追加します。ブラウザからも、メッセージの送信、エージェントの中断、ツール呼び出しの許可または拒否を行えます。ターミナルビューとは異なり、ブラウザビューアーはマルチエージェントセッションのすべてのスレッドを追跡します。

URLは、出力されてから2分以内に1回だけ開くことができます。そのタブの再読み込みは可能ですが、別の場所でビューアーを開くには、コマンドを再度実行してください。認証情報がCLIの外部に出ることはありません。ページはローカルのantプロセスにのみリクエストを送信し、そのプロセスがAPIリクエストを行います。サーバーはCtrl+Cを押すまで実行され続けます。

Was this page helpful?