Claude Code v2.1.172 출시 | 매일 Changelog 해설 - Insights | Molayo

v2.1.172가 공개되었습니다. 서브 에이전트(Sub-agent)가 자신의 서브 에이전트를 호출할 수 있게 된 회차입니다. 나머지는 대부분 버그 수정이지만, 권한(permission) 규칙과 1M 컨텍스트(Context) 주변에 실질적인 영향을 주는 수정이 포함되어 있습니다.

서브 에이전트의 다계층 중첩

서브 에이전트가 자신의 서브 에이전트를 최대 5계층까지 기동할 수 있도록 지원
1M 컨텍스트의 스택 자동 회피
크레딧 없이 1M을 사용한 세션이 멈추는 결함을 수정. 표준 상한까지 자동으로 압축하여 복구
WebFetch의 와일드카드 도메인 허용 기능 작동
*.example.com이 서브도메인에 전혀 매치되지 않던 버그를 수정
마켓플레이스의 플러그인 목록 필터링 가능하게 변경 (/plugin에 플러그인 검색바 추가)
Bedrock 관련
~/.aws에서 리전을 읽도록 변경. AWS_REGION 미설정 시 AWS SDK와 동일한 우선순위로 해결
긴 대화와 유휴(Idle) 시의 부하 경감
불필요한 메시지 정규화(Normalization)를 삭제하고, 유휴 시 재그리기(Redraw)를 억제

이후에 다루는 변경 사항은 모두 v2.1.172에 해당합니다.

대상 독자: 서브 에이전트로 조사나 구현을 병렬화하고 있는 사람

지금까지 서브 에이전트는 말단이었습니다. 부모가 분할한 태스크를 받아 스스로 처리하고 반환할 뿐이었습니다. 이번부터는 그 서브 에이전트 자신이 다시 또 다른 서브 에이전트를 기동할 수 있습니다. 깊이는 최대 5계층입니다.

규모가 큰 리팩토링(Refactoring)이나 횡단 조사를 재귀적으로 분해할 수 있게 됩니다.

부모 에이전트
├─ 자식: 인증 관련 조사
│ ├─ 손자: login.ts 정밀 조사
...

부모가 영역을 할당하고, 자식이 영역 내를 파일 단위로 할당하며, 손자가 개별 파일을 읽습니다. 지금까지 부모 1단계에서 떠안아야 했던 분할 작업을 각 계층으로 밀어낼 수 있습니다.

단, 5계층이라는 상한이 있습니다. 무한히 증식하여 병렬도가 파괴되는 것을 방지하기 위한 캡(Cap)입니다. 깊은 중첩을 구성할 때는 각 계층이 무엇을 반환할지 명시해 두지 않으면, 손자의 출력이 부모까지 그대로 통과하여 문맥(Context)이 옅어질 수 있습니다.

permission에서 와일드카드 도메인을 허용 또는 거부하는 설정에 대한 수정입니다.

WebFetch(domain:*.example.com)를 allow에 작성해도 docs.example.com과 같은 서브도메인에 전혀 매치되지 않았습니다. allow뿐만 아니라 deny, ask에서도 마찬가지였습니다. 또한 Read(secrets-*/config.json)와 같이 패턴 중간에 와일드카드를 둔 규칙은 기동 시 차단되어 에러가 발생했습니다.

