터미널에서 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?