SpyBara
Go Premium

agent-view.md 2026-05-10 23:03 UTC to 2026-05-11 23:00 UTC

295 added, 0 removed.

2026
Sun 31 06:39 Sat 30 06:23 Fri 29 06:38 Thu 28 06:37 Wed 27 06:42 Tue 26 06:33 Sun 24 06:25 Sat 23 06:18 Fri 22 06:33 Thu 21 06:36 Wed 20 06:35 Tue 19 06:34 Mon 18 23:59 Sun 17 01:01 Fri 15 22:58 Thu 14 17:02 Wed 13 23:01 Tue 12 22:57 Mon 11 23:00 Sun 10 23:03 Sat 9 04:57 Fri 8 22:00 Thu 7 22:59 Tue 5 23:00 Mon 4 22:58 Sat 2 18:14 Fri 1 18:19

여러 에이전트를 에이전트 뷰로 관리하기

하나의 화면에서 많은 Claude Code 세션을 디스패치하고 관리합니다. 에이전트 뷰는 모든 세션이 무엇을 하고 있는지, 어떤 세션이 입력을 필요로 하는지 보여줍니다.

claude agents로 열 수 있는 에이전트 뷰는 모든 백그라운드 세션을 위한 하나의 화면입니다: 무엇이 실행 중인지, 무엇이 입력을 필요로 하는지, 무엇이 완료되었는지를 보여줍니다. 새로운 세션을 디스패치하고, 트랜스크립트를 스크롤하는 대신 한눈에 상태를 확인하고, 필요할 때만 개입합니다. 세션은 터미널이 연결되지 않은 상태에서도 백그라운드에서 계속 실행됩니다.

버그 수정, 풀 리퀘스트 검토, 로그 조사 등 Claude가 동시에 작업할 수 있는 여러 독립적인 작업이 있을 때 에이전트 뷰를 사용합니다. 문제를 함께 해결하고 싶을 때는 세션에 연결하고 Claude Code를 대화형으로 평소처럼 사용합니다.

에이전트 뷰의 세션은 독립적으로 실행되며 사용자에게만 보고합니다. 서브에이전트, 에이전트 팀, 워크트리와 비교하려면 병렬로 에이전트 실행을 참조하세요.

이 페이지에서 다루는 내용:

빠른 시작

이 연습은 에이전트 뷰를 열고, 세션을 디스패치하고, 엿보기 패널에서 답변하고, 연결하는 방법을 보여줍니다.

1

에이전트 뷰 열기

셸에서 다음을 실행합니다:

claude agents

에이전트 뷰가 하단의 입력과 세션이 시작되면서 채워지는 테이블과 함께 열립니다. 언제든지 Esc를 눌러 종료합니다. 세션은 계속 실행됩니다.

2

세션 디스패치

입력에 프롬프트를 입력하고 Enter를 누릅니다. 새로운 세션이 시작되고 작업 중인지, 입력을 기다리는지, 완료되었는지를 보여주는 행으로 나타납니다. 원하는 만큼 많은 세션을 병렬로 실행하려면 반복합니다.

3

엿보기 및 답변

화살표 키로 행을 선택하고 Space를 눌러 세션이 무엇을 하고 있는지 또는 무엇이 필요한지 확인합니다. 답변을 입력하고 Enter를 눌러 에이전트 뷰를 떠나지 않고 전송합니다.

4

연결 및 분리

전체 대화를 원할 때 행에서 Enter 또는 를 눌러 연결합니다. 세션이 claude를 실행한 것처럼 정확히 터미널을 인수합니다. 빈 프롬프트에서 를 눌러 분리하고 테이블로 돌아갑니다.

기존 대화형 세션을 에이전트 뷰로 가져오려면 세션 내에서 /bg를 실행하거나, 빈 프롬프트에서 를 눌러 세션을 백그라운드로 보내고 한 단계에서 에이전트 뷰를 엽니다. 세션은 백그라운드에서 계속 실행되고 행으로 나타납니다. 셸에서 직접 새로운 백그라운드 세션을 시작하려면 claude --bg "<prompt>"를 실행합니다.

