Claude Code Agent View 공개 — 병렬 AI 코딩의 새 표준

터미널 창을 5개 열고, Alt+Tab을 반복하며, 어느 세션이 끝났는지 일일이 확인하고 있으신가요? 지금까지 Claude Code로 병렬 작업을 하는 유일한 방법이 그 방식이었습니다. 앤트로픽이 2026년 5월 11일, 그 문제를 공식적으로 해결했습니다.

Claude Code Agent View — 모든 세션을 단일 화면에서 관리하는 CLI 내장 대시보드가 리서치 프리뷰로 공개됐습니다. 오늘은 이 기능이 왜 나왔고, 어떻게 쓰며, 실무에서 무엇을 주의해야 하는지를 정리해드립니다.

Claude Code Agent View 개요

Agent View가 풀어주는 문제

비유하자면, 이전까지 Claude Code 병렬 작업은 주방에 셰프가 10명 있는데 주방장이 없는 상태와 같았습니다. 각자 요리는 열심히 하지만, 무엇이 어디까지 됐는지 파악하려면 직접 돌아다녀야 했죠.

구체적으로, 기존 멀티 터미널 워크플로우에는 세 가지 구조적 한계가 있었습니다.

첫째, 가시성 문제. 세션이 완료됐는지, 사용자 입력을 기다리는지, 오류가 났는지 — 직접 각 창을 클릭해봐야 알 수 있었습니다. 10개 세션이면 10번 클릭입니다.

둘째, 컨텍스트 스위칭 비용. 터미널 창 전환은 단순 클릭이 아닙니다. 각 세션의 현재 상태를 다시 파악하는 인지 비용이 누적됩니다.

셋째, 세션 복구 불가. 터미널을 닫거나 맥북이 슬립에 들어가면 백그라운드 세션은 그대로 소멸했습니다. 재시작 수단이 없었습니다.

Agent View는 이 세 가지를 한 번에 해결합니다.

핵심 기능과 명령어

Agent View 명령어와 단축키

진입 방법

두 가지 경로로 Agent View에 접근할 수 있습니다.

# 터미널에서 직접 진입
claude agents

# 기존 Claude Code 세션 내에서
← (왼쪽 화살표 키)

Agent View를 열면 현재 활성화된 모든 세션이 상태별로 그룹화되어 표시됩니다.

세션 상태 6종

waiting for input 상태의 세션은 Agent View 리스트에서 바로 인라인 답글을 입력할 수 있습니다. 해당 창으로 이동할 필요가 없습니다.

단축키

• Spacebar: 마지막 턴 Peek — 전환 없이 해당 세션의 최근 출력을 미리봅니다
• Enter 또는 →: 해당 세션에 완전히 attach하여 전체 트랜스크립트를 확인합니다

백그라운드 세션 명령어

# 현재 세션을 백그라운드로 이동
/bg

# 처음부터 백그라운드 세션으로 시작
claude --bg

# 슬립/셧다운 후 모든 세션 재시작
claude respawn --all

/goal 명령어 (신규 추가)

Agent View와 함께 /goal 명령어도 함께 추가됐습니다. 세션에 완료 목표를 명시적으로 설정하면, Agent View에서 해당 세션의 진척도를 더 명확하게 파악할 수 있습니다.

아키텍처 — Supervisor 프로세스의 의미

비유하자면, 이전 세션은 종이에 적힌 메모였습니다. 창을 닫으면 메모가 사라집니다. Agent View의 세션은 금고에 보관된 파일입니다. 창을 닫아도 파일은 남아 있습니다.

기술적으로는 별도 Supervisor 프로세스가 세션을 유지합니다.

• 터미널을 닫아도 백그라운드 세션은 계속 실행됩니다
• Claude Code를 새로 열어도 이전 세션에 재접속할 수 있습니다
• 디스크 영구화로 Claude Code 자동 업데이트 중에도 세션이 손실되지 않습니다
• 머신이 슬립하거나 셧다운되면 세션은 정지하지만, claude respawn --all 명령으로 일괄 복구됩니다

이는 외부 도구(opcode, Claude-Code-Agent-Monitor, so-agentbar 등)에 의존하지 않고 CLI 자체에 내장된 구조입니다. 별도 설치, 별도 권한, 별도 모니터링 없이 claude agents 하나로 작동합니다.

사용 전 반드시 알아야 할 Rate Limit

Rate Limit 주의사항

Agent View를 본격적으로 활용하기 전, 가장 중요한 경고를 먼저 드립니다.

백그라운드 세션은 인터랙티브 세션과 동일한 quota를 소비합니다.

세션 10개를 병렬로 실행하면 quota도 10배 빠르게 차감됩니다. 단일 세션 기준으로 월 한도를 설계했다면, 병렬 10개 워크플로우에서는 예상보다 훨씬 빠르게 한도에 도달할 수 있습니다.

실무 적용 시 권장 접근 방법입니다.

1. 세션 수를 의식적으로 제한하세요. "필요할 것 같아서" 10개 백그라운드를 띄우는 것은 quota를 10배 빠르게 소진하는 가장 빠른 방법입니다. 실제로 병렬 처리가 필요한 작업에만 적용하세요.

