Claude Code v2.1.175의 중첩 서브에이전트와 멀티 서피스 아키텍처

위임 구조가 수평에서 수직으로 확장됐다

Anthropic이 2026년 6월 공개한 Claude Code v2.1.175는 오케스트레이터가 여러 작업자를 호출하는 단층 구조를 넘어선다. 서브에이전트가 다시 하위 에이전트에 작업을 맡기는 중첩 서브에이전트(Nested Sub-agent), 플러그인 검색 생태계, Chrome·VSCode·터미널을 잇는 멀티 서피스 통합이 이번 버전의 중심이다.

중첩 구조에서는 사용자 요청을 받은 Root Agent 아래에 Orchestrator Agent, Sub-agent, Leaf Agent가 이어진다. 각 계층은 별도의 컨텍스트 윈도우와 도구 허용 범위를 가지며, 하위에서 만들어진 결과는 상위 계층을 거슬러 올라가며 합쳐진다. 한 오케스트레이터가 여러 서브에이전트를 동시에 스폰할 수도 있다.

⤢✕

이론적으로 위임 깊이에는 제한이 없지만, 실제 운용 범위는 누적되는 컨텍스트 비용과 레이턴시에 의해 결정된다. 따라서 계층을 만들 수 있다는 사실보다 어디에서 위임을 멈출지가 더 중요한 설계 문제가 된다.

깊이와 비용을 함께 통제하는 방법

중첩 에이전트를 운영할 때는 최대 깊이를 환경 변수나 .claude/settings.json의 maxAgentDepth 파라미터로 제한할 수 있다. 일정 깊이를 넘으면 하위 에이전트를 더 만들지 않고 현재 에이전트가 직접 실행하도록 Circuit Breaker 패턴을 적용하는 방식도 가능하다.

토큰 예산은 모든 계층에 동일하게 나누기보다 상위 레이어에 더 큰 컨텍스트 윈도우를 배정하는 구성이 권장된다. 예를 들어 Root에 200K, Orchestrator에 100K, Sub-agent에 50K, Leaf에 20K를 할당하는 식이다. 각 호출에서 발생한 비용은 루트까지 집계해야 전체 예산을 확인할 수 있다.

⤢✕

깊이만 제한해서는 비용 폭증을 막기 어렵다. 팬아웃 수와 호출별 소비량도 함께 보면서 어느 작업을 병렬화하고 어느 작업을 현재 계층에서 처리할지 결정해야 한다.

컨텍스트와 권한은 계층마다 분리한다

서브에이전트는 부모의 전체 대화 기록이 아니라 자신이 수행할 태스크 명세만 받는다. 이 방식은 불필요한 정보가 작업 판단에 섞이는 것을 줄이고, 민감한 데이터가 하위 계층까지 전달되는 범위를 좁히며, 컨텍스트 비용도 낮춘다.

에이전트 사이에서 공유해야 하는 정보는 파일 시스템이나 코드 저장소 같은 외부 상태를 통해 전달할 수 있다. 반면 세션 메모리는 계층별로 독립 관리되며 상위 레이어가 하위 에이전트의 메모리에 직접 접근하지 못한다.

분리된 에이전트가 협력하려면 반환 형식도 명확해야 한다. 서브에이전트는 JSON Schema나 Markdown처럼 구조화된 형식으로 결과를 돌려줄 수 있고, 오케스트레이터는 리프 에이전트의 스트리밍 출력을 실시간으로 중계할 수 있다. 하위 작업이 실패하면 오류가 상위 계층으로 전달되고, 상위 에이전트가 재시도 정책을 적용한다. 에이전트별 confidence 메타데이터를 결과에 포함하면 병합 단계의 판단 근거로 사용할 수 있다.

플러그인을 찾고 연결하는 생태계

v2.1.175의 플러그인 검색은 중앙 레지스트리에서 MCP 서버, 스킬 팩, 도구 번들을 찾는 흐름을 제공한다. 현재 작업의 키워드와 컨텍스트를 분석해 관련 플러그인을 추천하고, 선택한 플러그인을 .claude/settings.json에 연결하는 방식이다.

설치 전에 Claude Code 버전과 플러그인의 호환성을 검사하며, 다운로드 수·별점·유지보수 활성도를 바탕으로 신뢰도를 판단할 수 있다. 코드 분석, 테스트, 배포, 모니터링, 데이터 처리처럼 도메인별로 분류된 플러그인을 탐색하는 구조다. 사용자 정의 플러그인을 위한 템플릿과 로컬 테스트 환경도 지원한다.

검색과 설치는 다음 흐름으로 이어진다.

⤢✕

플러그인 검색은 기능 목록을 늘리는 데서 끝나지 않는다. 에이전트가 작업에 필요한 외부 도구를 발견하고 연결하는 과정을 플랫폼 내부로 끌어들인다는 점에서 Claude Code의 확장 전략과 맞닿아 있다.

