Claude Code를 조금 오래 쓰다 보면 터미널 탭이 늘어납니다. 하나는 테스트 수정, 하나는 문서 정리, 하나는 PR 리뷰, 또 하나는 로그 조사. 각 세션이 어디까지 갔는지 기억하는 일도 점점 부담이 됩니다.
Anthropic이 공개한 Agent view in Claude Code ↗는 이 문제를 정면으로 다룹니다. 여러 Claude Code 세션을 한 화면에서 보고, 필요한 순간에만 개입하는 CLI 대시보드입니다.
이 글은 작성 시점 2026-05-13 · 공식 블로그와 Agent View 문서 ↗, GeekNews 요약 ↗ 스냅숏 기준으로 정리했습니다.
Agent View가 해결하는 문제
기존에는 Claude Code 작업을 병렬로 돌리려면 여러 터미널 탭, tmux, 기억력에 의존해야 했습니다. 어떤 세션이 아직 작업 중인지, 어떤 세션이 권한 승인을 기다리는지, 어떤 세션이 결과를 냈는지 한눈에 보기 어려웠습니다.
Agent View는 이 상태를 하나의 목록으로 모읍니다.
- 새 에이전트 세션을 바로 시작
- 실행 중인 세션 상태 확인
- 입력이 필요한 세션에 짧게 답변
- 필요할 때 전체 세션으로 attach
- 완료된 세션과 PR 결과 확인
핵심은 “모든 세션을 계속 지켜보기”가 아니라, Claude가 사용자를 필요로 할 때만 개입하는 방식으로 바꾸는 데 있습니다.
시작하기
Agent View는 터미널에서 다음 명령으로 엽니다.
claude agents기존 Claude Code 세션 안에서는 /bg 또는 /background로 현재 세션을 백그라운드로 보낼 수 있습니다.
/bg새 작업을 바로 백그라운드 세션으로 시작하려면 --bg를 씁니다.
claude --bg "flaky test 원인을 조사하고 수정 후보를 정리해줘"특정 서브에이전트를 메인 에이전트로 실행할 수도 있습니다.
claude --agent code-reviewer --bg "PR 1234 리뷰 코멘트 반영해줘"백그라운드로 보낸 뒤 Claude는 짧은 세션 ID와 관리 명령을 출력합니다. 이후에는 claude attach <id>로 다시 붙고, claude logs <id>로 최근 출력만 확인하거나, claude stop <id>로 세션을 멈출 수 있습니다.
한 화면에서 전체 세션 보기
Agent View를 열면 백그라운드 세션들이 상태별로 묶여 보입니다. 공식 블로그의 첫 번째 이미지는 이 “목록 화면”을 보여줍니다.
각 행에는 세션 이름, 최근 작업 요약, 입력 필요 여부, 마지막 상호작용 시간이 표시됩니다. 공식 문서에 따르면 상태는 대략 다음처럼 구분됩니다.
| 상태 | 의미 |
|---|---|
| Working | Claude가 도구를 실행하거나 응답 생성 중 |
| Needs input | 권한 승인이나 사용자 답변을 기다리는 중 |
| Idle | 특정 질문은 없지만 입력을 기다리는 중 |
| Completed | 작업 완료 |
| Failed | 오류로 종료 |
| Stopped | 사용자가 중지한 세션 |
목록 요약은 Haiku급 모델로 생성되며, 작업 중에는 일정 간격으로 갱신됩니다. 그래서 전체 transcript를 열지 않아도 “지금 뭐 하는 중인지”를 대략 파악할 수 있습니다.
Peek: 들어가지 않고 답하기
Agent View의 좋은 점은 매번 세션에 들어가지 않아도 된다는 점입니다. 선택한 행에서 Space를 누르면 Peek 패널이 열리고, 최근 출력이나 필요한 질문을 볼 수 있습니다.
세션이 결정을 기다리고 있다면 Peek 패널에서 바로 답할 수 있습니다. 객관식 질문은 숫자로 고르고, 일반 질문은 입력창에 답한 뒤 Enter를 누르면 됩니다. 막힌 세션에는 Tab으로 제안 답변을 채운 뒤 수정해서 보낼 수도 있고, !로 시작하면 Bash 명령을 보낼 수도 있습니다.
옆 세션을 훑을 때도 패널을 닫을 필요가 없습니다. Peek가 열린 상태에서 ↑ / ↓를 누르면 인접한 세션의 최근 상태로 바로 이동합니다.
더 깊게 봐야 할 때만 Enter나 →로 attach합니다. attach하면 일반 Claude Code 세션처럼 전체 대화를 이어가고, 빈 프롬프트에서 ←를 누르면 다시 Agent View로 돌아옵니다. 다이얼로그가 포커스를 잡아 ←가 먹지 않는다면 Ctrl+Z로 즉시 detach할 수 있습니다.
새 에이전트 Dispatch 방식
Agent View 하단 입력창에 프롬프트를 쓰고 Enter를 누르면 매번 새 백그라운드 세션이 시작됩니다. 같은 입력창에 이어서 또 입력하면 기존 세션에 후속 메시지를 보내는 것이 아니라, 두 번째 세션을 새로 띄우는 구조입니다.
공식 문서 기준으로 dispatch 입력에는 몇 가지 특별한 패턴을 섞을 수 있습니다.
| 입력 패턴 | 동작 |
|---|---|
<agent-name> <prompt> | 첫 단어가 커스텀 subagent 이름이면 그 subagent를 메인 에이전트로 실행 |
@<agent-name> | 프롬프트 중간에서 특정 subagent를 메인 에이전트로 지정 |
@<repo> | Agent View를 연 상위 디렉터리 아래의 특정 저장소에서 실행 |
/<skill> | Skill 기반 작업 프롬프트로 dispatch |
#<number> 또는 PR URL | 해당 PR을 작업 중인 세션이 있으면 새 세션 대신 그 세션 선택 |
Shift+Enter | dispatch 직후 바로 attach |
예를 들어 여러 저장소를 담은 상위 폴더에서 claude agents를 열었다면, @blog Agent View 글의 단축키 섹션을 보강해줘처럼 특정 저장소를 지정할 수 있습니다. 반복 작업은 Skill로 만들어 두면 Agent View에서 /skill-name 형태로 빠르게 다시 호출할 수 있습니다.
입력창은 항상 dispatch만 하는 공간은 아닙니다. 그냥 텍스트를 입력하면 목록 필터처럼 동작할 수 있고, a:<name>으로 특정 에이전트가 실행 중인 세션만 보거나 s:<state>로 상태별 필터를 걸 수 있습니다. 예를 들어 s:blocked는 입력을 기다리는 세션만 추려 보는 식입니다. PR 번호나 PR URL로 관련 세션을 찾는 흐름도 가능합니다.
백그라운드 세션은 어떻게 유지되나
공식 문서에서 중요한 부분은 백그라운드 세션이 터미널에 묶이지 않는다는 점입니다. 별도 supervisor process가 세션을 관리하므로, Agent View를 닫거나 셸을 닫아도 세션은 계속 실행될 수 있습니다.
flowchart TB
A[claude agents] --> B[Agent View]
B --> C[새 백그라운드 세션 dispatch]
D[기존 세션] -->|/bg 또는 ←| C
C --> E[Supervisor process]
E --> F[독립 실행 세션들]
F --> G[Needs input / Working / Completed]
G --> B또 하나 중요한 점은 파일 수정 격리입니다. 문서에 따르면 백그라운드 세션이 일반 작업 디렉터리에서 파일을 수정해야 할 때, Claude는 자동으로 .claude/worktrees/ 아래의 격리된 git worktree로 세션을 옮깁니다. 병렬 세션이 같은 체크아웃을 동시에 건드려 충돌을 만드는 일을 줄이기 위한 설계입니다.
다만 이 worktree는 세션을 삭제하면 함께 제거될 수 있으므로, 남길 변경은 merge하거나 push한 뒤 정리해야 합니다. 커스텀 subagent frontmatter에 isolation: worktree를 지정하면 해당 subagent는 시작 방식과 무관하게 항상 worktree 격리로 실행할 수 있습니다.
운영 관점에서는 몇 가지 파일 위치도 알아두면 좋습니다. supervisor 로그는 ~/.claude/daemon.log, 실행 중 세션 목록은 ~/.claude/daemon/roster.json, 세션별 상태는 ~/.claude/jobs/<id>/state.json에 저장됩니다. 조직이나 개인 환경에서 기능을 끄고 싶다면 disableAgentView 설정이나 CLAUDE_CODE_DISABLE_AGENT_VIEW 환경변수를 사용할 수 있습니다.
셸에서 세션 관리하기
Agent View를 열지 않아도 백그라운드 세션은 셸에서 직접 다룰 수 있습니다.
claude agents
claude attach <id>
claude logs <id>
claude stop <id>
claude respawn <id>
claude respawn --all
claude rm <id>claude respawn --all은 머신 슬립이나 재부팅 뒤 멈춘 백그라운드 세션을 한꺼번에 되살릴 때 유용합니다. 반대로 세션을 목록에서 지우려면 claude rm <id>를 쓰는데, 앞서 말한 것처럼 worktree에 남겨둔 변경이 있다면 삭제 전에 먼저 보존해야 합니다.
자주 쓸 단축키
처음에는 모든 단축키를 외울 필요는 없습니다. 아래 정도만 알아도 흐름을 잡을 수 있습니다.
| 단축키 | 동작 |
|---|---|
↑ / ↓ | 세션 이동 |
Enter | 선택한 세션 attach 또는 새 작업 dispatch |
Space | Peek 패널 열기/닫기 |
Shift+Enter | dispatch 후 바로 attach |
→ | 선택한 세션 attach |
← | attach된 세션에서 Agent View로 돌아가기 |
Alt+1..Alt+9 | 현재 그룹의 1~9번째 세션으로 바로 attach |
Tab | 빈 입력에서는 subagent 탐색, 입력 중에는 제안 적용 |
Ctrl+S | 상태별/디렉터리별 그룹 전환 |
Ctrl+T | 세션 pin/unpin |
Ctrl+R | 세션 이름 변경 |
Ctrl+G | dispatch 프롬프트를 $EDITOR에서 작성 |
Ctrl+X | 세션 중지, 2초 안에 한 번 더 누르면 삭제 |
Shift+↑ / Shift+↓ | 선택 세션 순서 변경 |
Esc | Peek 닫기, 입력 비우기, 또는 종료 |
Ctrl+C | 입력 비우기, 두 번 누르면 종료 |
? | 전체 단축키 보기 |
어떤 작업에 잘 맞을까
Agent View는 “하나의 어려운 문제를 Claude와 오래 토론하는” 상황보다, 독립적인 작업을 여러 개 던지고 결과를 회수하는 상황에 더 잘 맞습니다.
예를 들면 다음과 같습니다.
- 여러 버그 후보를 동시에 조사
- 각기 다른 접근으로 리팩터링 실험
- PR 리뷰, 테스트 수정, 문서 보완을 병렬 실행
- 반복적으로 도는 PR babysitter나 대시보드 업데이트 감시
- 큰 작업 중간에 별도 코드베이스 질문을 빠르게 던지기
반대로 코드베이스 전반을 크게 바꾸는 작업을 여러 세션에 동시에 맡기면 충돌 가능성이 커집니다. worktree 격리가 있더라도, 최종 통합 비용은 사용자가 관리해야 합니다.
기존 Claude Code 기능과의 관계
Agent View는 Claude Code Remote Control과도 결이 이어집니다. Remote Control이 “로컬 세션을 다른 기기에서 이어 쓰는 방법”이라면, Agent View는 “여러 로컬·백그라운드 세션을 한 화면에서 관리하는 방법”에 가깝습니다.
모바일 푸시 알림과도 잘 맞습니다. 긴 작업은 Agent View로 백그라운드에 보내고, 사용자 개입이 필요할 때는 푸시로 확인하는 식의 운영이 가능해집니다.
또 Claude Code Agent Teams처럼 역할을 나눠 여러 에이전트를 쓰는 흐름과도 맞닿아 있습니다. 다만 Agent View의 단위는 “세션 목록 관리”이고, subagent나 agent team 내부의 하위 에이전트를 각각 별도 행으로 보여주는 것은 아닙니다.
에이전트끼리 직접 메시지를 주고받고, 공유 task list를 보며 일을 나눠 가져가야 한다면 Agent View보다 Agent Teams 쪽이 더 맞습니다. 공식 Agent Teams 문서는 teammate들이 서로 이름으로 메시지를 보내고, lead에게 idle 알림을 보내며, 공유 task list를 통해 작업을 claim한다고 설명합니다. 반면 Agent View는 여러 독립 세션을 사용자가 관제하고 필요할 때 Peek·Attach로 개입하는 쪽에 가깝습니다.
써볼 때 기억할 점
실사용 관점에서 가장 중요한 포인트는 세 가지입니다.
claude agents를 기본 진입점처럼 쓸 수 있습니다.- 짧은 확인은 Peek에서 끝내고, 깊은 개입만 attach하면 됩니다.
- 병렬 실행은 편하지만, quota·권한·worktree 통합 비용을 같이 봐야 합니다.
특히 Pro, Max, Team, Enterprise, Claude API 플랜에서 사용할 수 있고, 일반 rate limit가 적용됩니다. 많은 세션을 동시에 dispatch하면 생산성은 올라갈 수 있지만 사용량도 빠르게 늘어납니다.
또 백그라운드 세션은 클라우드가 아니라 로컬 머신 위에서 돕니다. 머신이 슬립되거나 꺼지면 실행 중이던 세션은 멈출 수 있고, 이때는 다시 켠 뒤 claude respawn <id> 또는 claude respawn --all로 이어가야 합니다.
마무리
Agent View는 Claude Code가 단일 터미널 도구에서 작업 큐를 가진 에이전트 운영 환경으로 이동하고 있다는 신호처럼 보입니다.
작업을 하나씩 붙잡고 기다리는 대신, 여러 세션을 백그라운드에 보내고, 상태를 훑고, 필요한 순간에만 답하는 방식입니다. Claude Code를 이미 자주 쓰고 있다면 claude agents는 바로 시험해볼 만한 기능입니다.