[Claude Code] 2.1.217, 서브에이전트 폭주에 상한이 걸렸어요

[Claude Code] 2.1.217, 서브에이전트 폭주에 상한이 걸렸어요

Claude Code 2.1.216과 2.1.217이 나왔어요. 이번 두 릴리즈에서 가장 큰 변화는 서브에이전트 실행에 걸린 안전장치예요. 동시 실행 상한이 기본 20개로 잡혔고 중첩 스폰은 기본으로 꺼졌어요.

01. 서브에이전트가 무한정 불어나지 않게 됐어요

changelog 기준으로 메시지 하나가 백그라운드 에이전트를 무제한으로 만들 수 없도록 동시 실행 서브에이전트에 기본 20개 상한이 생겼어요. 서브에이전트가 다시 서브에이전트를 만드는 중첩 스폰은 아예 기본으로 막혔어요.

두 값 모두 환경 변수로 조절 가능해요. 기본값이 부족한 대규모 에이전트 워크플로우를 굴리는 케이스라면 확인해둘 부분이에요.

export CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS=40   # 동시 실행 상한 (기본 20)
export CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=2    # 중첩 스폰 허용 깊이 (기본 차단)

비용 쪽 구멍도 같이 막혔어요. --max-budget-usd 상한에 도달해도 백그라운드 서브에이전트가 계속 돌던 버그가 고쳐져서 이제 상한을 넘으면 새 스폰이 거부되고 실행 중이던 백그라운드 에이전트도 멈춰요.

02. :heart: 치면 ❤️가 들어가는 자동완성이 생겼어요

프롬프트 입력창에 이모지 숏코드 자동완성이 붙었어요. :heart:를 치면 ❤️로 바뀌고 :hea까지만 쳐도 후보가 떠요. 필요 없으면 emojiCompletionEnabled 설정으로 끌 수 있어요.

03. 트랜스크립트가 조용히 사라지던 상황에 경고가 붙었어요

디스크가 가득 차서 트랜스크립트 쓰기가 실패하거나 물려받은 환경 변수 탓에 세션 저장이 꺼져 있으면 그동안은 기록이 소리 없이 날아갔어요. 2.1.217부터는 이 상황에서 경고를 띄워줘요.

메모리 누수 수정도 하나 있어요. 잘린 MCP tool 출력이 원본 전체를 세션 끝까지 메모리에 붙잡고 있던 문제가 고쳐졌어요. MCP 서버를 많이 붙여 쓰는 환경이라면 체감될 만한 수정이에요.

격리 구멍도 하나 닫혔어요. 심볼릭 링크가 걸린 작업 폴더를 정규화하지 않아 백그라운드 세션이 자기 작업 폴더 밖으로 빠져나갈 수 있던 문제가 2.1.217에서 고쳐졌어요.

04. 2.1.216은 긴 세션 느려짐을 잡은 릴리즈예요

긴 세션에서 턴이 쌓일수록 메시지 정규화 비용이 제곱으로 늘어나 몇 초씩 멈추고 resume도 느려지던 문제가 2.1.216에서 고쳐졌어요. 세션을 길게 끌고 가는 사용자에게는 이게 제일 반가운 항목일 듯해요.

설정도 하나 추가됐어요. sandbox.filesystem.disabled를 켜면 네트워크 egress 제어는 유지하면서 파일시스템 격리만 끌 수 있어요. 샌드박스를 통째로 켜고 끄는 것만 되던 기존보다 조합이 유연해졌어요.

격리 관련 수정도 있어요. worktree 격리 서브에이전트가 git -C나 GIT_DIR 변수로 공유 checkout에 손대던 우회로가 막혔어요.

업데이트는 claude update 한 번이면 돼요. 상한 기본값이 실제 워크플로우에 어떤 영향을 주는지는 직접 써보고 판단할 부분이에요.

출처: Claude Code CHANGELOG (공식), Claude Code Docs — What's new

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