들어가며
솔직히 고백하면, 나도 Claude Code로 여러 작업 돌리다가 “이 세션 지금 뭐 하고 있지?” 하고 탭 열 개를 뒤지던 시절이 있었다. 터미널 창 하나에 하나씩 붙잡고 있자니, 정작 AI가 일하는 동안 내가 더 바빴다. 근데 Anthropic이 딱 그 문제를 잡아냈다. Claude Code 에이전트 뷰(Agent View) — 여러 AI 코딩 세션을 한 화면에서 통합 관리하는 인터페이스다. 공식 문서(code.claude.com/docs/ko/agent-view) 기준으로 핵심만 정리해봤다.
⚠️ 요구 버전: Claude Code v2.1.139 이상 필요.
claude --version으로 먼저 확인하자.
에이전트 뷰가 뭔데?
claude agents 명령 하나로 열리는 전체 백그라운드 세션 통합 관제 화면이다. 무엇이 실행 중인지, 무엇이 내 입력을 기다리는지, 무엇이 완료됐는지 — 전부 한 테이블에 들어온다. 터미널이 연결되지 않아도 세션은 백그라운드에서 계속 실행되고, 세션 상태는 디스크에 저장돼 터미널을 껐다 켜도 날아가지 않는다.
버그 수정, PR 리뷰, 로그 조사처럼 독립적으로 병렬 처리 가능한 작업이 여러 개일 때 딱 맞는 도구다.
세션 상태 아이콘 한눈에 보기
에이전트 뷰에서 각 세션은 아이콘으로 상태를 표시한다.
| 아이콘 | 상태 | 의미 |
|---|---|---|
| 애니메이션 | 작업 중 | Claude가 도구 실행 또는 응답 생성 중 |
| 노란색 | 입력 필요 | 권한 결정이나 답변 대기 중 |
| 흐릿함 | 유휴 | 입력 대기 중, 특정 질문에 막힌 건 아님 |
| 녹색 | 완료 | 작업 성공적으로 끝남 |
| 빨간색 | 실패 | 오류로 종료됨 |
| 회색 | 중지됨 | Ctrl+X 또는 claude stop으로 중지됨 |
✻ / 애니메이션 ✽ → 프로세스 활성, 즉시 답변 가능
∙ → 프로세스 종료됐지만 다시 연결하면 이어서 실행
✢ → /loop 세션이 절전 중, 다음 실행 카운트다운 표시
핵심 기능 3가지
1. 엿보기(Peek) + 인라인 답변
행 선택 후 Space를 누르면 에이전트 뷰를 떠나지 않고 마지막 대화를 확인하고 바로 답변할 수 있다. 객관식 질문이면 숫자 키로 선택, 일반 질문이면 텍스트 입력 후 Enter. 답변 앞에 !를 붙이면 Bash 명령을 직접 전송할 수도 있다.
2. 세션 연결(Attach) / 분리(Detach)
Enter 또는 →를 눌러 세션에 풀 연결. 마치 claude를 직접 실행한 것처럼 터미널이 인수된다. 빈 프롬프트에서 ←를 누르면 분리되고 에이전트 뷰로 복귀 — 세션은 백그라운드에서 계속 돈다. Alt+1~Alt+9로 N번째 세션에 바로 점프도 가능.
3. 백그라운드 전환
# 현재 세션을 백그라운드로
/bg
# 백그라운드에서 새 세션 시작 (특정 디렉토리)
claude --bg "src/utils 타입 에러 전부 수정해줘"
# 특정 서브에이전트 지정
claude --agent code-reviewer --bg "PR 1234 리뷰 코멘트 반영해줘"
새 에이전트 디스패치하는 방법
에이전트 뷰 하단 입력창에 프롬프트 입력 후 Enter가 기본이다. 몇 가지 접두사 문법으로 더 세밀하게 제어할 수 있다.
| 입력 형식 | 효과 |
|---|---|
<agent-name> <prompt> | 사용자 정의 서브에이전트를 주 에이전트로 실행 |
@<agent-name> | 프롬프트 어디든 언급해서 서브에이전트 지정 |
@<repo> | 하위 저장소에서 세션 실행 |
/<skill> | 스킬을 프롬프트로 디스패치 |
#<PR번호> | 해당 PR 작업 세션 필터링 또는 선택 |
Shift+Enter | 디스패치 + 즉시 해당 세션에 연결 |
자주 쓰는 키보드 단축키
| 단축키 | 동작 |
|---|---|
↑ / ↓ | 행 이동 |
Space | 엿보기 패널 열기/닫기 |
Enter / → | 세션에 연결 |
← | 세션 분리, 에이전트 뷰로 복귀 |
Alt+1~9 | N번째 세션 바로 연결 |
Ctrl+S | 상태별 ↔ 디렉토리별 그룹화 전환 |
Ctrl+T | 세션 고정/해제 |
Ctrl+R | 세션 이름 변경 |
Ctrl+X | 세션 중지 (2초 내 한 번 더 → 삭제) |
Ctrl+G | $EDITOR에서 프롬프트 편집 |
? | 전체 단축키 목록 |
셸에서 세션 관리하는 명령어
claude agents # 에이전트 뷰 열기
claude attach <id> # 터미널에서 세션 연결
claude logs <id> # 최근 출력 확인
claude stop <id> # 세션 중지
claude respawn <id> # 중지된 세션 재시작
claude respawn --all # 전체 중지 세션 한 번에 재시작
claude rm <id> # 목록에서 세션 제거
주의할 점 (제한 사항)
- 속도 제한 공유: 백그라운드 세션도 구독 사용량을 동일하게 소모한다. 10개 병렬 실행 = 할당량 10배 속도로 소진.
- 로컬 전용: 머신이 절전/종료되면 실행 중인 세션은 중지된다.
claude respawn --all로 복구. - 워크트리 충돌 방지: 에이전트 뷰에서 디스패치된 세션은
.claude/worktrees/아래 격리된 git 워크트리에서 파일을 편집한다. 세션 삭제 전에 변경 사항 꼭 병합하거나 푸시할 것.
마무리
에이전트 뷰의 핵심 메시지는 하나다. “AI를 기다리지 말고, AI들을 지휘해라.” 이제 개발자의 역할은 코드를 직접 치는 게 아니라, 여러 AI 세션이 제대로 달리고 있는지 확인하고 필요할 때만 개입하는 것으로 바뀌고 있다. 아직 리서치 프리뷰 단계라 변경이 있을 수 있지만, 지금 당장 claude agents 한 번 쳐보는 건 공짜다.
👉 공식 문서: code.claude.com/docs/ko/agent-view