claude agentsclaude 대신 기본 진입점으로 사용할 수 있습니다: 에이전트 뷰에서 모든 작업을 디스패치하고, 전체 대화를 원할 때 연결하고, 를 눌러 테이블로 돌아갑니다.

에이전트 뷰로 세션 모니터링

claude agents를 실행하여 에이전트 뷰를 엽니다. 전체 터미널을 차지하고 상태별로 그룹화된 모든 세션을 나열하며, 고정된 세션과 입력이 필요한 세션이 맨 위에 있습니다. 각 행은 세션의 이름, 현재 활동 및 마지막 변경 이후 경과 시간을 보여줍니다.

목록은 머신에 전역이며 작업 중인 프로젝트나 워크트리에 관계없이 모든 백그라운드 세션을 포함합니다. 다른 터미널에서 열려 있는 대화형 세션은 백그라운드로 보낼 때까지 나타나지 않으며, 서브에이전트는 별도의 행으로 나열되지 않습니다.

고정됨
  ✽ clawd walk cycle          Write assets/sprites/clawd-walk.png           3m

검토 준비 완료
  ∙ jump physics              github.com/anthropics/example/pull/2048       2h

입력 필요
  ✻ power-up design           needs input: double jump or wall climb?       1m

작업 중
  ✽ collision detection       Edit src/physics/CollisionSystem.ts           2m
  ✢ playtest level 3          run 12 · all checkpoints cleared           in 4m

완료됨
  ✻ title screen              result: menu, options, and credits done       9m
  ∙ sound effects             result: 14 SFX exported to assets/audio       4h
  … 6 more

아이콘은 세션의 상태를 나타냅니다:

아이콘 상태 의미
애니메이션 작업 중 Claude가 적극적으로 도구를 실행하거나 응답을 생성 중
노란색 입력 필요 Claude가 입력을 기다리는 중, 보통 권한 결정 또는 답변
흐릿함 유휴 세션이 입력을 기다리는 중이지만 특정 질문에 차단되지 않음
녹색 완료됨 작업이 성공적으로 완료됨
빨간색 실패 작업이 오류로 종료됨
회색 중지됨 세션이 Ctrl+X 또는 claude stop으로 중지됨

아이콘의 모양은 기본 프로세스가 여전히 실행 중인지 여부를 나타냅니다. 또는 Claude가 작업 중일 때 애니메이션 는 세션이 활성 상태이고 즉시 답변할 수 있음을 의미합니다. 는 프로세스가 종료되었지만 여전히 엿보기, 답변 또는 연결할 수 있음을 의미합니다: Claude는 중단된 위치에서 세션을 다시 시작합니다. /loop 세션이 반복 사이에 절전 중이며, 행은 실행 횟수와 다음 반복까지의 카운트다운을 보여줍니다.

백그라운드 세션은 계속 작동하기 위해 열린 터미널이 필요하지 않습니다. 별도의 감독자 프로세스가 실행하므로 에이전트 뷰를 닫거나, 셸을 닫거나, 새로운 대화형 세션을 시작해도 디스패치된 작업은 계속됩니다.

세션은 디스크에 유지됩니다: 터미널을 닫거나 자동 업데이트가 발생해도 손실되지 않으며, claude agents를 다시 열면 모두 표시됩니다. 머신이 절전 상태이거나 종료되면 실행 중인 세션이 중지됩니다; claude respawn --all로 다시 시작합니다.

각 행의 한 줄 요약은 구성된 Haiku 클래스 모델에 의해 생성되므로 행은 세션이 무엇을 하고 있는지, 무엇이 필요한지, 또는 트랜스크립트를 열지 않고도 무엇을 생성했는지 알려줄 수 있습니다. 각 요약은 일반 제공자를 통한 하나의 짧은 Haiku 클래스 요청이며, 세션 자체와 동일한 데이터 사용 약관에 따라 청구되고 처리됩니다.

