[Claude Code] 서브에이전트가 서브에이전트를 부르게 됐어요

[Claude Code] 서브에이전트가 서브에이전트를 부르게 됐어요

Claude Code 2.1.172 버전부터 서브에이전트가 자기 밑에 또 서브에이전트를 띄울 수 있어요. changelog 기준으로 중첩은 최대 5단계까지 가능해요. 6월 10일에 나온 릴리즈인데, 에이전트 위임 구조가 한 층에서 다층으로 바뀌는 변경이라 따로 정리해요.

01. 지금까지는 위임이 한 단계에서 끝났어요

원래 Claude Code에서 메인 세션이 서브에이전트한테 작업을 쪼개줄 수는 있었지만, 그 서브에이전트가 다시 다른 에이전트를 띄우는 건 안 됐어요. 그래서 작업을 잘게 나누려면 메인 세션이 분배까지 전부 떠안는 구조였어요.

이번 릴리즈 노트에는 "서브에이전트가 자신의 서브에이전트를 만들 수 있고, 최대 5단계 깊이까지 중첩된다"라고 나와 있어요. 위임받은 에이전트가 자기 판단으로 일을 다시 쪼갤 수 있게 된 거예요.

02. 큰 작업을 트리 구조로 쪼개는 게 가능해져요

예를 들면 코드 리뷰를 총괄하는 에이전트가 파일 묶음별로 하위 검사 에이전트를 띄우는 식의 구조를 생각해볼 수 있어요. 대규모 마이그레이션이나 코드베이스 전체 감사처럼, 컨텍스트 하나에 다 안 들어가는 작업에서 쓰임새가 있을 것으로 보여요.

다만 릴리즈 노트 외에 권장 패턴을 정리한 공식 문서는 아직 보이지 않아요. 중첩 깊이를 어떻게 잡는 게 좋은지 같은 운영 감각은 직접 써보고 판단할 부분이에요.

03. 토큰 사용량은 미리 따져볼 부분이에요

에이전트가 에이전트를 부르는 구조는 호출이 트리로 불어나는 만큼 토큰 사용량도 같이 늘어요. 구독 요금제로 쓰는 경우라면 사용량 한도가 그만큼 빨리 닳을 수 있다는 얘기예요.

5단계는 상한일 뿐이라, 깊게 파고드는 게 늘 이득은 아니에요. 단계가 늘수록 중간 에이전트가 결과를 요약해서 올리는 손실도 같이 생길 수 있어요.

04. 같은 릴리즈에 잔 변경도 몇 개 있어요

2.1.172에는 그 외 변경도 같이 실렸어요. /plugin에서 마켓플레이스 플러그인을 둘러볼 때 검색바가 생겼고, 사용량 크레딧 없이 1M context를 쓰던 세션이 영구히 막히던 문제는 표준 한도로 자동 압축되도록 고쳐졌어요. Amazon Bedrock 사용자라면 AWS_REGION 환경변수가 없을 때 ~/.aws 설정 파일에서 리전을 읽어오게 된 것도 참고할 부분이에요.

업데이트는 자동으로 받지만, 버전 확인은 아래처럼 하면 돼요.

claude --version
claude update

출처: Claude Code changelog (v2.1.172), anthropics/claude-code Releases

이 글은 공식 발표 내용을 정리한 것이고, Anthropic으로부터 어떤 형식의 협찬도 받지 않았습니다.