---
title: 터미널에서 Managed Agents 세션에 연결하기
url: https://platform.claude.com/docs/ko/cli-sdks-libraries/cli/sessions-connect
description: ant CLI를 Claude Managed Agents 세션에 연결하여 트랜스크립트를 실시간으로 따라가고, 메시지를 보내고, 도구 호출을 허용 또는 거부하거나, 브라우저에서 세션 뷰어를 여세요.
---

`ant beta:sessions connect`는 터미널을 기존 Claude Managed Agents [세션](https://platform.claude.com/docs/ko/managed-agents/sessions)에 연결합니다. 이 명령은 세션의 "transcript"(트랜스크립트)를 불러오고, 에이전트가 작업하는 동안 이를 실시간으로 따라갑니다. 직접 개입할 수도 있습니다. 메시지를 보내거나, 에이전트를 중단하거나, 승인을 기다리는 도구 호출을 허용 또는 거부할 수 있습니다. `--web`을 사용하면 대신 브라우저에서 Claude Console의 세션 뷰어로 세션을 엽니다.

이 명령을 사용하려면 CLI 버전 1.32.0 이상이 필요합니다. CLI를 설치 또는 업데이트하고 인증하려면 [CLI 빠른 시작](https://platform.claude.com/docs/ko/cli-sdks-libraries/cli/quickstart)을 참조하세요.

## 세션에 연결하기

워크스페이스에 있는 세션의 ID를 전달하세요. ID는 생성 응답, `ant beta:sessions list` 또는 Console에서 복사할 수 있습니다.

```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/ko/cli-sdks-libraries/cli/scripting)를 참조하세요.

연결을 해제하려면 Ctrl+C를 누르세요. 세션은 계속 실행되며, 다시 연결하면 전체 기록을 불러옵니다.

## 세션 따라가기 및 조정하기

터미널 뷰는 대화를 실시간으로 보여 줍니다. 메시지와 도구 호출이 표시되며, 각 호출의 소요 시간과 결과도 함께 표시됩니다. 상태 표시줄은 세션이 실행 중인지, 유휴 상태인지, 또는 승인을 기다리고 있는지를 보여 줍니다. [멀티에이전트](https://platform.claude.com/docs/ko/managed-agents/multiagent-orchestration) 세션에서 뷰는 세션의 기본 스레드를 따라가며, 여기에는 세션이 실행하는 에이전트와 그 에이전트가 작업을 위임하는 에이전트 간에 주고받는 메시지가 포함됩니다.

| 키                  | 동작                                                                                           |
| ------------------ | -------------------------------------------------------------------------------------------- |
| 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` 정책에서 서버가 판단을 내리지 못한 경우에 발생합니다. **Yes**, **No** 또는 **No, and tell the agent why**를 선택하세요. CLI는 선택 내용을 [`user.tool_confirmation`](https://platform.claude.com/docs/ko/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은 출력된 후 2분 이내에 한 번만 열 수 있습니다. 해당 탭을 새로 고치는 것은 가능하지만, 다른 곳에서 뷰어를 열려면 명령을 다시 실행하세요. 자격 증명은 CLI 밖으로 나가지 않습니다. 페이지는 로컬 `ant` 프로세스에만 요청을 보내고, 이 프로세스가 API 요청을 수행합니다. 서버는 Ctrl+C를 누를 때까지 실행됩니다.