2. 완료된 세션은 즉시 종료하세요. completed 상태 세션도 Supervisor에 등록된 상태로 남아있습니다. 정리 습관이 quota 관리의 핵심입니다.

3. /goal 명령어로 작업 범위를 명확히 설정하세요. 목표가 명확한 세션은 더 빠르게 완료되어 불필요한 quota 소비를 줄입니다.

지원 플랜: Pro / Max / Team / Enterprise / Claude API 모두 지원합니다. 조직 계정의 경우 managed settings로 관리자가 Agent View를 비활성화할 수 있습니다.

어떤 워크플로우에 적합한가

Agent View는 모든 작업에 적합하지 않습니다. 다음 상황에서 효과가 극대화됩니다.

적합한 케이스

독립적인 작업 병렬 처리. 서로 의존성이 없는 모듈을 각각 다른 세션에서 개발할 때, Agent View로 진행 상황을 한 눈에 파악할 수 있습니다.

장시간 실행 작업. 테스트 실행, 문서 생성, 리팩토링 등 수십 분이 걸리는 작업을 백그라운드로 이동하고, 포그라운드에서 다른 작업을 진행할 수 있습니다.

여러 프로젝트 동시 관리. 클라이언트 A 프로젝트와 사이드 프로젝트를 동시에 진행할 때, 세션 전환을 Agent View 단 하나로 통합할 수 있습니다.

재시작이 잦은 환경. 맥북을 자주 슬립/깨우는 패턴이라면 claude respawn --all 하나로 전 세션을 복구할 수 있어 편의성이 크게 향상됩니다.

주의가 필요한 케이스

순차 의존성이 강한 작업. A가 완료돼야 B를 시작할 수 있는 작업은 병렬화의 이점이 없습니다. 오히려 세션 수만 늘어나 quota만 낭비됩니다.

quota에 민감한 플랜 사용자. Pro 플랜의 경우 월 사용량이 한정되어 있습니다. 병렬 세션 수에 비례하여 소비량이 늘어나므로, 한도 관리가 필수입니다.

설치 및 버전 요구사항

Agent View를 사용하려면 Claude Code v2.1.139 이상이 필요합니다.

# 현재 버전 확인
claude --version

# 업데이트 (npm 설치 기준)
npm update -g @anthropic-ai/claude-code

버전 확인 후 v2.1.139 미만이라면 업데이트가 필수입니다. 구버전에서는 claude agents 명령어 자체가 작동하지 않습니다.

마치며

Claude Code Agent View는 외부 도구 없이 CLI 하나로 병렬 에이전트를 관리하는 공식 솔루션입니다. 리서치 프리뷰 단계이므로 기능 변경 가능성이 있지만, 지금 당장 claude agents를 실행해볼 수 있습니다.

저도 현재 content-automation 프로젝트에서 콘텐츠 생성과 발행 파이프라인을 병렬로 운영하고 있는데, Agent View가 그 워크플로우를 얼마나 단순화할 수 있을지 직접 확인해볼 계획입니다.

Rate Limit만 주의한다면, 이 기능은 Claude Code 사용 경험을 의미있게 바꿀 수 있습니다.

Claude Code Agent View 핵심 요약: 2026-05-11 공개된 리서치 프리뷰. claude agents로 진입, 6가지 세션 상태 실시간 확인, /bg로 백그라운드 전환, Supervisor 프로세스로 세션 영구화. v2.1.139 이상 필수. 백그라운드 세션도 quota 동일 차감에 주의.

Claude Code를 활용한 실무 워크플로우에 관심이 있으시다면, QJC 블로그를 구독해주세요.

자주 묻는 질문 (FAQ)

Q: Agent View는 무료로 사용할 수 있나요?

Claude Code를 지원하는 모든 플랜(Pro, Max, Team, Enterprise, Claude API)에서 사용 가능합니다. 별도 추가 비용은 없지만, 백그라운드 세션이 quota를 동일하게 소비하므로 사용량 관리는 필요합니다.

Q: 맥북을 재시작하면 모든 세션이 사라지나요?

슬립/셧다운 시 세션은 정지하지만 사라지지 않습니다. claude respawn --all 명령어로 모든 세션을 일괄 재시작할 수 있습니다. Supervisor 프로세스가 세션 상태를 디스크에 영구 저장하기 때문입니다.

Q: 조직에서 Agent View를 제한할 수 있나요?

네. Team 또는 Enterprise 플랜의 관리자는 managed settings를 통해 조직 차원에서 Agent View를 비활성화할 수 있습니다.

Q: 리서치 프리뷰는 정식 출시와 어떻게 다른가요?

앤트로픽의 리서치 프리뷰는 기능이 공개되어 실제 사용 가능하지만, 피드백에 따라 기능 변경이나 삭제가 이루어질 수 있는 단계입니다. 프로덕션 워크플로우에 통합하기 전, 변경 가능성을 인지하고 사용하시기를 권장합니다.

참고 자료