브라우저에서 찾은 오류를 편집기에서 고친다

멀티 서피스 통합은 개발자가 실제로 사용하는 Chrome, VSCode, 터미널의 상태를 하나의 에이전트 컨텍스트로 연결한다.

Chrome 연동을 통해 브라우저 콘솔 로그, 네트워크 요청, DOM 상태를 웹 애플리케이션 디버깅에 활용할 수 있다. VSCode에서는 선택한 코드 분석, 인라인 에이전트 호출, 리팩토링 제안을 동기화한다. 터미널에서는 셸 히스토리와 실행 중인 프로세스 상태, 환경 변수를 에이전트가 조회한다.

이 연결이 만들어지면 Chrome에서 확인한 오류를 VSCode의 코드 수정 작업으로 넘기는 크로스 서피스 명령이 가능해진다. 브라우저 오류, 테스트 실패, CI/CD 파이프라인 알림을 에이전트 호출의 이벤트 드리븐 트리거로 사용할 수도 있다.

⤢✕

모델 선택과 리전 장애를 다루는 방식

특정 AWS 또는 GCP 리전에서 모델 서비스가 중단되면 대체 리전으로 전환하는 자동 장애 조치가 추가됐다. 미국·유럽·아시아 리전 사이의 응답 지연 시간 편차도 줄였다.

세션 안에서는 Model Picker UI를 이용해 태스크별로 Opus, Sonnet, Haiku를 선택할 수 있다. 태스크 복잡도를 분석해 단순 작업은 Haiku, 복잡한 설계는 Opus로 라우팅하는 비용 최적화 구성도 제공한다. 실험 재현성이 필요할 때는 특정 모델 스냅샷 버전을 고정할 수 있다.

모델	권장 사용 케이스	컨텍스트 윈도우	비용 특성
Claude Opus	아키텍처 설계, 복잡한 리팩토링	200K	고비용·고품질
Claude Sonnet	일반 코딩, 코드 리뷰	200K	균형형
Claude Haiku	빠른 조회, 단순 편집	200K	저비용·고속

장기 세션에서 드러난 경계를 보강했다

v2.1.175에는 세션과 권한 모델을 다듬는 수정도 포함됐다. 장기 세션의 컨텍스트가 예기치 않게 초기화되는 문제와 서브에이전트를 반복해서 스폰할 때 메모리 사용량이 비례해 늘어나는 문제가 패치됐다.

서브에이전트가 부모의 권한을 과도하게 물려받던 취약점도 수정했다. 글로벌 메모리, 세션 메모리, 에이전트 로컬 메모리의 경계를 분명히 하고, 동일한 도구 권한을 반복해서 묻던 흐름을 개선했다. 세션 상태를 디스크에 직렬화하는 과정에서 발생하던 race condition도 해결 대상에 포함됐다.

이 변경들은 중첩 구조의 전제와 연결된다. 계층을 늘리려면 작업만 분리할 것이 아니라 메모리와 도구 권한도 같은 경계로 나눠야 한다.

단층 구조와 중첩 구조를 고르는 기준

중첩 서브에이전트는 복잡한 작업을 자동으로 계층 분해하고 에이전트 단위로 병렬화한다. 각 에이전트의 컨텍스트가 분리되므로 하나의 컨텍스트에 모든 기록이 누적되는 위험도 낮다. 대신 에이전트 수가 늘수록 비용이 증가하고, 실행 경로를 추적하는 디버깅도 복잡해진다.

단층 에이전트는 호출 흐름이 단순하고 비용을 예측하기 쉽다. 단일 파일 수정이나 간단한 질의응답, 레이턴시가 우선인 실시간 상호작용, 소규모 자동화에는 이 구조가 더 잘 맞는다.

반대로 대규모 코드베이스 리팩토링, 여러 저장소의 동시 분석, CI/CD 안의 복합 검증 워크플로우, 다국어 코드베이스 마이그레이션처럼 작업 자체가 계층적으로 나뉘는 경우에는 중첩 구조를 선택할 근거가 생긴다.

⤢✕

항목	중첩 서브에이전트	단층 에이전트
태스크 분해 능력	자동 계층 분해	수동 프롬프트 엔지니어링 필요
병렬 처리	에이전트 단위 병렬화	단일 스레드 순차 처리
컨텍스트 오염 위험	낮음 (격리 컨텍스트)	높음 (단일 컨텍스트 누적)
비용	에이전트 수에 비례 증가	단일 호출 비용
디버깅 복잡도	높음 (에이전트 트레이싱 필요)	낮음 (단일 실행 흐름)
적합한 태스크 규모	대형·복잡 태스크	소형·명확 태스크
장애 복원력	에이전트별 독립 재시도	전체 재실행

