혼자 일하는 AI는 끝났다: Claude Code Agent View로 구축하는 멀티 에이전트 팀

작성자:

TL;DR

  • Claude Code의 Agent View는 여러 백그라운드 에이전트 세션을 단일 화면에서 모니터링·개입하는 CLI 인터페이스(research preview)다.
  • claude --bg로 태스크를 백그라운드 에이전트에 위임하고, claude agents로 전체 현황을 파악한다.
  • claude-sonnet-4-6이 멀티스텝 작업의 비용·성능 균형점이며, 단순 서브태스크는 claude-haiku-4-5로 라우팅해 비용을 통제한다.

왜 지금 ‘에이전트 팀’인가

단일 LLM 호출로 해결할 수 없는 작업이 늘고 있다. 수백 개 파일을 분석해 PR을 작성하거나, 여러 마이크로서비스를 동시에 점검하거나, 데이터 파이프라인 전체를 자율 디버깅하는 작업이 그 예다.

Claude Code는 이런 멀티스텝 자율 작업을 위해 Agent 모드를 제공한다. 에이전트는 Bash, Edit, Read, WebSearch 등 도구를 자율적으로 선택·조합해 복잡한 작업을 연속 수행한다. 여기에 Agent View가 더해지면, 동시에 실행 중인 여러 에이전트의 상태·활동 요약·PR/CI 상태를 한 화면에서 파악하고 필요할 때 개입할 수 있다.

Agent View는 Claude Code v2.1.139 이상에서 사용 가능하며, 현재 research preview 단계다.

문제는 이 기능을 실무에 어떻게 구조화하느냐다.

Agent View의 핵심 구성 요소

오케스트레이터-서브에이전트 패턴

가장 중요한 설계 원칙은 작업 분해(decomposition)다. 복잡한 작업을 독립적으로 실행 가능한 단위로 나누고, 각 단위를 별도 에이전트에 위임한다.

Claude Code에서 이 패턴을 구현하는 핵심 명령어:

# 백그라운드 에이전트 시작 — Agent View에서 추적됨
claude --bg "PR 1234의 보안 영향과 테스트 실패 가능성을 점검해줘"

# 특정 subagent 정의를 사용해 백그라운드 실행
claude --agent code-reviewer --bg "PR 1234를 리뷰하고 수정 제안을 정리해줘"

# 실행 중인 모든 에이전트 세션 현황 확인
claude agents

claude agents를 실행하면 각 세션의 상태, 최근 활동 요약(Haiku 기반 자동 요약), PR/CI 상태가 카드 형태로 표시된다. 특정 세션을 선택해 attach하거나 현황만 peek할 수 있고, 판단이 필요한 시점에 직접 개입해 에이전트 방향을 바꿀 수 있다.

subagent는 .claude/agents/ 디렉토리에 마크다운 파일로 정의한다:


---
name: code-reviewer
model: claude-haiku-4-5
tools: [Read, Bash]
---
코드 리뷰 전문 에이전트. 보안 취약점, 성능 이슈, 스타일 가이드 위반을 지적한다.
변경 파일 목록을 받으면 파일별로 구체적인 피드백을 반환한다.

MCP(Model Context Protocol) 연동

MCP는 에이전트-외부도구 연결의 표준 프로토콜이다. 프로젝트 루트의 .mcp.json에 등록하면 Slack, GitHub, 데이터베이스, 내부 API 등 외부 시스템과 에이전트가 표준화된 방식으로 통신한다.

// .mcp.json — 프로젝트 공유 MCP 서버 설정
{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
      }
    },
    "slack": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-slack"],
      "env": {
        "SLACK_BOT_TOKEN": "${SLACK_BOT_TOKEN}"
      }
    }
  }
}

개인·로컬 설정은 claude mcp add 명령 또는 ~/.claude.json에서 관리한다.

Agent View와 유사 기능 비교

Agent View를 도입하기 전에 네 가지 병렬화 옵션을 구분하는 것이 중요하다.

방식 구조 적합한 작업
Agent View 독립 세션, 각자 사용자에게 보고 완전 독립적인 태스크 병렬 실행
Subagent 단일 세션 내 위임, 요약 반환 단계적 작업 분해
Agent Teams 에이전트 간 협업 프로토콜 검토·승인이 필요한 파이프라인
Worktrees 격리된 git worktree 코드 변경 충돌 방지

