[Claude Code] 2.1.219, 중첩 서브에이전트가 3단계로 풀렸어요

[Claude Code] 2.1.219, 중첩 서브에이전트가 3단계로 풀렸어요

Claude Code 2.1.219와 2.1.220이 나왔어요. 이번 릴리즈에서 가장 큰 변화는 서브에이전트 중첩 스폰이에요. 2.1.217에서 기본 차단으로 잠갔던 항목이 두 릴리즈 만에 기본 3단계 허용으로 열렸어요.

01. 서브에이전트가 다시 서브에이전트를 부를 수 있어요

changelog 기준으로 서브에이전트의 중첩 스폰 허용 깊이 기본값이 1에서 3으로 바뀌었어요. 서브에이전트가 만든 서브에이전트가 또 서브에이전트를 만드는 데까지 열린 셈이에요.

2.1.217에서 이 값이 1로 잠기면서 중첩이 아예 막혔던 걸 감안하면 짧은 주기의 방향 전환이에요. 동시 실행 상한 20개는 그대로예요. 무한정 늘어나는 쪽이 아니라 깊이만 열어준 형태로 보여요.

중첩이 부담스러우면 예전 동작으로 되돌리는 환경 변수가 그대로 남아 있어요.

export CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1   # 중첩 스폰 끄기 (2.1.219 기본값은 3)

headless 쪽도 같이 손봤어요. --forward-subagent-text를 켜면 depth-2 이상에서 생긴 서브에이전트도 stream-json 출력에 나타나요. 각 출력은 자기를 띄운 Agent tool_use id로 묶여요. 중첩을 실제로 쓸 거라면 로그가 먼저 보여야 하니 짝이 맞는 변경이에요.

02. 워크플로우 크기에 기본 가이드라인이 생겼어요

동적 워크플로우의 기본 크기 가이드라인이 medium으로 잡혔어요. 에이전트 15개 미만을 목표로 하라는 권고값이에요. 다른 크기나 무제한으로 바꾸려면 /config의 Dynamic workflow size에서 고르면 돼요.

설정 파일에서도 지정할 수 있게 workflowSizeGuideline 키가 추가됐어요. 이 키가 설정돼 있으면 /config 화면의 해당 행은 숨겨져요. 실행 중인 워크플로우 상태줄에도 현재 기본 크기가 표시된다고 적혀 있어요.

03. 샌드박스가 허용 목록 밖 호스트를 묻지 않고 바로 막아요

sandbox.network.strictAllowlist 설정이 추가됐어요. 샌드박스로 돌아가는 명령이 허용 목록에 없는 호스트로 나가려 할 때 승인 프롬프트 없이 바로 거부하는 옵션이에요.

매번 뜨는 네트워크 승인 창을 줄이려는 목적보다는, 무인으로 도는 세션에서 나가는 트래픽을 확정적으로 잠그는 쪽에 쓰임새가 있을 것으로 보여요.

04. 작업 폴더가 붙는 시점에 훅이 걸려요

DirectoryAdded 훅이 생겼어요. /add-dir로 폴더를 추가하거나 SDK의 register_repo_root 요청으로 세션 중간에 새 작업 폴더가 등록될 때 발생해요. 세션 시작 시점에만 걸 수 있던 준비 작업을 폴더가 붙는 시점으로 옮기면 돼요.

MCP 쪽 진단도 같이 붙었어요. headless stream-json 초기화 이벤트에 mcp_server_errors가 추가돼 설정 검증에서 걸러진 --mcp-config 항목이 목록으로 나오고, 터미널 실행에서는 시작 경고로 떠요. claude mcp list와 /mcp는 서버 연결 실패 시 HTTP 상태와 오류 문구를 같이 보여줘요. MCP 설정값 앞뒤에 눈에 안 보이는 공백이 섞여 있으면 경고도 나와요.

05. 모델 쪽은 Opus 5 정리가 들어갔어요

Claude Opus 5가 Claude Code에 들어오면서 기본 Opus 모델이 됐어요. context window는 1M이고, /model 선택창에서 병합된 Opus 행이 그냥 "Opus"로 나오던 표기가 "Opus (1M context)"로 고쳐졌어요.

fast mode에서는 Opus 4.7이 빠졌어요. /fast는 이제 Opus 5와 Opus 4.8에만 적용돼요. Fable 모델 행에 오래된 캐시 때문에 "Requires usage credits"가 잘못 붙던 문제도 수정됐어요.

2.1.220은 버그 수정과 안정성 개선만 담긴 릴리즈예요. 업데이트는 claude update 한 번이면 되고, 중첩 3단계 기본값이 실제 작업에 어떻게 작용하는지는 직접 써보고 판단할 부분이에요.

출처: Claude Code CHANGELOG

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