터미널에서 Managed Agents 세션에 연결하기
터미널에서 Managed Agents 세션에 연결하기
ant beta:sessions connect가 여러분의 터미널을 기존 Claude Managed Agents 세션에 연결해 줘요. 세션의 대화 기록을 불러와 에이전트가 작업하는 동안 실시간으로 따라가요. 여기에 끼어들 수도 있어요: 메시지를 보내고, 에이전트를 중단하거나, 승인을 기다리는 도구 호출을 허용/거부할 수 있어요. --web을 쓰면 대신 Claude Console의 세션 뷰어를 브라우저에서 열어요.
출처: 문서
본문
이 명령은 CLI 버전 1.32.0 이상이 필요해요. CLI 설치·업데이트와 인증은 CLI 퀵스타트를 참고하세요.
세션에 연결하기
워크스페이스에 있는 세션의 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은 Console의 세션 뷰어를 127.0.0.1의 로컬 서버로 제공하고, URL을 출력한 뒤 브라우저에서 열어요. 브라우저를 열지 않으려면 --no-browser를 추가하세요. 브라우저에서도 메시지를 보내고, 에이전트를 중단하고, 도구 호출을 허용/거부할 수 있어요. 터미널 뷰와 달리 브라우저 뷰어는 멀티에이전트 세션의 모든 스레드를 따라가요.
URL은 출력된 후 2분 안에 한 번 열 수 있어요. 그 탭을 새로고침하는 것은 되지만, 다른 곳에서 뷰어를 열려면 명령을 다시 실행하세요. 여러분의 자격 증명은 CLI를 떠나지 않아요: 페이지는 요청을 로컬 ant 프로세스에만 보내고, 그 프로세스가 API 요청을 해요. 서버는 Ctrl+C를 누를 때까지 실행돼요.