Claude Code v2.1.172 서브 에이전트 5계층화 및 주요 버그 수정 정리

Anthropic이 Claude Code의 두 가지 릴리스(v2.1.172 / v2.1.173)를 연달아 공개했습니다.

v2.1.172는 서브 에이전트(Sub-agent)의 최대 5계층 스폰(Spawn) 지원이라는 큰 기능 추가와 더불어, 1M 컨텍스트 주변의 프리즈(Freeze) 문제, availableModels 제약 누락, Amazon Bedrock의 리전(Region) 해결 등 에이전트 개발자가 실제로 겪기 쉬웠던 다수의 결함을 일괄 수정한 대형 릴리스입니다. v2.1.173은 그 뒤를 잇는 소규모 핫픽스(Hotfix)로, Fable 5 모델명의 정규화와 Windows 실행 경고를 수정했습니다.

이런 분들에게 영향이 있습니다:

• Claude Code 상에서 멀티 에이전트 시스템(Multi-agent system)을 구축하고 있는 개발자
• Amazon Bedrock을 통해 Claude Code를 이용하고 있는 개발자
• availableModels로 모델을 제한하고 있는 팀
• 1M 컨텍스트(Opus 4.8 / Sonnet)를 사용하고 있는 사용자
• Claude Code를 Windows 환경에서 이용하고 있는 개발자

카테고리	변경 내용	중요도
신기능	서브 에이전트가 자신의 서브 에이전트를 최대 5계층까지 스폰 가능하게 함	★★★
신기능	/plugin 마켓플레이스에 검색 바를 추가	★☆☆
신기능	OTEL 메트릭(Metrics) claude_code.lines_of_code.count에 model 속성을 추가	★☆☆
버그 수정	1M 컨텍스트를 사용하는 세션이 영구적으로 프리즈되는 문제를 수정 (자동 컴팩트)	★★★
버그 수정	여러 이미지를 포함한 대화에서 「이미지 처리 실패」 에러가 반복되는 문제를 수정	★★☆
버그 수정	availableModels 제약이 서브 에이전트·advisor 모델에 적용되지 않는 문제를 수정	★★★
버그 수정	opusplan이 플랜 모드에서 1M 컨텍스트를 동반하지 않는 문제를 수정	★★☆
버그 수정	ANTHROPIC_DEFAULT_OPUS_MODEL에 [1m]이 이중 부여되는 문제를 수정	★★☆
버그 수정	Amazon Bedrock에서 AWS_REGION 미설정 시 ~/.aws에서 리전을 읽어오도록 수정	★★★
버그 수정	Bedrock의 /model 피커(Picker)가 제공되지 않는 모델을 표시하고 사이런트(Silent)하게 전환하는 문제를 수정	★★☆
버그 수정	백그라운드 에이전트가 다른 디렉토리의 프로젝트 설정을 읽는 문제를 수정 (보안)	★★★
버그 수정	WebFetch(domain:*.example.com)의 와일드카드(Wildcard)가 서브도메인과 일치하지 않는 문제를 수정	★★☆
버그 수정	중첩된 에이전트 정지 후 서브 에이전트가 active 상태로 굳어버리는 문제를 수정	★★☆
버그 수정	이전 버전에서 시작한 백그라운드 세션으로의 attach가 EAUTH로 실패하는 문제를 수정	★★☆
버그 수정	워크플로(Workflow) 내에서 Date.now() / Math.random()을 문자열·주석으로 언급하는 것만으로 검증 거부되는 문제를 수정	★★☆
버그 수정	원격 세션에서 CLAUDE_MEMORY_STORES를 찾을 수 없는 문제를 수정	★★☆
퍼포먼스	긴 대화에서의 장황한 정규화 처리 제거	★★☆
퍼포먼스	/goal 칩(Chip)의 5Hz 재그리기를 중단하여 유휴(Idle) 시 CPU 사용률을 절감	★★☆
퍼포먼스	Claude in Chrome의 도구를 단일 배치(Batch) 호출로 로드하도록 개선	★☆☆
VSCode	PowerShell 도구 호출이 생(Raw) JSON으로 표시되는 문제를 수정	★☆☆
VSCode	ANSI 이스케이프 코드 제거를 수정	★☆☆

카테고리	변경 내용	중요도
버그 수정	[1m] 접미사가 붙은 Fable 5 모델명이 정규화되지 않는 문제 수정	★★☆
버그 수정	Windows에서 샌드박스 (Sandbox) 설정이 활성화되었을 때 표시되는 잘못된 "sandbox dependencies missing" 경고 수정	★★☆

📌 영향받는 대상

Claude Code 상에서 멀티 에이전트 시스템 (Multi-agent system)을 구축하고 있는 모든 개발자. 특히 에이전트가 에이전트를 호출하는 복잡한 파이프라인을 설계하고 있는 경우.

지금까지 서브 에이전트 (Sub-agent)는 단일 계층으로만 동작했으나, 앞으로는 최대 5계층까지 중첩 (Nest)이 가능합니다. 에이전트가 태스크를 분해하고, 자식 에이전트가 다시 손자 에이전트에게 위임하는 구성이 공식적으로 지원됩니다.

