Claude Code v2.1.217: 서브에이전트 제한 및 중요 버그 수정

Anthropic이 Claude Code v2.1.217을 출시했습니다. 이번 릴리스에서는 서브에이전트 관리에 큰 변화가 있었고, 오랫동안 요청받았던 이모지 자동 완성 기능이 추가되었으며, 메모리 누수, 세션 격리, Windows 자동 업데이트 손상 등 수많은 버그가 수정되었습니다.

서브에이전트 제어

이번 릴리스에서는 백그라운드 에이전트가 통제 불능 상태가 되는 것을 방지하기 위해 두 가지 환경 변수가 도입되었습니다:

CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS (기본값: 20) — 단일 메시지에서 동시에 실행할 수 있는 서브에이전트 수를 제한합니다.
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH — 서브에이전트는 기본적으로 중첩 에이전트를 생성하지 않습니다. 더 깊은 중첩을 허용하려면 이 값을 설정하세요.

또한 --max-budget-usd가 이제 백그라운드 서브에이전트를 중지합니다. 예산 한도에 도달하면 새 생성이 거부되고 실행 중인 백그라운드 에이전트가 중단됩니다.

이모지 자동 완성

이제 :heart:를 입력하면 ❤️가 삽입되거나, :hea를 입력하면 제안이 표시됩니다. emojiCompletionEnabled 설정으로 비활성화할 수 있습니다.

주요 버그 수정

메모리 누수 수정 — 잘린 MCP 도구 출력이 더 이상 전체 잘리지 않은 결과를 세션 내내 메모리에 보관하지 않습니다.
Windows 자동 업데이트 손상 — 실패한 업데이트로 claude.exe가 누락될 수 있는 문제를, 보존된 실행 파일을 자동으로 복원하여 해결했습니다.
백그라운드 세션 격리 — 심볼릭 링크된 작업 디렉터리가 이제 정규화되어 세션이 워크스페이스 폴더를 벗어나는 것을 방지합니다.
Bedrock의 Claude Opus 4.8 — 자동 압축이 제대로 작동하며, /compact가 한도 초과 시 더 이상 실패하지 않습니다.
기업 설정 — mTLS, TLS-verify, OAuth 범위, 프록시 설정이 이제 Claude Desktop 세션에서 적용됩니다.
스크린 리더 모드 — 시작 알림이 더 이상 잘리지 않으며, 생각 상태 행이 효율적으로 다시 렌더링됩니다.
텔레메트리 라우팅 — 관리형 OTEL_EXPORTER_OTLP_ENDPOINT가 이제 모든 신호를 제어하며, 하위 범위 재정의가 더 이상 텔레메트리를 다른 곳으로 리디렉션하지 않습니다.
대화록 처리 — --resume 및 /resume가 잘못된 첨부 파일 항목으로 더 이상 충돌하지 않으며, 대화록 쓰기 실패 시(예: 디스크 가득 참) 경고가 추가되었습니다.
원격 제어 — 권한 프롬프트가 프롬프트가 나타난 후 연결하는 뷰어에게도 표시됩니다.
중괄호 확장 — 많은 중괄호 그룹이 있는 CLAUDE.md / SKILL.md 경로가 더 이상 CLI를 OOM-종료하지 않으며, 확장이 예산 제한을 받도록 개선되었습니다.
바닥글 링크 — PR 배지 링크가 ssh/tmux에서도 클릭 가능한 하이퍼링크가 되었습니다. FORCE_HYPERLINK=0 설정으로 선택 해제할 수 있습니다.