세션이 풀 리퀘스트를 열면 행은 PR 링크와 CI 검사의 상태 표시기를 보여줍니다. 대부분의 작업에서 이 행은 작업을 수집하는 방법입니다: 검사가 통과하면 풀 리퀘스트를 검토하고 병합합니다.

엿보기 및 답변

선택된 행에서 Space를 눌러 엿보기 패널을 엽니다. 세션이 필요로 하는 것, 최근 출력 및 열린 풀 리퀘스트를 보여줍니다. 대부분의 경우 이것으로 충분하며 전체 트랜스크립트를 열 필요가 없습니다.

엿보기 패널에 답변을 입력하고 Enter를 눌러 해당 세션으로 전송합니다. 세션이 객관식 질문을 하는 경우 엿보기 패널은 옵션을 표시하고 숫자 키를 눌러 하나를 선택할 수 있습니다. 다른 차단된 세션의 경우 Tab을 눌러 입력을 편집하기 전에 제안된 답변으로 채웁니다. 답변 앞에 !를 붙여 Bash 명령을 대신 전송합니다.

를 사용하여 패널을 닫지 않고 인접한 세션을 엿보거나 를 눌러 연결합니다.

세션에 연결

선택된 행에서 Enter 또는 를 눌러 연결하거나, Alt+1부터 Alt+9까지 눌러 포커스된 그룹의 N번째 세션에 직접 연결합니다. 에이전트 뷰는 claude를 실행한 것처럼 정확히 전체 대화형 세션으로 대체됩니다. 연결하면 Claude는 떠나 있는 동안 발생한 일에 대한 짧은 요약을 게시합니다.

연결된 동안 세션은 다른 Claude Code 세션처럼 작동합니다: 모든 명령, 키보드 단축키 및 기능이 작동합니다.

빈 프롬프트에서 를 눌러 분리하고 에이전트 뷰로 돌아갑니다. 대화 상자가 포커스를 가지고 있고 에 응답하지 않으면 Ctrl+Z를 눌러 즉시 분리합니다.

분리는 백그라운드 세션을 중지하지 않습니다: , Ctrl+C, Ctrl+D, Ctrl+Z/exit은 모두 실행 상태로 둡니다. 세션 내에서 세션을 종료하려면 /stop을 실행합니다.

에이전트 뷰를 사용한 후 빈 프롬프트에서 를 누르면 연결한 세션뿐만 아니라 모든 Claude Code 세션에서 작동합니다. 현재 세션이 미리 선택된 상태로 에이전트 뷰를 열어 터미널을 떠나지 않고 세션을 전환할 수 있습니다.

목록 구성

에이전트 뷰는 상태별로 세션을 그룹화하며, 입력이 필요한 세션이 작업 중이거나 완료된 세션 위에 있습니다. Ctrl+S를 눌러 대신 디렉토리별로 그룹화로 전환합니다. 선택 사항은 실행 간에 저장됩니다. 그룹 내에서 Ctrl+T로 세션을 맨 위에 고정하고, Shift+↑Shift+↓로 순서를 변경하거나, 그룹 헤더에서 Enter를 눌러 축소합니다. 세션을 제거하려면 Ctrl+X를 눌러 중지하고 2초 이내에 Ctrl+X를 다시 눌러 삭제합니다. 그룹 헤더에서 Ctrl+X를 누르면 확인 후 해당 그룹의 모든 세션이 삭제됩니다.

오래된 완료된 세션은 목록을 짧게 유지하기 위해 "… N more" 행으로 접힙니다. 실패 및 열린 풀 리퀘스트가 있는 세션은 항상 표시됩니다.

목록 필터링

디스패치 입력에 입력하여 디스패치 대신 필터링합니다:

필터 표시
a:<name> 명명된 에이전트를 실행하는 세션
s:<state> 주어진 상태의 세션, 예: s:blocked (입력이 필요한 세션)
#<number> 또는 PR URL 해당 풀 리퀘스트에서 작업하는 세션

