2026년 5월 19일 기준으로 Claude Code의 agent 관련 변화에서 먼저 이해해야 할 것은 Agent View입니다. claude agents 명령으로 여는 research preview 화면이며, 여러 Claude Code 로컬 백그라운드 세션을 한곳에서 보고 관리하는 용도입니다.
하지만 모든 “Claude Code agent” 질문이 같은 경로로 이어지는 것은 아닙니다. 여러 로컬 세션을 한 화면에서 보려면 Agent View, 세션들이 팀처럼 협업해야 하면 Agent Teams, 한 세션 안에서 전문 helper가 필요하면 subagents, Anthropic이 실행 런타임을 맡아야 하면 Managed Agents, 제품 안에 agent를 만들려면 Agent SDK 또는 Messages API를 봐야 합니다.
| 필요한 일 | 먼저 볼 경로 | 현재 경계 |
|---|---|---|
| 여러 Claude Code 작업을 한 화면에서 보고 싶다 | Agent View와 claude agents | 로컬 백그라운드 세션용 research preview |
| Claude Code 팀원들이 서로 조율해야 한다 | Agent Teams | 실험 기능, 기본 비활성 |
| 한 세션 안에서 전문 helper를 쓰고 싶다 | subagents | 리뷰, 테스트, 조사에 적합 |
| Anthropic이 agent runtime을 호스팅해야 한다 | Managed Agents | Platform/API 경로 |
| 직접 agent 제품을 만들고 싶다 | Agent SDK 또는 Messages API | 애플리케이션 설계 선택 |
먼저 멈춤 규칙을 적용하세요. 같은 파일을 여러 세션이 건드리거나, 하나의 연속된 추론이 필요하거나, 쿼터가 빠듯하거나, 로컬 worktree의 기존 변경을 아직 이해하지 못했다면 Agent View로 병렬화하지 말고 단일 Claude Code 세션에 머무르는 편이 안전합니다.
빠른 답
Agent View는 Claude Code의 로컬 백그라운드 세션 대시보드입니다. 실제 사용 순서는 간단합니다. Claude Code를 업데이트하고, 버전을 확인하고, claude agents를 열고, 독립적인 작은 작업만 병렬로 실행한 뒤, 각 세션 결과를 검토하고 정리합니다.
bashnpm install -g @anthropic-ai/claude-code@latest claude --version claude agents
날짜가 중요합니다. Claude Code changelog에서는 2026년 5월 11일 v2.1.139에 Agent View research preview와 /goal이 추가되었습니다. 2026년 5월 19일 확인 시점에서 @anthropic-ai/claude-code의 latest는 2.1.143, next는 2.1.144였습니다. 일반 사용 경로로 next를 권장해서는 안 되며, latest와 현재 공식 문서를 기준으로 삼는 편이 안전합니다.
핵심은 “agent를 많이 켜면 좋다”가 아닙니다. 핵심은 안전하게 분리할 수 있는 로컬 작업만 눈에 보이게 병렬화하는 것입니다. 각 백그라운드 세션은 여전히 Claude Code 대화이며, 컨텍스트, 권한, 도구, 로컬 파일, 쿼터 영향을 가집니다. Agent View는 상태를 보여줄 뿐 작업 소유권을 자동 설계하지 않습니다.
Agent View가 바꾼 것
Agent View의 가치는 관찰 가능성입니다. 여러 터미널 탭, 여러 백그라운드 작업, 입력 대기 상태의 세션을 하나의 화면에서 볼 수 있습니다. 어떤 세션이 실행 중인지, 무엇이 입력을 기다리는지, 어떤 작업이 끝났는지 확인하기 쉬워집니다.
Agent Teams와는 다릅니다. Agent Teams는 lead와 teammates가 있고, 작업 목록과 메시지를 통해 서로 조율하는 실험적 모델입니다. Agent View는 독립적인 로컬 백그라운드 세션을 보기 위한 더 가벼운 화면입니다. 서로 대화할 필요가 없는 작업이라면 Teams부터 켜는 것은 과합니다.
Managed Agents와도 다릅니다. Managed Agents는 Anthropic Platform에서 runtime을 맡는 API 경로입니다. Agent View는 로컬 Claude Code 화면이므로 로컬 머신, 권한, 작업 디렉터리, 종료, 미커밋 변경 사항의 영향을 받습니다.
도입 전 확인은 세 가지면 충분합니다. claude --version으로 v2.1.139 이상인지 확인하고, claude agents가 기대한 화면을 여는지 확인하고, 현재 공식 docs와 changelog에서 preview 상태나 세션 동작이 달라지지 않았는지 확인하세요.
경로 비교
한국어 자료에서도 Agent View, Agent Teams, subagents가 모두 “멀티 에이전트”라는 표현으로 묶이기 쉽습니다. 하지만 설정 전에 경로를 나누면 불필요한 병렬화를 피할 수 있습니다.
| 경로 | 적합한 경우 | 피해야 할 경우 | 상태 |
|---|---|---|---|
| Agent View | 독립 로컬 백그라운드 세션을 한 화면에서 보고 싶다 | 세션끼리 긴밀히 협업해야 한다 | research preview |
| Agent Teams | 팀원 세션이 서로 메시지와 작업을 조율해야 한다 | 단순히 여러 세션을 보고 싶다 | 실험 기능, 플래그 필요 |
| subagents | 한 Claude Code 세션 안의 좁은 helper가 필요하다 | 지속적인 peer 협업이 필요하다 | 단일 세션 내부의 가벼운 경로 |
| Managed Agents | Anthropic이 runtime을 호스팅해야 한다 | 로컬 저장소를 Claude Code로 작업한다 | Platform/API 경로 |
| Agent SDK / Messages API | 직접 agent runtime을 설계한다 | Claude Code 대시보드가 필요하다 | 애플리케이션 설계 경로 |
실무 순서는 단일 세션, subagents, Agent View, Agent Teams 순서로 무거워집니다. 병렬 조사가 독립적이면 Agent View가 도움이 되지만, 같은 파일을 여러 세션이 수정하면 관찰성보다 혼란이 커집니다.
안전한 첫 실행
처음부터 가장 위험한 마이그레이션에 Agent View를 적용하지 마세요. 첫 목적은 기능 과시가 아니라 열기, 분리하기, 보기, 돌아가기, 검토하기, 정리하기의 리듬을 익히는 것입니다.
첫 실행은 이렇게 합니다.
- latest 경로로 Claude Code를 업데이트합니다.
- claude --version으로 버전을 확인합니다.
- claude agents를 실행합니다.
- 백그라운드 세션은 두 개부터 시작합니다.
- 각 세션에 서로 다른 질문, 파일 범위 또는 read-only 조건을 줍니다.
- 입력 대기 상태를 방치하지 않습니다.
- 완료된 세션으로 들어가 명령, 근거, 변경을 확인합니다.
- 결과 위치를 이해한 뒤 cleanup합니다.
좋은 첫 작업은 조사형입니다. 한 세션은 flaky test 재현 명령을 찾고, 다른 세션은 최근 변경을 봅니다. 한 세션은 auth state 읽기 경로를 정리하고, 다른 세션은 쓰기 경로를 정리합니다. 이런 작업은 병렬이 가능하지만 같은 파일을 서로 수정하지 않습니다.
프롬프트도 경계를 가져야 합니다. “checkout을 고쳐줘”보다 “checkout retry tests를 read-only로 조사하고, test files와 retry helper에 한정하고, 실패 명령, 가장 강한 가설, 안전한 다음 행동을 반환하고, payment runtime 수정이 필요하면 중단하라”가 훨씬 안전합니다.
Agent View가 유용한 경우
Agent View는 병렬성이 대기 시간을 줄이지만 merge 혼란을 만들지 않는 경우에 유용합니다. 버그 원인이 여러 개라면 각 세션이 다른 가설을 검증하고, 마지막에 근거를 비교할 수 있습니다.
독립 리뷰에도 좋습니다. 한 세션은 security, 한 세션은 performance, 한 세션은 test coverage를 봅니다. 모두 read-only로 결과를 내면 코드 변경 충돌 없이 더 많은 관점을 얻을 수 있습니다.
문서화와 마이그레이션 준비에도 맞습니다. 한 세션은 config 파일을 목록화하고, 다른 세션은 공식 문서를 읽고, 다른 세션은 로컬 scripts를 확인합니다. 결과가 사실 목록이면 Agent View의 가시성이 크게 도움이 됩니다.
느린 로컬 체크를 관리할 때도 쓸모가 있습니다. 한 세션이 긴 test suite를 실행하는 동안 다른 세션이 로그나 최소 재현을 살핍니다. Agent View의 핵심은 모든 세션에 코드를 쓰게 하는 것이 아니라 기다림, 막힘, 완료를 놓치지 않는 것입니다.
멈춤 규칙
Agent View는 불명확한 작업을 자동으로 정리해 주지 않습니다. 각 세션의 소유 범위를 짧게 설명할 수 없다면 세션을 늘리지 않는 편이 낫습니다.
같은 파일을 여러 각도에서 수정해야 하거나, 하나의 연속 추론이 필요하거나, 사용자 변경이 있는 dirty worktree를 아직 읽지 않았거나, 쿼터가 빠듯하거나, 결과가 여러 근거가 아니라 하나의 최종 판단이라면 단일 세션에 머무르세요.
dirty worktree에서는 특히 조심해야 합니다. git diff, untracked files, generated artifacts를 먼저 확인하고 각 백그라운드 세션에 read-only, 특정 디렉터리만, 제안만 같은 제한을 줘야 합니다.
쿼터도 실제 제약입니다. 병렬 세션은 컨텍스트와 출력, 검토 시간을 늘립니다. 두 세션으로 가치를 확인한 뒤 늘리는 방식이 더 안전합니다.
문제 해결
| 증상 | 가능한 원인 | 다음 행동 |
|---|---|---|
| claude agents가 열리지 않는다 | 버전이 낮거나 문서가 바뀌었다 | claude --version 확인 후 latest 업데이트 |
| 화면은 열리지만 세션이 없다 | 백그라운드 작업이 아직 없다 | 작은 독립 작업 하나를 시작 |
| 입력 대기 세션이 많다 | 프롬프트가 넓거나 권한이 막혔다 | 세션으로 돌아가 범위를 좁힘 |
| 완료됐지만 merge할 수 없다 | 소유권 없이 작업을 나눴다 | 근거를 비교하고 구현은 한 세션으로 회수 |
| 쿼터 소모가 빠르다 | 동시 세션이 많다 | 병렬 수를 줄임 |
| API나 결제 질문으로 넘어간다 | Agent View 경로가 아니다 | Claude Code와 Platform API를 분리 |
가장 안전한 복구는 새 세션을 추가하지 않는 것입니다. 기존 세션의 결론을 모으고, 하나의 Claude Code 세션으로 돌아가 다음 구현을 끝내세요. Agent View가 상태를 더 명확하게 만들지 못한다면 병렬 설계를 줄여야 합니다.
도입 전 운영 점검
Agent View를 일상 흐름에 넣기 전에 작은 예행연습을 하세요. 작업을 read-only 조사, 범위가 좁은 국소 수정, 하나의 연속 추론이 필요한 핵심 수정으로 나눕니다. 첫 번째 유형은 Agent View에 잘 맞습니다. 두 번째는 파일 소유권이 분명할 때만 적합합니다. 세 번째는 주 세션에 남겨 두는 편이 안전합니다.
| 점검 항목 | 판단 기준 | 불확실할 때 |
|---|---|---|
| 파일 소유권 | 각 백그라운드 세션이 별도 영역만 읽거나 다룬다 | 단일 세션으로 돌아가 경계를 다시 나눈다 |
| 결과 형식 | 명령, 로그, 결론, 다음 행동이 돌아온다 | 실행 전에 prompt를 다시 쓴다 |
| 권한 위험 | 파일 쓰기, 의존성 설치, 민감 설정 접근 가능성이 있다 | read-only와 중단 조건을 지정한다 |
| 통합 경로 | 주 세션이 결과를 비교할 수 있다 | 구현을 병렬화하지 않는다 |
좋은 prompt는 목표, 읽을 수 있는 범위, 금지할 변경, 반환 형식을 차례로 적습니다. 예를 들어 auth session expiry를 read-only로 조사하고, src/auth와 tests/auth만 읽고, 파일은 수정하지 말고, 실패 명령, 가장 강한 가설, 근거 줄, 안전한 다음 행동을 반환하라고 쓰는 방식입니다. 이렇게 하면 Agent View에서 완료된 세션으로 돌아왔을 때 결과를 빠르게 비교할 수 있습니다.
완료 뒤에는 최종 답변만 믿지 마세요. 각 세션에 들어가 실제 실행한 명령, 읽은 파일, 멈춘 이유, 불확실한 판단을 확인해야 합니다. 두 세션의 결론이 충돌하면 곧바로 merge하지 말고 주 세션에서 근거를 모아 하나의 구현 방향을 고르세요.
정리도 흐름의 일부입니다. 여러 세션을 쓴 뒤 git status, untracked files, generated artifacts, 테스트 출력을 확인합니다. 남길 결론은 주 세션이나 작업 기록으로 옮기고 임시 결과는 의식적으로 치웁니다. Agent View는 상태를 보여 주지만 로컬 작업 트리를 자동으로 깨끗하게 만들지는 않습니다.
여러 사람이 같은 저장소를 다루는 상황에서는 조건을 더 구체적으로 써야 합니다. 기존 사용자 변경은 되돌리지 말 것, 생성물은 필요한 범위만 다시 만들 것, 로그는 증거로만 다룰 것, 커밋 대상과 임시 파일을 구분할 것 같은 제한을 prompt에 넣으세요. 이런 제한이 없으면 한 세션이 테스트를 통과시키려고 로컬 변경을 덮고, 다른 세션은 오래된 상태를 바탕으로 결론을 내릴 수 있습니다.
병렬 작업마다 “통합 담당”도 필요합니다. 통합 담당은 새 백그라운드 세션을 늘리지 않고 돌아온 근거를 읽고, 충돌하는 판단을 정리하고, 구현 흐름을 하나로 되돌립니다. Agent View를 잘 쓰는 기준은 세션 수가 아니라 각 세션의 산출물이 주 작업 흐름에 흡수될 수 있는지입니다.
또 하나의 기준은 검증 경로입니다. 세션을 시작하기 전에 결과를 어떤 테스트, 파일 줄, 로그, 문서 링크, 또는 명확한 부정 결론으로 확인할지 말할 수 있어야 합니다. 검증할 방법이 없다면 그 세션은 병렬 실행보다 주 세션의 질문으로 남겨 두는 편이 낫습니다.
검증이 끝난 뒤에만 병렬 수를 늘리세요. 첫 시도가 조용히 끝났다는 이유만으로 세션을 더 여는 것은 위험합니다. 어떤 작업이 대기 시간을 줄였고 어떤 작업이 검토 부담만 늘렸는지 남겨 두면 다음 분리가 더 안정적입니다.
자주 묻는 질문
Agent View는 지금 사용할 수 있나요?
사용할 수 있지만 research preview로 다루어야 합니다. 공식 경계는 Claude Code v2.1.139 이상과 claude agents입니다. 업무 흐름에 넣기 전에 현재 문서를 다시 확인하세요.
next 태그를 설치해야 하나요?
일반적으로는 아닙니다. 2026년 5월 19일 기준 next가 latest보다 새로웠지만, 그것만으로 기본 경로가 되지는 않습니다. latest와 공식 문서를 우선하세요.
Agent Teams와 같은 기능인가요?
아닙니다. Agent View는 로컬 백그라운드 세션 화면입니다. Agent Teams는 팀원형 세션들이 조율하는 실험 기능이며 별도 플래그가 필요합니다.
subagents는 여전히 필요한가요?
필요합니다. 한 Claude Code 세션 안에서 좁은 helper를 쓰는 경우에는 subagents가 더 가볍습니다. 리뷰, 테스트, 검색, 국소 조사에 맞습니다.
Agent View가 클라우드에서 실행하나요?
아닙니다. Claude Code 로컬 세션 관리 화면으로 봐야 합니다. Hosted runtime이 필요하면 Managed Agents나 Platform API 쪽입니다.
쿼터를 절약하나요?
아닙니다. 각 세션은 여전히 Claude Code와 모델 사용량을 소비합니다. 세션이 많을수록 출력과 검토가 늘어납니다.
첫 작업은 무엇이 좋나요?
두 개의 read-only 조사 작업이 좋습니다. 하나는 재현, 하나는 최근 변경 조사. 하나는 docs, 하나는 local config처럼 비교 가능한 결과를 만드세요.
핵심만 기억하려면?
Agent View는 가시성 도구입니다. 경계가 분명한 작업만 병렬화하고, 모호한 작업은 단일 세션으로 되돌리는 것이 안전합니다.
결론
Claude Code Agent View는 로컬 백그라운드 세션을 보이게 만드는 실용적인 업데이트입니다. 독립 조사, 리뷰, 느린 체크를 관리하기 좋지만 작업 분할 설계를 대신하지는 않습니다.
버전을 확인하고, claude agents를 열고, 두 개의 독립 작업부터 시작하고, 결과를 검토한 뒤 늘리세요. Agent Teams, subagents, Managed Agents, Agent SDK는 별도 경로로 유지해야 합니다. 작업이 긴밀하거나 순차적이거나 쿼터에 민감하다면 하나의 Claude Code 세션이 여전히 더 나은 선택입니다.