2026. 05. 13. / TECH · 9 min read
터미널 속 관제탑이 생겼다 — Claude Code 에이전트 뷰 완전 가이드
여러 Claude Code 세션을 한 화면에서 디스패치하고 관리하는 에이전트 뷰, 설치부터 단축키까지
claude agents.
이 명령 하나로 열리는 에이전트 뷰는 모든 백그라운드 Claude Code 세션을 한 화면에서 보여줍니다.
무엇이 실행 중인지, 무엇이 입력을 기다리는지, 무엇이 완료됐는지 — 터미널 여러 개를 뒤지지 않아도 됩니다.
에이전트 뷰가 뭐냐
한 줄로: 여러 Claude Code 에이전트를 동시에 디스패치하고 관리하는 CLI 관제탑입니다.
Claude Code v2.1.139 이상에서 동작하는 리서치 프리뷰 기능입니다.
# 버전 확인
claude --version
# 에이전트 뷰 실행
claude agents
버그 수정, PR 검토, 로그 분석처럼 독립적인 작업이 여러 개 있을 때 씁니다. 같이 해결해야 할 문제라면 그냥 세션에 연결해서 대화형으로 쓰면 됩니다.
화면에서 보이는 것들
에이전트 뷰를 열면 상태별로 그룹화된 세션 목록이 보입니다.
입력 필요
✻ power-up design needs input: double jump or wall climb? 1m
작업 중
✽ collision detection Edit src/physics/CollisionSystem.ts 2m
완료됨
∙ sound effects result: 14 SFX exported to assets/audio 4h
각 행의 아이콘이 두 가지를 알려줍니다.
표시기 색상 = 세션 상태:
| 표시기 | 상태 | 의미 |
|---|---|---|
| 애니메이션 | 작업 중 | Claude가 도구 실행 또는 응답 생성 중 |
| 노란색 | 입력 필요 | 권한 결정 또는 답변 대기 중 |
| 흐릿함 | 유휴 | 차단되지 않고 입력 대기 |
| 녹색 | 완료됨 | 작업 성공 |
| 빨간색 | 실패 | 오류로 종료 |
| 회색 | 중지됨 | Ctrl+X 또는 claude stop으로 중지 |
아이콘 모양 = 프로세스 상태:
✻/ 애니메이션✽→ 세션 활성, 즉시 답변 가능∙→ 프로세스 종료됨, 하지만 연결하면 이어서 실행✢→/loop세션이 반복 사이에 절전 중
엿보기와 빠른 답변
Space를 누르면 엿보기 패널이 열립니다.
세션이 뭘 하는지, 뭘 필요로 하는지 바로 보입니다. 여기서 답변 입력 후 Enter를 누르면 세션에 전송됩니다 — 세션에 직접 들어가지 않아도 됩니다.
슬랙 답장 보내듯 에이전트를 관리하는 느낌입니다.
객관식 질문이 있으면 숫자 키로 선택, Tab으로 제안된 답변 채우기도 됩니다. 답변 앞에 !를 붙이면 Bash 명령으로 전송합니다.
세션 연결과 분리
행에서 Enter 또는 →를 누르면 해당 세션에 연결됩니다. 에이전트 뷰가 사라지고 일반 claude 세션처럼 터미널을 완전히 차지합니다.
빈 프롬프트에서 ←를 누르면 다시 에이전트 뷰로 돌아옵니다.
분리해도 세션은 계속 실행됩니다. ←, Ctrl+C, Ctrl+D, /exit 모두 세션을 살려둡니다. 세션을 끝내려면 /stop을 써야 합니다.
새 에이전트 디스패치하기
에이전트 뷰 하단 입력에서 프롬프트를 입력하고 Enter.
# 셸에서 직접 백그라운드 세션 시작
claude --bg "investigate the flaky SettingsChangeDetector test"
# 특정 서브에이전트로 실행
claude --agent code-reviewer --bg "address review comments on PR 1234"
기존 대화형 세션을 백그라운드로 보내려면 세션 안에서 /bg를 실행합니다.
디스패치 입력에서 쓸 수 있는 접두사들:
| 입력 | 효과 |
|---|---|
<agent-name> <prompt> | 사용자 정의 서브에이전트로 실행 |
@<repo> | 특정 저장소에서 세션 실행 |
/<skill> | 스킬을 프롬프트로 디스패치 |
#<번호> 또는 PR URL | 해당 PR에서 작업하는 세션 선택 |
Shift+Enter | 디스패치하고 즉시 연결 |
파일 편집 격리
백그라운드 세션이 파일을 편집할 때 Claude는 자동으로 .claude/worktrees/ 아래의 격리된 git worktree로 이동합니다.
병렬 세션들이 같은 체크아웃을 읽을 수 있지만 각자 자신의 worktree에 씁니다.
세션을 삭제하면 worktree도 같이 제거됩니다. 삭제 전에 변경 사항을 병합하거나 푸시해야 합니다.
키보드 단축키 전체 정리
| 단축키 | 작업 |
|---|---|
↑ / ↓ | 행 간 이동 |
Enter | 세션 연결 또는 디스패치 |
Space | 엿보기 패널 열기/닫기 |
Shift+Enter | 디스패치 후 즉시 연결 |
→ | 세션 연결 |
← | 세션 분리 (빈 프롬프트에서) |
Alt+1..Alt+9 | N번째 세션에 직접 연결 |
Tab | 서브에이전트 검색 또는 제안 적용 |
Ctrl+S | 상태/디렉토리별 그룹화 전환 |
Ctrl+T | 세션 고정/해제 |
Ctrl+R | 세션 이름 변경 |
Ctrl+G | $EDITOR에서 프롬프트 편집 |
Ctrl+X | 세션 중지 (2초 내 재입력으로 삭제) |
Esc | 엿보기 닫기, 입력 지우기, 종료 |
? | 전체 단축키 목록 |
셸에서 세션 관리
claude attach <id> # 세션 연결
claude logs <id> # 최근 출력 확인
claude stop <id> # 세션 중지
claude respawn <id> # 중지된 세션 재시작
claude respawn --all # 모든 중지 세션 재시작
claude rm <id> # 목록에서 세션 제거
절전/종료 후 세션이 멈췄을 때 claude respawn --all로 한 번에 되살립니다.
알아두면 좋은 것들
토큰 사용량은 세션 수에 비례합니다. 백그라운드 세션은 각각 독립 세션이라 10개를 병렬로 돌리면 할당량을 10배 빠르게 소모합니다.
세션은 로컬입니다. 머신이 절전 상태가 되면 실행 중인 세션이 중지됩니다. 깨운 후 claude respawn --all로 재시작합니다.
프로세스가 종료돼도 트랜스크립트는 유지됩니다. 완료 후 약 1시간이 지나면 감독자 프로세스가 리소스를 확보하기 위해 프로세스를 중지하지만, 다음에 연결하면 중단된 위치에서 이어집니다.
터미널 여러 개 사이를 왔다 갔다 하던 작업 방식이 바뀝니다.
에이전트 뷰는 아직 리서치 프리뷰라 인터페이스가 변할 수 있지만, 방향성 자체는 명확합니다 — AI가 하나씩 순서대로 일하는 게 아니라 동시에 여러 작업을 처리하는 시대.
