앤트로픽이 Claude Code에 Agent View를 넣었습니다. `claude agents` 한 줄이면 백그라운드에서 도는 모든 세션이 상태별로 정리된 대시보드 하나로 열려요. 탭 여러 개 띄워놓고 "어느 게 끝났더라" 하던 거 이제 안 해도 됩니다.
며칠 써보고 공식 문서랑 같이 정리했어요. 길지만 이거 하나면 됨.
■ 한 줄 요약
· 열기: `claude agents`
· 백그라운드로 보내기: 세션 안에서 `/bg`, 셸에서 `claude --bg "작업 내용"`
· 평소엔 Space로 미리보기, 필요할 때만 Enter로 들어가서 처리
■ 화면 구성
세션이 상태 그룹으로 묶여서 위에서부터 정렬됨:
· Pinned — 고정한 세션 (맨 위)
· Ready for review — PR 열린 세션
· Needs input — 내 입력/승인 기다리는 중
· Working — 작업 중
· Completed — 끝남/실패/중단 묶음
각 줄 맨 앞 아이콘 "색"으로 상태 구분:
· 애니메이션 = 작업 중
· 노랑 = 입력 대기
· 흐림 = idle (다음 지시 기다림)
· 초록 = 완료 / 빨강 = 실패 / 회색 = 중단됨
아이콘 "모양"은 프로세스 상태:
· ✻ 살아있음 (바로 응답)
· ∙ 프로세스 종료됨 (들어가면 멈춘 지점부터 재개)
· ✢ /loop 세션이 다음 반복까지 자는 중
■ 키보드 (이것만 알면 됨)
· ↑/↓ : 줄 이동
· Space : 미리보기 패널 — 마지막 출력이나 물어보는 질문만 보여줌
· Enter : 해당 세션 진입(attach). 입력창에 글자 있으면 새 세션 dispatch
· → 진입 / ← 빈 입력에서 누르면 빠져나와 목록으로
· Shift+Enter : 새 세션 띄우고 바로 진입
· Ctrl+S : 상태별 ↔ 디렉토리별 그룹 전환
· Ctrl+T : 핀 고정 (idle여도 프로세스 안 죽음)
· Ctrl+R : 이름 변경
· Ctrl+X : 중단, 2초 안에 한 번 더 = 삭제
· ? : 단축키 전체 보기
미리보기 패널에서 바로 답장도 됨. 객관식 질문이면 숫자 키로 선택, `!` 붙이면 Bash 명령 전송.
■ 새 세션 띄우는 3가지
1) Agent View 입력창에 프롬프트 + Enter
(Enter 칠 때마다 "새 세션" 생성. 후속 메시지 아님 주의)
2) 세션 안에서 `/bg` 또는 `/background` — 지금 대화를 그대로 백그라운드로
예) `/bg 테스트 다 돌리고 실패한 거 고쳐줘`
3) 셸에서 `claude --bg "flaky한 결제 테스트 원인 찾아줘"`
· 이름 붙이기: `claude --bg --name "test-fix" "..."`
· 서브에이전트로: `claude --agent code-reviewer --bg "PR 1234 리뷰 반영"`
■ 셸에서 관리 (대시보드 안 열고)
· `claude attach <id>` 진입
· `claude logs <id>` 최근 출력
· `claude stop <id>` 중단
· `claude respawn <id>` 재시작 (대화 유지)
· `claude rm <id>` 목록에서 제거
· `claude daemon status` 백그라운드 관리 프로세스(supervisor) 상태
■ 알아둘 점 (중요)
· 백그라운드 세션은 터미널 닫아도 supervisor라는 별도 프로세스가 계속 돌림. 셸 꺼도 작업 진행됨.
· 파일 수정 전에 알아서 `.claude/worktrees/` 안 git worktree로 격리함 → 병렬 세션이 같은 코드 건드려도 충돌 안 남.
· ⚠️ Agent View에서 세션 삭제(Ctrl+X 두 번)하면 그 worktree도 통째로 지워짐. 커밋/푸시 안 한 변경 날아가니 머지부터.
· ⚠️ rate limit: 백그라운드도 구독 사용량 똑같이 먹음. 10개 병렬 = 토큰 10배 속도로 소진.
· 로컬에서만 돎. 잠자기(sleep)는 버티는데 컴퓨터 종료하면 멈춤 (다시 attach하면 재개).
■ 버전 / 플랜
· Claude Code v2.1.139 이상 (research preview)
· Pro / Max / Team / Enterprise / API 에서 사용 가능
· `--cwd` 프로젝트별 필터는 2.1.141+, `--model`/`--permission-mode` 같은 플래그는 2.1.142+
· 끄려면 `disableAgentView` 설정 또는 `CLAUDE_CODE_DISABLE_AGENT_VIEW` 환경변수
며칠 써보니 "버그 수정 / PR 리뷰 / 깨지는 테스트 조사" 3개를 한 번에 던져두고, 다른 창에서 일하다가 노란 불 뜬 것만 들어가서 처리하는 흐름이 진짜 편함. 터미널 탭 지옥 드디어 끝.