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 teamsLead 세션 (실험적 · 기본 비활성)✅ 공유 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.

  1. 터미널에서 claude agents 실행 — Agent view 가 열림
  2. 진행 중인 Claude Code 세션에서는 왼쪽 화살표 키로 세션과 Agent view 사이를 전환
  3. 기존 세션을 백그라운드로 보내려면 그 세션에서 /bg
  4. 새 백그라운드 세션을 띄우려면 claude --bg [task]
  5. 자세한 옵션은 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·사용 가능 플랜이 달라질 수 있으니, 운영 환경의 핵심 워크플로에 묶기 전에 안정성과 변경 가능성을 함께 평가하는 것을 권장합니다.