Claude Code 중첩 서브에이전트와 멀티 에이전트 오케스트레이션

병렬 실행보다 컨텍스트 관리가 먼저다

2026년 6월 12일 배포된 Claude Code v2.1.175는 서브에이전트가 다시 하위 에이전트를 생성하는 재귀적 위임 구조를 안정화한 릴리스다. 9,000개 이상으로 성장한 플러그인 생태계에는 검색 기능이 추가됐고, Chrome·VSCode·터미널을 오가는 워크플로우도 정비됐다.

기존 구조에서는 리드 에이전트만 서브에이전트를 생성할 수 있었다. 서브에이전트가 또 다른 에이전트를 호출하는 동작은 무한 재귀와 토큰 폭발을 막기 위해 하드 가드레일로 차단돼 있었다.

v2.1.172부터 도입되고 v2.1.175에서 안정화된 중첩 서브에이전트(Nested Subagent)는 이 제한을 최대 깊이 5레벨(depth=5)이라는 경계로 대체한다. 각 레벨은 독립된 시스템 프롬프트와 모델 설정을 가지며, 부모 에이전트는 자식이 돌려준 요약(summary)만 읽는다. 자식이 작업하면서 사용한 중간 컨텍스트는 부모에게 합쳐지지 않는다.

이 구조의 핵심은 에이전트를 많이 띄우는 데 있지 않다. 서브에이전트의 컨텍스트 윈도우가 포화되기 전에 남은 작업을 아래 단계로 넘겨, 긴 작업을 계속 분해할 수 있게 하는 컨텍스트 관리 방식에 가깝다.

v2.1.175에서 달라진 범위

릴리스 날짜: 2026년 6월 12일
버전: @anthropic-ai/claude-code@2.1.175

이번 릴리스의 중심에는 중첩 서브에이전트와 플러그인 검색이 있다. 서브에이전트는 자체 하위 에이전트를 최대 5레벨까지 생성할 수 있고, 플러그인 마켓플레이스에서는 키워드로 필요한 플러그인을 찾을 수 있다. Amazon Bedrock은 ~/.aws 설정 파일에서 AWS_REGION을 자동으로 읽도록 개선됐으며, Fable 5 모델명 정규화 문제도 수정됐다.

사용 표면별 변경도 포함됐다. Chrome에서는 브라우저 도구를 단일 배치 호출로 불러오도록 최적화했고, VSCode에서는 PowerShell 툴 호출 렌더링 오류를 바로잡았다. 터미널의 세션 재개 흐름을 개선했으며, Windows 샌드박스 시작 과정에서 나오던 불필요한 경고 메시지도 제거했다.

런타임에서는 세션 컨텍스트 오염, 에이전트 간 결과 전달 프로토콜, 모델 선택기 UI, 메모리 누수 패턴, 권한 에스컬레이션 엣지 케이스를 수정했다.

위임 트리는 어디까지 확장되는가

⤢✕

리드 에이전트인 Level 0은 Level 1 서브에이전트를 제한 없이 생성할 수 있다. 포그라운드(foreground) 서브에이전트는 Level 5에 도달하면 더 아래로 확장할 수 없다. Level 5에서도 백그라운드(background) 서브에이전트는 생성할 수 있지만, 그 에이전트 역시 자식 서브에이전트를 만들지는 못한다.

깊이 제한은 하드코딩된 정수 카운터로 관리된다. 에이전트는 자신의 현재 깊이를 알고 있으며, 자식 생성 요청에 깊이+1 값을 메타데이터로 넘긴다. 런타임은 전달된 값이 5를 초과하면 예외를 반환한다.

⤢✕

부모와 자식 사이에는 요약만 남는다

각 서브에이전트는 별도의 컨텍스트 윈도우에서 실행된다. 부모가 자식에게 넘기는 정보는 시스템 프롬프트인 역할 정의, 초기 사용자 메시지인 작업 명세, 허용된 툴 목록이다. 자식은 작업을 마친 뒤 최종 결과 요약만 부모에게 반환한다. 작업 중 소비한 수천 토큰은 자식 컨텍스트에 머물다가 사라진다.

결과 전달에는 구조화된 JSON 요약 형식이 쓰인다. 완료한 작업, 생성한 파일 경로, 다음 단계 권고 사항, 실패한 작업과 그 이유가 요약에 포함된다. v2.1.175는 이 프로토콜의 오류 처리를 개선했다. 자식이 부분 실패를 반환하면 부모가 재위임하거나 다른 경로를 선택할 수 있다.

컨텍스트 격리는 긴 작업에서 특히 의미가 있다. 상위 에이전트가 모든 탐색 기록과 중간 판단을 보관하지 않아도 되므로, 각 레벨은 자신에게 필요한 정보에 집중할 수 있다.

단층 구조와 중첩 구조의 선택 기준

⤢✕

항목	단층 멀티 에이전트	중첩 서브에이전트
최대 병렬 에이전트 수	제한 없음	트리 구조로 확장
컨텍스트 격리	각 서브에이전트 독립	각 레벨 독립
작업 위임 깊이	1레벨	최대 5레벨
적합한 작업 유형	독립적 병렬 작업	복잡한 계층적 분해
컨텍스트 소진 대응	리드가 개입 필요	자동 하위 위임
구현 복잡도	낮음	높음

서로 의존하지 않는 작업을 동시에 처리할 때는 단층 구조가 여전히 적합하다. 반면 하나의 서브에이전트가 감당하기 어려울 만큼 긴 작업이나, 작업 내부에서 다시 전문 역할을 나눠야 하는 문제에는 중첩 구조가 맞는다. 재귀 위임이 가능하다는 이유만으로 모든 작업을 트리로 만들 필요는 없다. 구조가 깊어질수록 구현 복잡도도 높아진다.

