---
title: 從終端機連線至 Managed Agents 工作階段
url: https://platform.claude.com/docs/zh-TW/cli-sdks-libraries/cli/sessions-connect
description: 將 ant CLI 附加至 Claude Managed Agents 工作階段，以即時追蹤其對話紀錄、傳送訊息、允許或拒絕工具呼叫，或在瀏覽器中開啟工作階段檢視器。
---

`ant beta:sessions connect` 會將您的終端機附加至現有的 Claude Managed Agents [工作階段](https://platform.claude.com/docs/zh-TW/managed-agents/sessions)。它會載入工作階段的「transcript」（對話紀錄），並在代理程式運作時即時追蹤。您也可以介入操作：傳送訊息、中斷代理程式，或允許或拒絕正在等待核准的工具呼叫。使用 `--web` 時，它會改為在瀏覽器中以 Claude Console 的工作階段檢視器開啟該工作階段。

此命令需要 1.32.0 或更新版本的 CLI。若要安裝或更新 CLI 並進行驗證，請參閱 [CLI 快速入門](https://platform.claude.com/docs/zh-TW/cli-sdks-libraries/cli/quickstart)。

## 連線至工作階段

傳入您工作區中某個工作階段的 ID。您可以從建立回應、`ant beta:sessions list` 或 Console 中複製該 ID。

```bash CLI
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7
```

若未使用 `--web`，此命令需要互動式終端機。在指令碼中，請改用 `ant beta:sessions:events stream` 和 `ant beta:sessions:events send`。請參閱 [CLI 指令碼與自動化](https://platform.claude.com/docs/zh-TW/cli-sdks-libraries/cli/scripting)。

按下 Ctrl+C 即可中斷連線。工作階段會持續執行，再次連線時會載入其完整歷史紀錄。

## 追蹤並引導工作階段

終端機檢視會即時顯示對話：訊息與工具呼叫，以及每次呼叫的持續時間與結果。狀態列會顯示工作階段是正在執行、閒置，還是正在等待您的核准。在[多代理程式](https://platform.claude.com/docs/zh-TW/managed-agents/multiagent-orchestration)工作階段中，檢視會追蹤工作階段的主要執行緒，其中包含工作階段所執行的代理程式與其委派的代理程式之間交換的訊息。

| 按鍵                | 動作                                                               |
| ----------------- | ---------------------------------------------------------------- |
| Enter             | 將您的輸入以 `user.message` 事件傳送。Alt+Enter 或 Ctrl+J 可換行。               |
| Esc               | 在代理程式執行時中斷它（`user.interrupt`）。                                   |
| Ctrl+O            | 顯示或隱藏詳細資訊：工具輸入與結果、token 用量，以及狀態事件。`--verbose`（`-v`）會在啟動時即顯示詳細資訊。 |
| Page Up、Page Down | 捲動瀏覽對話紀錄。向上捲動會暫停追蹤；按 End 可恢復追蹤。                                  |
| Ctrl+C            | 中斷連線。在空白輸入行按下 Ctrl+D 也會中斷連線。                                     |

當工具呼叫正在等待您的核准時，輸入行會變更為 **Allow tool call?**。這會在 `always_ask` 政策下發生，或在 `auto` 政策下伺服器無法做出判定時發生。請選擇 **Yes**、**No** 或 **No, and tell the agent why**。CLI 會將您的選擇以 [`user.tool_confirmation`](https://platform.claude.com/docs/zh-TW/managed-agents/permission-policies#respond-to-confirmation-requests) 事件傳送，您輸入的任何理由則會作為其 `deny_message`。

如果工作階段已 `terminated` 或已刪除，檢視將為唯讀。

## 在瀏覽器中開啟工作階段檢視器

```bash CLI
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7 --web
```

`--web` 會從 `127.0.0.1` 上的本機伺服器提供 Console 的工作階段檢視器，印出其 URL，並在您的瀏覽器中開啟。加上 `--no-browser` 可略過開啟瀏覽器。您也可以從瀏覽器傳送訊息、中斷代理程式，以及允許或拒絕工具呼叫。與終端機檢視不同，瀏覽器檢視器會追蹤多代理程式工作階段的每一個執行緒。

該 URL 只能開啟一次，且必須在印出後兩分鐘內開啟。重新載入該分頁是可行的，但若要在其他地方開啟檢視器，請再次執行此命令。您的憑證永遠不會離開 CLI：頁面只會將請求傳送至本機的 `ant` 程序，再由該程序發出 API 請求。伺服器會持續執行，直到您按下 Ctrl+C 為止。