파일 편집이 필요한 Agent View 세션은 .claude/worktrees/ 아래 격리된 git worktree로 자동 이동할 수 있어 충돌을 방지한다.

실전 사례: MSA 서비스의 배포 전 자율 점검

대규모 MSA 환경에서 실질적 가치를 만드는 패턴은 배포 전 병렬 점검이다. 네 가지 독립적인 점검 태스크를 동시에 에이전트에 위임한다.

# 배포 전 병렬 에이전트 점검 — 각각 독립 백그라운드 세션으로 실행
claude --bg "의존성 CVE 취약점을 스캔하고 CRITICAL 항목만 보고해줘"
claude --bg "API 스펙 변경으로 하위 호환성이 깨지는 엔드포인트를 식별해줘"
claude --bg "DB 마이그레이션 스크립트의 롤백 안전성을 검증해줘"
claude --agent load-estimator --bg "현재 트래픽 패턴 기준 예상 부하를 추정해줘"

# 모든 에이전트 현황 확인
claude agents

CI/CD 파이프라인에 통합하면 PR 머지 전 에이전트가 자율적으로 네 가지를 점검하고, 이상 발견 시 Slack MCP를 통해 담당자에게 즉시 알린다. Agent View에서 실시간 진행 상황을 확인하면서 특정 에이전트에 추가 질문을 던지거나 방향을 바꿀 수 있다.

주의: 백그라운드 세션은 로컬 supervisor process에서 실행된다. 머신이 sleep 또는 shutdown되면 중단된다. 장기 실행 작업은 tmux나 서버 환경에서 실행하는 것을 권장한다.

모델 선택 가이드

작업 유형 권장 모델 이유
단순 파일 수정, 코드 검색 claude-haiku-4-5 비용 최소화
멀티스텝 코드 리뷰, 분석 claude-sonnet-4-6 비용·성능 균형
복잡한 시스템 아키텍처 분석, 장기 자율 작업 claude-opus-4-7 최고 성능

오케스트레이터에는 sonnet-4-6, 단순 서브태스크 수행 에이전트에는 haiku-4-5를 혼용하면 토큰 비용을 의미 있게 낮출 수 있다. 단, 병렬 세션은 세션 수만큼 토큰 사용량이 늘어난다는 점을 반드시 고려한다. “비용 절감”보다 비용 통제 관점에서 설계해야 한다.

주의사항

컨텍스트 격리: 각 에이전트 세션은 독립 컨텍스트를 가진다. 오케스트레이터 역할의 에이전트가 전체 상태를 명시적으로 추적하지 않으면 세션 간 결과가 충돌할 수 있다. 공유 상태는 파일이나 외부 저장소를 통해 명시적으로 관리한다.

비용 통제: maxTurns를 설정해 에이전트가 무한 루프에 빠지는 상황을 방지한다. Claude Code의 사용량 대시보드에서 세션별 토큰 소비를 모니터링한다.

권한 범위: MCP 서버에 부여하는 권한은 최소 원칙을 따른다. GitHub MCP에 쓰기 권한을 주기 전에 에이전트가 실제로 PR을 생성해야 하는지 먼저 확인한다. Human-in-the-loop 승인 단계를 중요한 작업에 반드시 설계한다.

결론

Claude Agent View는 “AI에게 작업을 시킨다”는 개념을 “AI 에이전트 팀을 운영한다”는 수준으로 끌어올린다. claude agents로 여러 에이전트를 동시에 관찰하면서 필요한 개입 지점을 정확히 파악하는 것이 핵심이다.

당장 시작하려면 Claude Code를 최신 버전으로 업데이트하고(npm update -g @anthropic-ai/claude-code), 반복적으로 수행하는 코드 리뷰나 배포 점검 작업 하나를 claude --bg로 전환해 보자. 단일 백그라운드 세션에서 효과를 확인한 뒤 여러 에이전트 병렬 실행 패턴으로 확장하는 것이 안정적인 도입 경로다.

참고 자료
– Claude Code Agent View 공식 문서
– Claude Code Sub-agents
– Model Context Protocol
– Claude Code MCP 설정
– Claude 모델 목록

댓글 남기기