Codex·Antigravity와 다른 지점

2026년 코딩 에이전트 시장에서 OpenAI Codex CLI, Google Antigravity 2.0, Claude Code v2.1.175는 서로 다른 운영 축을 강조한다.

Codex CLI는 iOS·Android·데스크톱에서 비동기 에이전트를 실행하며, 3억 명 규모의 ChatGPT 사용자 기반과 모바일 워크플로우 통합을 강점으로 삼는다. Antigravity 2.0은 Ax 분산 런타임과 Gemini CLI의 Go 재작성을 바탕으로 엔터프라이즈급 병렬 실행과 GCP 네이티브 통합에 초점을 둔다.

Claude Code는 중첩 서브에이전트의 컨텍스트 격리, 멀티 서피스 개발 환경, 인간 승인 게이트를 결합한다. 접근성을 앞세운 Codex, 실행 규모를 강조한 Antigravity와 비교하면 정밀도와 안전성을 중심에 둔 위치다.

Claude Code의 플러그인 검색은 MCP 생태계를 허브로 삼아 서드파티 연결을 넓히는 플랫폼 전략에 해당한다. 세 플레이어 모두 2026년 하반기에 엔터프라이즈 보안 인증과 온프레미스 배포 옵션을 강화할 것으로 예고했다.

개발 도구 아키텍처로 읽는 중첩 에이전트

소프트웨어 품질 관점에서 리전 장애 조치는 가용성과 신뢰성에 연결된다. 중첩 서브에이전트의 역할 분리는 수정 용이성을 높이는 모듈화 방식으로 볼 수 있고, 컨텍스트 격리와 권한 정밀화는 최소 권한 원칙을 에이전트 시스템에 적용한 사례다. 이 기준은 ISO/IEC 25010의 Reliability, Maintainability, Security와 맞물린다.

아키텍처 패턴으로 보면 계층형 위임은 관심사를 레이어로 나누는 구조와 닮았다. 에이전트가 정해진 형식으로 결과를 다음 단계에 전달하는 과정은 Filter-Pipe 패턴에 대응하고, Root Agent가 하위 작업을 배정하고 회수하는 방식은 마이크로서비스의 Orchestrator Pattern과 같은 역할을 한다.

Claude Code는 요구사항 분석부터 배포까지 개발 생명주기를 지원하는 AI 기반 CASE(Computer-Aided Software Engineering) 도구로 분류할 수 있다. VSCode·Chrome·터미널의 결합은 기존 IDE의 범위를 확장한 AIDE(Agent-Integrated Development Environment)라는 관점으로도 해석할 수 있다.

운영 환경에서 남는 과제

플러그인 검색은 전문 도메인별 에이전트 패키지가 유통되는 마켓플레이스로 이어질 가능성이 있다. 보안·성능·가독성 에이전트를 동시에 실행하는 다중 관점 코드 리뷰도 CI/CD의 표준 단계로 통합될 전망이다.

다만 계층이 깊어질수록 어떤 에이전트가 어떤 판단을 내렸는지 기록하는 Audit Trail이 필요해진다. 호출 비용을 통제할 예산 관리와 가시화 대시보드도 함께 요구된다. 자율 에이전트의 행동 경계를 정하는 Constitutional AI 원칙이 코딩 에이전트에 적용되는 사례 역시 누적될 것으로 예상된다.

에이전트 간 통신 규격도 별도 과제다. AAIF(Agentic AI Interoperability Foundation) 등의 표준화 단체는 Claude Code 아키텍처와 연계해 에이전트 통신 프로토콜 표준을 논의 중이다.

Claude Code v2.1.175가 보여주는 변화는 코드 자동완성 기능의 확장만으로 설명하기 어렵다. 복잡한 개발 작업을 계층적으로 분해하고, 컨텍스트와 권한을 격리하며, 여러 개발 서피스와 외부 플러그인을 하나의 실행 흐름으로 묶는 오케스트레이션 플랫폼에 가깝다. 이 구조를 실제 환경에 적용할 때는 병렬성보다 깊이 제한, 비용 집계, 오류 전파, 권한 경계와 감사 가능성을 먼저 설계해야 한다.

Sources

Anthropic Claude Code Changelog v2.1.175 (2026년 6월)
Anthropic Claude Agent SDK Documentation — Nested Sub-agent Patterns
Claude Code GitHub Repository — Release Notes
Anthropic Safety Research — Constitutional AI for Coding Agents
AAIF (Agentic AI Interoperability Foundation) Technical Specification Draft 2026
OpenAI Codex CLI Technical Overview 2026
Google Antigravity 2.0 Architecture Documentation
ISO/IEC 25010:2023 — Systems and Software Quality Requirements and Evaluation
정보관리기술사 소프트웨어공학 참고서 (2025 개정판)