Agent view로 다중 세션 관리

기준일: 2026-07-26
난이도: 중급
공식 기준: Manage multiple agents with agent view, Run agents in parallel

Agent view는 claude agents로 여는 한 화면에서 여러 백그라운드 세션을 디스패치하고, 상태(작업 중 / 입력 필요 / 완료)를 보며, 필요할 때만 대화에 들어가는 UI입니다. research preview이며 Claude Code v2.1.139 이상이 필요합니다.

핵심 개념

개념	설명
Background session	터미널에 attach하지 않아도 supervisor가 유지하는 전체 Claude Code 대화
Dispatch	agent view 하단 입력에 프롬프트를 넣어 새 세션을 시작
Peek	Space로 최근 출력·대기 중 질문만 보고 짧게 답장
Attach / Detach	Enter/→로 전체 세션 진입, 빈 프롬프트에서 ←로 테이블 복귀
Worktree isolation	백그라운드 세션이 파일 수정 전 .claude/worktrees/ 등으로 격리 (설정에 따라 다름)

Subagent·Agent Teams와 다릅니다. Subagent는 한 대화 안의 위임 단위이고, Agent view 행은 독립 세션입니다. 비교: 서브 에이전트, 에이전트 팀.

선택 기준

상황	Agent view	다른 선택
서로 독립된 버그픽스·리뷰·조사를 동시에	적합	—
한 작업의 좁은 조사만 위임	—	Subagent
서로 메시지를 주고받으며 협업	—	Agent Teams
수십~수백 에이전트 오케스트레이션	—	Dynamic workflows

각 백그라운드 세션은 구독 사용량을 독립적으로 소모합니다. 다수 디스패치 전 공식 Limitations를 확인하세요.

실습

claude --version   # 2.1.139+
claude agents

1. 하단에 작업 설명을 입력하고 Enter — 새 행이 생깁니다.
2. 화살표로 행 선택 → Space peek → 답장 또는 권한 처리.
3. Enter/→ attach. 빈 프롬프트에서 ← detach.
4. 기존 포그라운드 세션에서는 빈 프롬프트 ← 또는 /bg로 백그라운드 이동.

셸에서 바로 백그라운드 시작:

claude --bg "investigate the flaky SettingsChangeDetector test"
claude attach <short-id>
claude agents --cwd ~/projects/my-app

세션 안에서 복사본 백그라운드(v2.1.212+):

/fork open a draft PR with the work so far

이전 버전의 /fork subagent 동작은 /subtask로 이동했습니다. 공식 문서 확인 권장.

도구에 입력할 프롬프트

지금 독립적으로 진행할 작업 3개를 제안해줘.
각 작업을 claude agents / claude --bg에 넣을 한 줄 프롬프트로 작성하고,
파일 충돌 가능성과 구독 사용량 위험을 함께 적어줘.
아직 세션을 시작하지 마.

체크리스트

• claude --version이 2.1.139 이상이다.
• 병렬 세션이 같은 파일을 동시에 쓰지 않도록 나눴다.
• worktree isolation / worktree.bgIsolation 정책을 이해했다.
• Needs input 알림 채널(terminal bell 등)을 확인했다.
• 완료 세션의 PR 라벨(#N) 또는 결과 요약을 검토했다.

다음 단계

• Goal으로 한 세션을 완료 조건까지 유지합니다.
• Dynamic workflows로 대규모 팬아웃을 스크립트화합니다.
• Worktrees 공식 문서로 병렬 체크아웃을 정리합니다.