솔직히 말하면, 나는 Claude Code를 쓰면서 한동안 이런 식으로 작업했다. 터미널 창 하나에서 Claude한테 “이 버그 고쳐줘” 시키고, 끝나길 기다리다가 딴 창에서 또 다른 작업 시키고… 근데 문제는 세션이 뭘 하고 있는지 일일이 창 전환해서 확인해야 한다는 거였다. 여러 세션을 동시에 돌리다 보면 지금 어떤 세션이 내 입력을 기다리는지, 어떤 게 완료됐는지 파악하는 게 진짜 번거로웠다.
그러다 Claude Code의 에이전트 뷰(Agent View) 기능을 알게 됐다. 공식 문서를 직접 파보면서 정리한 내용을 공유한다. 여러 Claude Code 세션을 한 화면에서 관리하고 싶은 사람이라면 분명 도움이 될 거다.
참고로 에이전트 뷰는 Claude Code v2.1.139 이상이 필요한 연구 미리보기 기능이다. claude --version으로 버전부터 확인해 보자.
에이전트 뷰가 뭔데?
에이전트 뷰는 claude agents라는 명령 하나로 여는 백그라운드 세션 통합 관리 화면이다. 모든 Claude Code 세션이 상태별로 그룹화되어 테이블 형태로 표시된다.
화면 구조는 이렇게 생겼다:
고정됨
✽ clawd walk cycle Write assets/sprites/clawd-walk.png 3m
입력 필요
✻ power-up design needs input: double jump or wall climb? 1m
작업 중
✻ collision detection Edit src/physics/CollisionSystem.ts 2m
완료됨
✻ title screen result: menu, options, and credits done 9m
각 행에는 세션 이름, 현재 무엇을 하고 있는지, 마지막 변경 후 경과 시간이 표시된다. 아이콘 하나로 상태를 바로 파악할 수 있다는 게 핵심이다.
상태 아이콘 읽는 법
아이콘
의미
애니메이션
지금 도구 실행 중 또는 응답 생성 중
노란색
내 입력 기다리는 중 (권한 결정, 질문 답변 등)
녹색
작업 완료
빨간색
오류로 종료
회색
세션 중지됨
✻는 프로세스가 살아 있는 상태, ∙는 프로세스가 종료됐지만 연결하면 재시작하는 상태다. 이 차이를 알고 있으면 훨씬 직관적으로 읽힌다.
실제로 어떻게 쓰는가 빠른 시작 4단계
1단계: 에이전트 뷰 열기
claude agents
이게 전부다. 화면이 열리고 하단에 입력창이 생긴다. 언제든 Esc로 나갈 수 있고, 나가도 세션은 계속 실행된다.
2단계: 새 세션 디스패치
입력창에 프롬프트 치고 Enter. 그러면 새 백그라운드 세션이 시작되고 행으로 추가된다. 원하는 만큼 병렬로 실행할 수 있다. 여러 세션을 동시에 날리는 게 이 기능의 핵심이다.
3단계: 엿보기(Peek) 기능으로 상태 확인
행을 화살표 키로 선택하고 Space를 누르면 엿보기 패널이 열린다. 세션이 무엇을 하고 있는지, 무엇이 필요한지 요약해서 보여준다. 여기서 바로 답변을 입력하고 Enter를 치면 해당 세션으로 전송된다. 세션에 일일이 들어가지 않아도 된다.
객관식 질문이 온 경우엔 숫자 키로 선택지를 고를 수도 있다. 꽤 편하다.
4단계: 세션 연결 및 분리
전체 대화가 필요할 때는 행에서 Enter 또는 →를 눌러 연결한다. 그러면 일반 Claude Code 세션처럼 터미널을 완전히 넘겨받는다. 다시 에이전트 뷰로 돌아오려면 빈 프롬프트에서 ←를 누르면 된다. 분리해도 세션은 백그라운드에서 계속 돌아간다.
알아두면 쓸모 있는 세부 기능들
셸에서 직접 백그라운드 세션 시작
claude --bg "flaky test 원인 찾아서 수정해줘"
이렇게 하면 에이전트 뷰를 열지 않고 바로 백그라운드로 세션이 시작된다. 세션 ID도 출력해주기 때문에 나중에 claude attach <id>로 붙을 수 있다.
워크트리 자동 격리
에이전트 뷰에서 여러 세션을 디스패치하면, 두 세션이 같은 파일을 동시에 수정하는 충돌이 생길 수 있다. Claude Code는 이걸 방지하기 위해 세션이 파일을 편집해야 할 때 자동으로 git worktree를 만들어서 격리시킨다. 개발자 입장에서 신경 쓸 게 없다는 점이 좋다. 다만 세션을 삭제하면 워크트리도 같이 지워지니까, 삭제 전에 변경사항은 꼭 merge하거나 push해두자.
셸에서 세션 관리 명령어
claude agents # 에이전트 뷰 열기
claude attach <id> # 특정 세션에 연결
claude logs <id> # 세션 최근 출력 확인
claude stop <id> # 세션 중지
claude respawn --all # 중지된 세션 전체 재시작
claude rm <id> # 목록에서 세션 제거
특히 claude respawn --all은 노트북 절전 후 세션들이 중지됐을 때 유용하다.
마무리
에이전트 뷰는 한마디로 멀티태스킹 AI 작업을 위한 컨트롤 타워다. 혼자 여러 작업을 병렬로 돌리면서도 각 세션의 상태를 한눈에 파악하고, 필요할 때만 개입할 수 있다는 게 진짜 강점이다. 아직 연구 미리보기 단계라 인터페이스가 바뀔 수 있다고 하지만, 지금 써봐도 충분히 실용적이다.
Claude Code를 쓰면서 세션 관리에 피로감을 느꼈다면, claude agents 한 번 쳐보는 걸 추천한다. 공식 문서도 한국어로 잘 정리돼 있으니 같이 참고하면 좋다.