// settings.json: 지금까지 통과되거나 기동 에러가 발생하던 규칙
{
"permissions": {
...

deny로 막았다고 생각했는데 통과되었던 케이스도 포함됩니다. 와일드카드로 허용/거부를 세밀하게 작성한 설정일수록 의도와의 괴리가 컸던 수정입니다. 한 번 settings.json을 다시 읽어볼 가치가 있습니다.

usage 크레딧 없이 1M 컨텍스트를 사용하면 세션이 영구적으로 멈추는 경우가 있었습니다. 이번부터는 표준 컨텍스트 상한까지 자동으로 컴팩트(압축)하여, 멈추지 않고 처리를 계속합니다.

카테고리	변경점	개요
기능 추가	`/plugin` 검색바	마켓플레이스의 플러그인 목록을 검색
기능 추가	Bedrock 리전 해결	`~/.aws`에서 읽고, `/status`에 취득처를 표시
측정	OTEL `lines_of_code.count`	`model` 속성을 추가
성능	긴 대화	불필요한 정규화 및 전체 변환을 축소
성능	유휴(Idle) CPU	`/goal` 칩의 5Hz 재그리기를 정지
성능	Claude in Chrome	브라우저 도구를 1회의 배치(Batch)로 로드
UX	`/code-review ultra`	claude.ai 미로그인 상태에서도 옵션 표시
UX	Remote Control	푸터 표시를 "/rc active"로 단축

기타 버그 수정(v2.1.172)

여러 이미지를 포함한 대화에서 "an image ... could not be processed" 에러가 반복되는 버그
agents view에서 워커(worker) 응답 후에도 최대 30초 동안 스피너(spinner)가 계속 돌아가는 버그
백그라운드 에이전트(background agent)가 다른 디렉토리의 프로젝트 설정(.mcp.json 승인, trust)을 읽을 가능성
데몬(daemon) 자동 업데이트 후 이전 버전에서 시작된 백그라운드 세션에 attach 시 EAUTH로 실패하는 문제
중첩된 자식 에이전트(nested child agent) 정지 후에도 백그라운드 서브 에이전트(background sub-agent)가 "active" 상태로 멈춰 있는 현상
claude agents의 /model 후보가 잘못된 슬래시 접두사로 표시되거나, 조직에서 비활성화된 모델이 표시되는 문제
availableModels 제한이 서브 에이전트의 모델 덮어쓰기, dispatch 피커(picker), advisor 모델에 적용되지 않는 문제
availableModels 허용 목록이 claude-opus-4-8과 같은 version-specific ID 사용 시 Opus / Sonnet 1M을 숨기는 문제
Bedrock의 /model 피커가 제공되지 않는 모델을 표시하고, 선택 시 세션 모델을 조용히(silently) 전환하는 문제
ANTHROPIC_DEFAULT_OPUS_MODEL에 이미 접미사(suffix)가 있는 경우 [1M][1m]이 이중으로 표시되는 문제
opusplan이 플랜 모드(plan mode)에서 1M 컨텍스트를 동반하지 않는 버그 및 opusplan[1m] 우회책(workaround) 수정
위쪽 화살표 프롬프트 히스토리가 서브 에이전트의 채팅 탭 표시 중에 메인 쪽의 프롬프트를 표시하는 문제
원격 세션에서 마운트된 팀 메모리 스토어(CLAUDE_MEMORY_STORES)를 메모리 리콜(memory recall)이 찾지 못하는 문제
workflow 검증이 Date.now() / Math.random()을 언급한 주석이나 문자열을 잘못 거부하는 문제
미지원 Windows 콘솔에서 마우스 트래킹(mouse tracking)을 비활성화
/plugin 마켓플레이스 목록이 긴 리스트에서 돌아올 때 커서를 잃거나, Esc 키로 잘못된 탭으로 돌아가는 문제
비대화형(non-interactive) Usage Policy 거부 메시지를 개선하여 신규 세션 시작 또는 모델 변경을 안내
원격에서 /loop 홍보를 중단 (pending loop가 컨테이너를 유지하지 않기 때문)
[VSCode] PowerShell 툴 콜(tool call)이 생(raw) JSON으로 표시되는 버그 수정 및 표시 셸 출력에서 ANSI 이스케이프 제거

핵심은 서브 에이전트의 재귀적 중첩(recursive nesting)입니다. 다만 실무에서 지금 당장 유용한 것은 WebFetch의 와일드카드 허용과 1M 스택 수정 쪽입니다. 특히 전자의 경우 allow와 deny가 지금까지 의도대로 작동하지 않았으므로, 권한(permission)을 세밀하게 작성하고 있다면 동작이 달라질 것입니다.

Claude Code v2.1.172 출시 | 매일 Changelog 해설

요약

핵심 포인트

기타 버그 수정(v2.1.172)

댓글