키보드 단축키

에이전트 뷰에서 ?를 눌러 모든 단축키를 확인합니다. 가장 일반적인 것들:

단축키 작업
/ 행 간 이동
Enter 선택된 세션에 연결하거나, 입력에 텍스트가 있으면 디스패치
Space 선택된 세션의 엿보기 패널 열기 또는 닫기
Shift+Enter 디스패치하고 즉시 연결
선택된 세션에 연결
Alt+1..Alt+9 포커스된 그룹의 N번째 세션에 연결
Tab 모든 서브에이전트 검색 또는 강조된 제안 적용
Ctrl+S 상태와 디렉토리 간 그룹화 전환
Ctrl+T 선택된 세션 고정 또는 고정 해제
Ctrl+R 선택된 세션 이름 바꾸기
Ctrl+G $EDITOR에서 디스패치 프롬프트 열기
Ctrl+X 세션 중지; 2초 이내에 다시 눌러 삭제
Shift+↑ / Shift+↓ 선택된 세션 순서 변경
Esc 엿보기 패널 닫기, 입력 지우기 또는 종료
Ctrl+C 입력 지우기; 두 번 눌러 종료
? 모든 단축키 표시

새로운 에이전트 디스패치

에이전트 뷰에서 새로운 백그라운드 세션을 디스패치하거나, 기존 대화형 세션을 백그라운드로 보내거나, 셸에서 직접 시작할 수 있습니다.

에이전트 뷰에서

에이전트 뷰 하단의 입력에 프롬프트를 입력하고 Enter를 눌러 새로운 백그라운드 세션을 시작합니다. 세션은 프롬프트에서 자동으로 이름이 지정됩니다. 나중에 Ctrl+R로 이름을 바꿀 수 있습니다. 이미지를 프롬프트에 붙여넣어 작업에 스크린샷이나 다이어그램을 포함합니다.

프롬프트의 일부를 접두사로 붙이거나 언급하여 세션이 시작되는 방식을 제어합니다:

입력 효과
<agent-name> <prompt> 첫 번째 단어가 사용자 정의 서브에이전트 이름과 일치하면 해당 서브에이전트가 프론트매터의 구성으로 세션의 주 에이전트로 실행됨
@<agent-name> 프롬프트의 어디든지 사용자 정의 서브에이전트를 언급하여 주 에이전트로 실행
@<repo> 에이전트 뷰를 연 디렉토리 아래의 저장소를 언급하여 세션을 거기서 실행
/<skill> 스킬을 프롬프트로 디스패치하도록 제안
#<number> 또는 풀 리퀘스트 URL 세션이 이미 해당 PR에서 작업 중이면 디스패치 대신 선택
Shift+Enter 디스패치하고 즉시 새 세션에 연결

/를 입력하여 스킬을 디스패치합니다. 반복되는 작업을 스킬로 패키징하면 프롬프트를 다시 입력하지 않고 에이전트 뷰에서 동일한 워크플로우를 여러 번 시작할 수 있습니다. 빈 입력에서 Tab을 눌러 모든 디스패치 가능한 서브에이전트를 검색하거나, 제안이 표시될 때 강조된 제안을 적용합니다.

특정 디렉토리로 디스패치

새로운 세션은 에이전트 뷰를 연 디렉토리에서 실행됩니다. 다른 디렉토리를 대상으로 하려면:

  • 해당 디렉토리에서 claude agents를 엽니다.
  • 여러 저장소를 보유한 상위 디렉토리에서 claude agents를 열고 프롬프트에서 @<repo>로 하나를 언급하여 세션을 거기서 실행합니다.
  • 셸에서 디렉토리로 cd하고 claude --bg "<prompt>"를 실행합니다.

에이전트 뷰가 디렉토리별로 그룹화되면 강조된 행의 디렉토리가 디스패치 대상이 되므로 그룹으로 스크롤하고 경로를 다시 입력하지 않고 디스패치할 수 있습니다.

