[Claude Code] Agents View - 여러 에이전트를 관리하는 기능 추가

Claude Code Agent View, 권한까지 한번에 풀고 쓰기

Anthropic이 2026년 5월 11일 공개한 Agent View는 Claude Code에서 여러 백그라운드 세션을 한 화면에서 관리하는 기능. 터미널 탭 여러 개 띄울 필요 없이 디스패치, 모니터링, attach를 한 곳에서 처리 가능. 여기에 권한 모드를 bypassPermissions로 설정해두면 매번 확인 프롬프트 없이 자율 실행까지 가능함.

이 글에서는 Agent View 사용법과, 이를 자율 모드로 굴리기 위한 설정 방법을 정리.

---

Agent View란?

여러 Claude Code 세션을 동시에 돌리고 한 화면에서 통합 관리하는 기능. 버그 수정, PR 리뷰, 테스트 조사 같은 독립적인 작업을 병렬로 디스패치하고, 입력이 필요한 세션만 골라 응답 가능.

요구사항

• Claude Code v2.1.139 이상
• Pro, Max, Team, Enterprise, Claude API 플랜 (Research Preview)
• 버전 확인: claude --version

핵심 개념

• 백그라운드 세션: 터미널 없이 supervisor 프로세스가 계속 돌림.
• Peek 패널: 세션 attach 없이 미리보기 + 답장 가능.
• Attach: 세션의 전체 대화로 진입. 빠져나와도 백그라운드 유지.
• Worktree 격리: 여러 에이전트가 같은 파일 건드리지 않게 git worktree로 자동 분리.

---

기본 사용법

1. Agent View 열기

claude agents

하단 입력창 + 세션 목록 테이블이 뜸. Esc로 나가도 세션은 계속 살아있음.

2. 새 세션 디스패치

입력창에 프롬프트 작성 → Enter. 새 백그라운드 세션이 생성되고 행으로 추가됨. 반복하면 병렬로 여러 세션 가능.

특수 문법:

입력	효과
<agent-name> <prompt>	커스텀 subagent를 메인 에이전트로 실행
@<agent-name>	프롬프트 중간에서 subagent 멘션
@<repo>	특정 레포지토리에서 세션 실행
/<skill>	스킬 디스패치
#<번호> 또는 PR URL	해당 PR 작업 중인 세션 선택
Shift+Enter	디스패치 즉시 attach

3. Peek과 Reply

행 선택 후 Space → Peek 패널 오픈. 세션 상태, 최근 출력, 열린 PR 확인 가능. 패널에서 바로 답장 작성 후 Enter. 객관식 질문이면 숫자 키로 선택. Bash 명령 보내려면 ! 접두사.

4. Attach / Detach

• Enter 또는 →: 세션에 attach. 전체 대화 진입.
• 빈 프롬프트에서 ←: detach. Agent View로 복귀.
• 세션 내부 종료: /stop.
• detach 단축키들(←, Ctrl+C, Ctrl+D, Ctrl+Z, /exit): 모두 세션은 살아있음.

5. 셸에서 직접 백그라운드 시작

claude --bg "플레이키 테스트 조사해줘"
claude --agent code-reviewer --bg "PR 1234 리뷰 코멘트 처리"

---

세션 상태 아이콘

아이콘	상태	의미
애니메이션	Working	도구 실행 / 응답 생성 중
노란색	Needs input	입력 대기 (권한 결정, 답변 등)
흐림	Idle	입력 대기지만 특정 질문 막힘 없음
초록색	Completed	작업 성공 종료
빨간색	Failed	오류 종료
회색	Stopped	Ctrl+X 또는 claude stop으로 중단

---

주요 단축키

키	동작
↑ / ↓	행 이동
Space	Peek 패널 토글
Enter	Attach (또는 입력 있으면 dispatch)
Shift+Enter	Dispatch + 즉시 attach
Alt+1~Alt+9	N번째 세션 attach
Ctrl+S	그룹핑 전환 (상태별 ↔ 디렉터리별)
Ctrl+T	세션 핀 고정
Ctrl+R	세션 이름 변경
Ctrl+X	세션 중단 (2초 내 한번 더 → 삭제)
?	모든 단축키 보기

---

셸에서 세션 관리

claude agents             # Agent View 열기
claude attach <id>        # 세션 attach
claude logs <id>          # 최근 출력
claude stop <id>          # 세션 중단
claude respawn <id>       # 중단된 세션 재시작
claude respawn --all      # 전체 재시작
claude rm <id>            # 세션 제거

---

bypassPermissions 설정으로 자율 모드 만들기 (수정)

~/.zshrc에 아래 두줄로 설정하고 claude, claudea 로 용도에 따라 실행하는게 제일 편함.
적용은 터미널 재시작 필요함.

alias claude='claude --dangerously-skip-permissions'
alias claudea='claude agents --dangerously-skip-permissions'

---

Agent View + bypassPermissions 조합 워크플로

1. 사전 준비: 프로젝트에 .claude/settings.local.json 생성, defaultMode: "bypassPermissions" 설정.
2. 별칭 정리: 위험한 별칭 제거 후 셸 재로드.
3. Agent View 진입: claude agents.
4. 병렬 디스패치: 독립 작업 여러 개 입력. 모두 권한 프롬프트 없이 자율 실행.
5. 모니터링: 상태 아이콘 보며 완료/실패/입력 필요 세션 확인.
6. Peek & Reply: 입력 필요한 세션만 Space로 미리보기 후 응답.
7. 결과 수확: 완료 세션의 PR 머지 또는 attach로 전체 대화 확인.

---

주의사항

• 사용량 폭주: 백그라운드 세션도 구독 사용량 동일 차감. 10개 병렬 = 10배 빠른 소진.
• 로컬 한계: 백그라운드 세션은 머신에서 돌고, 절전/종료 시 멈춤. 복구는 claude respawn --all.
• 자동 종료: 완료 후 1시간 미접속 시 supervisor가 프로세스 회수. attach 시 자동 재시작.
• Worktree 정리: 세션 삭제 시 worktree도 같이 사라짐. 머지/푸시 먼저 할 것.
• bypassPermissions 자체 위험: 격리된 컨테이너/VM이 아닌 환경에선 rm -rf 같은 실수도 그대로 실행됨. 가능하면 auto 또는 acceptEdits 사용 권장.
• 조직 정책: 관리자가 disableBypassPermissionsMode: "disable"로 막아둔 환경에선 설정도 플래그도 무효.

---

마무리

Agent View는 "여러 Claude를 동시에 부리는" 패러다임을 CLI에 가져옴. 여기에 권한 모드를 자율 모드로 박아두면 진짜 "디스패치하고 잊어버리기" 워크플로가 완성됨.

다만 자율성과 안전성은 trade-off. 회사 코드베이스라면 bypassPermissions보다 auto 또는 acceptEdits가 현실적인 선택. 진짜 격리된 실험 환경에서만 bypassPermissions 사용 권장.

공식 문서: https://code.claude.com/docs/en/agent-view