터미널에서 Managed Agents 세션에 연결하기
ant CLI를 Claude Managed Agents 세션에 연결하여 트랜스크립트를 실시간으로 따라가고, 메시지를 보내고, 도구 호출을 허용 또는 거부하거나, 브라우저에서 세션 뷰어를 여세요.
ant beta:sessions connect는 터미널을 기존 Claude Managed Agents 세션에 연결합니다. 이 명령은 세션의 "transcript"(트랜스크립트)를 불러오고, 에이전트가 작업하는 동안 이를 실시간으로 따라갑니다. 직접 개입할 수도 있습니다. 메시지를 보내거나, 에이전트를 중단하거나, 승인을 기다리는 도구 호출을 허용 또는 거부할 수 있습니다. --web을 사용하면 대신 브라우저에서 Claude Console의 세션 뷰어로 세션을 엽니다.
이 명령을 사용하려면 CLI 버전 1.32.0 이상이 필요합니다. CLI를 설치 또는 업데이트하고 인증하려면 CLI 빠른 시작을 참조하세요.
세션에 연결하기
워크스페이스에 있는 세션의 ID를 전달하세요. ID는 생성 응답, ant beta:sessions list 또는 Console에서 복사할 수 있습니다.
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7--web 없이 실행하면 이 명령에는 대화형 터미널이 필요합니다. 스크립트에서는 대신 ant beta:sessions:events stream과 ant 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 정책에서 서버가 판단을 내리지 못한 경우에 발생합니다. Yes, No 또는 No, and tell the agent why를 선택하세요. CLI는 선택 내용을 user.tool_confirmation 이벤트로 보내며, 입력한 이유가 있으면 이를 deny_message로 함께 보냅니다.
세션이 terminated 상태이거나 삭제된 경우 뷰는 읽기 전용입니다.
브라우저에서 세션 뷰어 열기
ant beta:sessions connect sesn_011CZkZAtmR3yMPDzynEDxu7 --web--web은 127.0.0.1의 로컬 서버에서 Console의 세션 뷰어를 제공하고, 해당 URL을 출력한 뒤 브라우저에서 엽니다. 브라우저를 열지 않으려면 --no-browser를 추가하세요. 브라우저에서도 메시지를 보내고, 에이전트를 중단하고, 도구 호출을 허용 또는 거부할 수 있습니다. 터미널 뷰와 달리 브라우저 뷰어는 멀티에이전트 세션의 모든 스레드를 따라갑니다.
URL은 출력된 후 2분 이내에 한 번만 열 수 있습니다. 해당 탭을 새로 고치는 것은 가능하지만, 다른 곳에서 뷰어를 열려면 명령을 다시 실행하세요. 자격 증명은 CLI 밖으로 나가지 않습니다. 페이지는 로컬 ant 프로세스에만 요청을 보내고, 이 프로세스가 API 요청을 수행합니다. 서버는 Ctrl+C를 누를 때까지 실행됩니다.
Was this page helpful?