워크트리에서 파일 편집 격리

에이전트 뷰에서 디스패치된 세션은 기본적으로 작업 디렉토리를 공유하므로 두 에이전트가 동일한 파일을 편집하면 충돌할 수 있습니다. 이를 방지하기 위해 Claude Code는 에이전트 뷰에서 디스패치된 세션이 격리된 git 워크트리로 이동할 때까지 파일을 쓰지 못하도록 차단합니다. Claude는 파일을 편집해야 할 때 자동으로 처리합니다. 워크트리는 프로젝트 디렉토리 내의 .claude/worktrees/ 아래에 생성되고 세션을 삭제할 때 제거됩니다. 세션을 삭제하면 워크트리도 삭제되므로 삭제하기 전에 유지하려는 변경 사항을 병합하거나 푸시합니다.

서브에이전트가 시작된 방식에 관계없이 항상 자체 워크트리에서 실행되도록 하려면 프론트매터에서 isolation: worktree를 설정합니다.

세션 내에서

/background 또는 별칭 /bg를 실행하여 현재 대화를 분리하고 계속 실행합니다. /bg run the test suite and fix any failures와 같은 프롬프트를 전달하여 분리하기 전에 하나의 추가 명령을 보냅니다.

셸에서

--bg를 전달하여 백그라운드로 직접 이동하는 세션을 시작합니다:

claude --bg "investigate the flaky SettingsChangeDetector test"

특정 서브에이전트를 세션의 주 에이전트로 실행하려면 --bg--agent와 결합합니다:

claude --agent code-reviewer --bg "address review comments on PR 1234"

백그라운드로 보낸 후 Claude는 세션의 짧은 ID와 관리 명령을 인쇄합니다:

backgrounded · 7c5dcf5d
  claude agents             list sessions
  claude attach 7c5dcf5d    open in this terminal
  claude logs 7c5dcf5d      show recent output
  claude stop 7c5dcf5d      stop this session

셸에서 세션 관리

모든 백그라운드 세션에는 셸에서 사용할 수 있는 짧은 ID가 있습니다. 이 명령은 스크립팅이나 에이전트 뷰를 열고 싶지 않을 때 유용합니다.

명령 목적
claude agents 에이전트 뷰 열기
claude attach <id> 이 터미널에서 세션에 연결
claude logs <id> 세션의 최근 출력 인쇄
claude stop <id> 세션 중지. claude kill도 허용
claude respawn <id> 대화를 유지하면서 중지된 세션 다시 시작
claude respawn --all 모든 중지된 세션 다시 시작
claude rm <id> 목록에서 세션 제거

백그라운드 세션이 호스팅되는 방식

백그라운드 세션은 터미널 및 에이전트 뷰와 별도의 사용자별 감독자 프로세스에 의해 호스팅됩니다. 세션을 백그라운드로 보내거나 에이전트 뷰를 열 때 자동으로 시작되며 직접 관리하지 않습니다. 감독자 및 세션은 대화형 세션과 동일한 자격 증명으로 인증하고 모델 API 이상의 추가 네트워크 연결을 하지 않습니다.

각 백그라운드 세션은 자체 Claude Code 프로세스이며 터미널이 아닌 감독자에게 부모입니다. 적극적으로 작업 중이거나, 입력을 기다리거나, 터미널이 연결된 세션은 프로세스를 실행 상태로 유지합니다. 세션이 완료되고 약 1시간 동안 연결되지 않은 상태로 있으면 감독자는 리소스를 확보하기 위해 프로세스를 중지합니다. 트랜스크립트와 상태는 디스크에 유지되며, 다음에 연결하거나, 엿보거나, 답변할 때 감독자는 중단된 위치에서 새로운 프로세스를 시작합니다. 모든 세션이 완료되고 터미널이 연결되지 않으면 감독자 자체가 종료되고 세션을 백그라운드로 보내거나 에이전트 뷰를 열 때 다시 시작됩니다.

