Claude Code Agent view 출시
여러 Claude Code 세션을 한 화면에서 추적·전환할 수 있는 Agent view 가 Research Preview 로 공개되었습니다. 어떤 세션이 입력 대기 중이고 작업 중이며 끝났는지 한눈에 확인하고, peek·`/bg`·`claude --bg` 로 백그라운드 작업을 늘릴 수 있습니다.
이 글은 공식 문서를 바탕으로 요약·정리한 내용입니다.
핵심 요약
Agent view 는 Claude Code CLI 안에서 동시에 돌아가는 여러 에이전트 세션을 한 화면에 모아 보고 관리하는 인터페이스입니다. 5월 11일 Research Preview 로 공개되었고, 여러 세션을 병렬로 굴리는 개발자가 어느 세션이 입력을 기다리고 있는지, 어느 세션이 아직 작업 중인지, 어느 세션이 끝났는지 를 따로 추적할 필요 없이 한 곳에서 파악할 수 있게 만드는 게 목적입니다.
주요 기능
-
세션을 한 화면에 모아 보기 — See everything at once
여러 Claude Code 세션을 띄우면 각각이 어떤 상태인지 별도 터미널 창이나 IDE 탭을 오가며 확인해야 했습니다. Agent view 는 각 세션을 행으로 표시하고 세션 식별자, 입력 대기 여부, 마지막 응답 요약, 마지막 상호작용 시각을 한 줄에 보여줘 상태 파악과 다음 행동 결정을 빠르게 만듭니다.
-
터미널을 떠나지 않고 peek — Peek and reply without leaving
세션을 전환하지 않고도 한 세션의 마지막 턴 결과만 미리 들여다볼 수 있습니다. PR 결과처럼 제목만 빠르게 훑어 어느 세션이 입력을 기다리는지 식별한 뒤, 그 자리에서 답변을 입력해 진행시킬 수 있습니다.
-
무엇이든 백그라운드로 — Background anything
진행 중인 세션을 백그라운드로 보내고 싶을 때는
/bg슬래시 명령으로 현재 세션을 Agent view 에 그대로 등록할 수 있습니다. 처음부터 포그라운드 상호작용 없이 작업을 던지고 싶을 때는 터미널에서claude --bg [task]한 줄로 새 백그라운드 세션을 띄울 수 있습니다. -
여러 아이디어를 동시에 dispatch
Agent view 가 상태 추적을 떠맡으므로 한 사람이 동시에 띄울 수 있는 세션 수가 늘어납니다. 블로그에서는 스킬을 곁들인 동시 세션 확장, 장기 실행 에이전트와 예약된 작업의 진행 가시화, 관련 세션 간 이동, 끝난 작업을 상태 표시로 인지하는 네 가지 사용 패턴이 소개됩니다.
claude agents 와 /agents 는 다르다
이름이 비슷해 자주 혼동되는 지점입니다. 공식 문서도 “Despite the similar name, this is separate from claude agents” 라고 못 박을 정도로 중요한 구분입니다.
| 명령 | 어디서 실행 | 무엇을 보여주나 |
|---|---|---|
claude agents | 터미널 (CLI) | agent view — 백그라운드 세션 들의 상태 화면 |
/agents | 진행 중 세션 안 | subagent 패널 — Running 탭(현재 세션의 살아있는 서브에이전트) + Library 탭(커스텀 서브에이전트 생성·편집) |
/tasks | 진행 중 세션 안 | 현재 세션의 백그라운드에서 도는 모든 항목 추적 |
세 명령이 가리키는 대상이 다릅니다. agent view 는 세션 단위, /agents 는 세션 안의 서브에이전트 단위, /tasks 는 현재 세션 내부의 백그라운드 작업 입니다.
Claude Code 의 병렬 작업 방식과 agent view 의 위치
Claude Code 가 여러 작업을 동시에 진행하는 방법은 다섯 가지로 갈리고, agent view 는 그중 하나입니다. “누가 코디네이트하나 · 워커끼리 통신하나 · 같은 파일을 건드리나” 기준으로 골라 씁니다.
| 접근법 | 코디네이터 | 워커 간 통신 | 파일 격리 | 적합한 상황 |
|---|---|---|---|---|
| Subagents | 메인 세션 (델리게이트 후 결과 회수) | 메인 세션 경유만 | 선택적 worktree | 부수 작업이 메인 대화를 검색 결과·로그·파일로 채울 우려가 있을 때 |
Agent view (claude agents) | 사용자 (백그라운드 dispatch) | ❌ 사용자에게만 보고 | 자동 worktree (파일 편집 시) | 독립 작업 여러 개를 던져두고 상태만 훑다가 입력 필요할 때만 개입 |
| Agent teams | Lead 세션 (실험적 · 기본 비활성) | ✅ 공유 task list + 직접 메시지 | ❌ 직접 분할 필요 | 프로젝트를 쪼개 lead 가 분배하고 감독시키고 싶을 때 |
| Worktrees | 사용자 본인 | ❌ | ✅ 별도 git checkout | 여러 세션을 직접 굴리거나 서브에이전트가 겹치는 파일을 편집할 때 |
/batch | 계획 단계에서 5~30 서브에이전트로 분할 — 각각 PR 생성 | ❌ | ✅ worktree-isolated | 한 줄로 지시 가능한 리포 전반 마이그레이션·기계적 리팩터 |
agent view 의 차별점은 자동 worktree 통합: dispatch 된 세션이 파일 편집을 시작하는 순간 자체 worktree 로 격리되어 충돌이 묵묵히 차단됩니다.
결합 가능: agent view 로 dispatch 한 세션이 안에서 또 자체 서브에이전트를 띄우는 구성도 됩니다. 즉 위 다섯 가지는 배타적이지 않습니다.
시작하기
사전 요구 — Claude Code v2.1.139 이상. claude --version 으로 확인. 이전 버전(예: v2.1.137)의 claude agents 는 서브에이전트 목록만 출력하고 종료하는 별개 명령이라 TUI 화면이 뜨지 않습니다. 업데이트는 claude install stable 또는 claude install 2.1.139.
- 터미널에서
claude agents실행 — Agent view 가 열림 - 진행 중인 Claude Code 세션에서는 왼쪽 화살표 키로 세션과 Agent view 사이를 전환
- 기존 세션을 백그라운드로 보내려면 그 세션에서
/bg - 새 백그라운드 세션을 띄우려면
claude --bg [task] - 자세한 옵션은 code.claude.com/docs/en/agent-view 공식 문서 참조
알아두면 좋은 점
- Research Preview — opt-in 으로 동작 — 자동 활성화되지 않으며,
claude agents를 실행해야 노출됩니다. 정식 출시 전 단계라 동작·UX 가 변경될 가능성이 있습니다. - 사용 가능 플랜 — Pro·Max·Team·Enterprise·Claude API. 추가 결제 없이 각 플랜의 표준 rate limit 안에서 동작합니다.
- 3P provider(Bedrock·Vertex·Foundry 등) 동작 여부는 docs 미명시 — 공식 agent view 문서는 지원 플랜을 Pro·Max·Team·Enterprise·Claude API 로만 명시하고, Amazon Bedrock·Google Vertex AI·Microsoft Foundry·Claude Platform on AWS 같은 3P provider 환경에서의 동작 여부에 대해 별도 안내가 없습니다. 해당 환경 사용자는 본인 환경에서 직접 검증이 필요합니다.
- 여러 세션 동시 실행 = 사용량 가속 — 동시 세션 수가 늘면 같은 시간에 토큰 소모도 빠르게 누적됩니다. 각 플랜의 표준 rate limit 안에서 동작하므로, 백그라운드 dispatch 를 시작할 때는 한도 잔량을 함께 모니터링하는 게 안전합니다.
- Remote Control 과 별개의 기능 — 앞서 발표된 Claude Code Remote Control 이 원격에서 Claude Code 세션을 띄우는 배포 모델이라면, Agent view 는 내 터미널 안에 여러 세션을 모아 관리 하는 인터페이스입니다.
자주 묻는 질문
Claude Code Agent view 는 무엇인가요?
Claude Code CLI 안에서 동시에 진행 중인 여러 에이전트 세션을 한 화면에 모아 관리하는 인터페이스입니다. 각 세션이 입력 대기 중인지, 작업 중인지, 끝났는지를 행 단위 상태 표시로 한눈에 확인할 수 있습니다.
어떻게 활성화하나요?
터미널에서 `claude agents` 를 실행하면 Agent view 가 열립니다. 진행 중인 Claude Code 세션 안에서는 왼쪽 화살표 키로 세션과 Agent view 사이를 전환할 수 있습니다.
어떤 플랜에서 사용할 수 있나요?
Pro·Max·Team·Enterprise·Claude API 플랜에서 사용 가능합니다. 별도 추가 결제 없이 표준 rate limit 안에서 동작합니다.
백그라운드 세션은 어떻게 만드나요?
기존 세션을 백그라운드로 전환하려면 `/bg` 슬래시 명령을, 처음부터 새 백그라운드 세션을 띄우려면 터미널에서 `claude --bg [task]` 를 실행합니다.
Research Preview 상태가 의미하는 게 무엇인가요?
정식 출시 전 일부 사용자에게 opt-in 으로 먼저 공개되는 단계입니다. 정식 출시 시점에 동작·UX·사용 가능 플랜이 달라질 수 있으니, 운영 환경의 핵심 워크플로에 묶기 전에 안정성과 변경 가능성을 함께 평가하는 것을 권장합니다.