플러그인 검색이 필요한 이유

2026년 6월 기준 Claude Code 플러그인 생태계에는 9,000개 이상의 플러그인이 있다. 공식 Anthropic 마켓플레이스에는 엄격한 심사를 거친 플러그인이 올라가고, 커뮤니티 마켓플레이스는 실험적인 플러그인까지 포함해 더 넓은 선택지를 제공한다.

v2.1.175의 검색 기능은 플러그인 이름·설명·태그를 대상으로 키워드 검색을 수행한다. 검색 결과는 설치 수·평점·최근 업데이트 여부를 기준으로 정렬할 수 있다.

실제 생산 환경에서 유용하다고 평가되는 플러그인은 9,000개 가운데 50~100개 수준이다. 검색 기능은 이 범위에서 검증된 플러그인을 추려 설치하고, Claude Code의 에이전트와 서브에이전트가 사용할 도구로 연결하는 과정을 돕는다.

Chrome·VSCode·터미널을 잇는 작업 환경

Claude in Chrome v1.0.36 이상과 연동할 때 브라우저 도구를 초기화하는 방식이 바뀌었다. 이전에는 각 도구를 개별 HTTP 요청으로 불러왔지만, v2.1.175부터 단일 배치 호출로 일괄 로드한다. 도구 로드 레이턴시를 줄이는 동시에 네트워크 오류가 발생했을 때 전체 재시도 흐름을 단순화한다.

VSCode의 PowerShell 터미널에서는 Claude Code 툴 호출 결과가 잘못 표시되던 문제가 수정됐다. VS Code 확장과 Claude Code CLI가 같은 훅 설정 형식을 사용하므로, 작성한 훅 설정을 양쪽에서 재사용할 수 있다.

터미널에서는 세션 재개(session resume) 흐름을 다듬었다. 중단한 세션을 이어갈 때 이전 컨텍스트를 불러오는 속도가 향상됐고, 세션 목록 UI는 각 세션의 상태를 더 명확하게 표시하도록 변경됐다.

세션과 권한 경계를 바로잡은 수정

장시간 실행한 에이전트 세션에서는 이전 세션의 툴 상태가 새 세션으로 섞이는 문제가 있었다. 원인은 메모리 세그먼트 경계 처리 오류였으며, v2.1.175에서 세션 컨텍스트 오염 문제를 수정했다.

서브에이전트가 부모보다 넓은 권한을 요청했을 때 잘못 허용되던 엣지 케이스도 바로잡았다. 서브에이전트가 사용할 수 있는 툴 목록은 항상 부모의 허용 툴 목록에 포함돼야 한다는 원칙이 엄격하게 적용된다.

멀티 에이전트 구성에서 에이전트별로 다른 모델을 지정할 때 모델 선택기 드롭다운이 선택값을 유지하지 못하던 UI 결함 역시 수정 대상에 포함됐다.

경쟁 도구 사이에서 잡은 위치

2026년 중반 AI 코딩 에이전트 시장은 Claude Code(Anthropic), Codex CLI(OpenAI), Antigravity 2.0(Google)의 3강 구도를 형성했다.

⤢✕

Antigravity 2.0은 멀티 에이전트 오케스트레이션의 속도와 규모에서 앞선다. OS를 12시간 만에 빌드한 데모에서는 93개의 서브에이전트를 동시에 운영했고, 처리 속도는 289 토큰/초였다.

Claude Code는 코드 품질을 차별점으로 둔다. SWE-Bench Pro에서 64.3%를 기록해 Antigravity의 55.1%보다 높은 결과를 냈다. 중첩 서브에이전트는 이런 코드 품질 중심의 실행 방식을 대규모 오케스트레이션 수요로 확장하려는 변화다. Opus 4.7의 자기 검증(self-verification) 기능과 결합하면 에이전트 실패 모드를 줄이면서 깊은 위임을 수행할 수 있다.

개발 자동화 아키텍처로 읽기

중첩 서브에이전트는 에이전트 기반 소프트웨어 개발(ABSD, Agent-Based Software Development)의 계층적 분해(Hierarchical Decomposition) 패턴을 실제 도구에 적용한 사례다. 각 에이전트는 제한된 컨텍스트를 사용하고, 자신의 역할 범위를 벗어나는 작업을 하위 에이전트에 넘긴다.

컨텍스트 엔지니어링(Context Engineering) 관점에서는 어떤 정보를 어느 시점에 에이전트의 컨텍스트에 넣을지가 설계의 중심이 된다. 중첩 구조는 각 레벨이 필요한 정보만 보유하도록 컨텍스트를 분리하고, 상위에는 결과 요약만 남긴다.

Chrome·VSCode·터미널 통합은 IDE Integration과 DevOps 자동화 파이프라인의 접점에 놓인다. 하나의 에이전트가 브라우저 테스트, 코드 편집, 터미널 명령 실행을 묶어 오케스트레이션하는 방식은 CI/CD 파이프라인을 AI 에이전트 실행 영역으로 확장한 형태로 볼 수 있다.

Claude Code v2.1.175의 변화는 컨텍스트 윈도우의 한계를 무시하는 대신 작업 위임 구조로 다룬다는 데 의미가 있다. 최대 5레벨의 경계 안에서 작업을 재귀적으로 분해하고, 각 단계의 중간 컨텍스트를 격리한다. 여기에 플러그인 검색과 멀티 서피스 안정화가 더해지면서 Claude Code는 코드 생성 도구를 넘어 멀티 에이전트 작업을 운영하는 플랫폼에 가까워졌다.