감독자는 디스크에 설치된 Claude Code 바이너리를 감시하고 일반 자동 업데이터가 교체한 후 새 버전으로 다시 시작합니다. 이는 네트워크 검사가 아닌 로컬 파일 감시입니다. 백그라운드 세션은 분리된 프로세스이므로 다시 시작을 통해 계속 실행되고 새 감독자는 다시 연결됩니다.

세션 상태는 Claude Code 구성 디렉토리 아래에 저장됩니다. CLAUDE_CONFIG_DIR을 설정하면 감독자는 ~/.claude 대신 해당 디렉토리를 사용하고 자체 세션이 있는 별도의 인스턴스로 실행됩니다.

경로 내용
~/.claude/daemon.log 감독자 로그
~/.claude/daemon/roster.json 실행 중인 백그라운드 세션 목록, 다시 시작 후 다시 연결하는 데 사용됨
~/.claude/jobs/<id>/state.json 에이전트 뷰에 표시되는 세션별 상태

백그라운드 에이전트 및 에이전트 뷰를 완전히 끄려면 disableAgentView 설정true로 설정하거나 CLAUDE_CODE_DISABLE_AGENT_VIEW 환경 변수를 설정합니다. 관리자는 관리 설정을 통해 이를 적용할 수 있습니다.

문제 해결

에이전트 뷰가 세션 없이 열림

에이전트 뷰는 첫 번째 세션을 디스패치할 때까지 비어 있습니다. 하단의 입력에 프롬프트를 입력하고 Enter를 누릅니다.

머신을 깨운 후 세션이 중지됨으로 표시됨

백그라운드 세션은 절전 또는 종료를 견디지 못합니다. 중지된 세션에 연결하거나, 엿보거나, 답변하면 중단된 위치에서 다시 시작됩니다. 모두 한 번에 다시 시작하려면 claude respawn --all을 실행합니다.

세션이 연결 후 응답이 느림

세션이 완료되고 약 1시간 동안 연결되지 않으면 감독자는 리소스를 확보하기 위해 프로세스를 중지합니다. 연결하면 중단된 위치에서 새로운 프로세스를 시작하는데 시간이 걸립니다. 작업 중이거나 입력을 기다리는 세션은 이런 식으로 중지되지 않습니다.

.claude/worktrees/가 채워지고 있음

워크트리는 세션을 삭제할 때 제거됩니다. 세션이 정리 없이 종료되면 프로젝트 디렉토리에서 git worktree list로 남은 항목을 나열하고 각각을 git worktree remove <path>로 제거합니다. 워크트리 정리를 참조합니다.

제한 사항

에이전트 뷰는 연구 미리보기입니다. 주의할 현재 제한 사항:

  • 속도 제한 적용: 백그라운드 세션은 대화형 세션과 동일하게 구독 사용량을 소모하므로 10개의 에이전트를 병렬로 실행하면 할당량을 10배 빠르게 소모합니다.
  • 세션은 로컬: 백그라운드 세션은 머신에서 실행되고 절전 또는 종료 시 중지됩니다.
  • 워크트리는 세션과 함께 삭제됨: 자체 워크트리에서 파일을 편집한 세션을 삭제하기 전에 변경 사항을 병합하거나 푸시합니다.

다음 단계

에이전트 뷰를 이해했으므로 이러한 관련 기능을 살펴봅니다:

  • 에이전트를 병렬로 실행: 에이전트 뷰를 서브에이전트, 에이전트 팀 및 워크트리와 비교합니다
  • 서브에이전트: 사용자 정의 프롬프트, 도구 및 격리를 사용하여 재사용 가능한 에이전트 구성을 정의합니다
  • 에이전트 팀: 서로 메시지를 주고받는 여러 세션을 조정합니다
  • 웹의 Claude Code: 로컬 대신 관리되는 클라우드 환경에서 세션을 실행합니다