대응 불필요 — 자동으로 활성화됩니다. 기존의 단일 계층 구성에는 영향이 없습니다.

⚠️ Breaking Change (수정으로 인해 동작이 변경될 수 있음)

availableModels를 사용하여 사용 가능한 모델을 제한하고 있는 팀은, 수정 후에 서브 에이전트가 예상치 못한 모델을 호출하지 않게 됩니다. 의도한 동작이 바뀌지 않았는지 확인하십시오.

지금까지 서브 에이전트, 어드바이저 (Advisor) 모델, 디스패치 (Dispatch)용 피커에는 availableModels 제약이 적용되지 않아 제한을 우회할 수 있었습니다. 수정 후에는 모든 계층에 제약이 적용됩니다.

📌 영향받는 대상

환경 변수 AWS_REGION을 설정하지 않고 ~/.aws/config에서 리전 (Region)을 관리하고 있는 Bedrock 사용자.

수정 전에는 AWS_REGION이 미설정된 경우 리전 해결 (Resolution)이 실패하는 경우가 있었습니다. 수정 후에는 AWS SDK의 우선순위에 따라 ~/.aws/config에서 자동으로 리전을 읽어옵니다. /status 명령어를 통해 리전의 취득 출처도 확인할 수 있게 되었습니다.

대응 불필요 — ~/.aws/config가 올바르게 설정되어 있다면 자동으로 동작합니다.

⚠️ 중요한 보안 수정

Pre-warmed 워커 상의 백그라운드 에이전트가 다른 디렉토리의 .mcp.json 승인이나 신뢰 (Trust) 설정을 잘못 상속받을 가능성이 있었습니다.

의도치 않게 다른 프로젝트의 MCP 서버에 대한 접근 권한이 부여될 위험이 있었으므로, 이번 수정은 중요합니다. 공유 환경 또는 CI 환경에서 Claude Code를 실행하는 팀은 특히 주목해 주십시오.

대응 불필요 — v2.1.172 이후부터는 자동으로 수정됩니다.

📌 영향받는 대상

Opus 4.8 또는 Sonnet의 1M 컨텍스트 윈도우 (Context window)를 이용 중이며, 세션이 갑자기 멈추는 현상을 경험한 사용자.

사용 크레딧 없이 1M 컨텍스트를 이용하는 세션이 영구적으로 프리징(Freezing)되는 문제가 있었습니다. 수정 후에는 자동으로 표준 컨텍스트 상한까지 컴팩트 (Compact)되어 세션이 지속됩니다.

권한 (Permission) 설정에서 서브도메인에 와일드카드 (Wildcard)를 지정했을 경우, 수정 전에는 의도한 대로 작동하지 않았습니다. 수정 후에는 *.example.com이 api.example.com이나 docs.example.com에 올바르게 매칭됩니다.

수정 전 (검증 에러가 발생했던 케이스):

export const meta = {
name: 'my-workflow',
description: '태스크를 처리하는 워크플로우',
...

위와 같이 Date.now()나 Math.random()을 주석이나 문자열 내에 작성하는 것만으로도 워크플로우 검증이 거부되었습니다. 수정 후에는 주석 및 문자열 내의 언급은 검증 대상에서 제외됩니다.

💡 Tips

실제로 스크립트 본체에서 Date.now()나 Math.random()을 호출하는 것은 여전히 금지됩니다 (워크플로우 재개 시 재현성이 깨지기 때문). 타임스탬프가 필요한 경우에는 args를 통해 전달하십시오.

수정 전의 동작:

claude-fable-5[1m] → 그대로 사용 (정규화되지 않음)

수정 후의 동작:

claude-fable-5[1m] → claude-fable-5로 정규화 (Fable 5는 기본적으로 1M 컨텍스트)

Fable 5는 기본적으로 1M 컨텍스트 윈도우 (Context Window)를 가지므로, [1m] 접미사 (Suffix)는 필요하지 않으며 자동으로 제거됩니다.

릴리스	주요 변경 사항	조치 사항
v2.1.172	서브 에이전트 (Sub-agent) 5계층화, 1M 프리즈 (Freeze) 수정, availableModels 제약 수정, Bedrock 자동 리전 (Region) 해결, 보안 수정 (백그라운드 에이전트 설정 분리), 성능 개선	특별한 대응 불필요. availableModels를 사용 중인 팀은 동작 확인 권장
v2.1.173	Fable 5 모델명 정규화, Windows sandbox 경고 수정	특별한 대응 불필요

v2.1.172는 에이전트 개발자에게 특히 중요한 릴리스입니다. 다계층 에이전트 (Multi-layer Agent)의 공식 지원을 통해 더욱 복잡한 자율 에이전트 파이프라인 (Autonomous Agent Pipeline)을 구축하기가 용이해졌습니다. 동시에 availableModels 및 백그라운드 에이전트의 보안 수정도 포함되어 있으므로, 최신 버전으로의 업데이트를 강력히 권장합니다.