2026년 7월 24일, Claude Code v2.1.219가 출시되었습니다. 이번 업데이트의 핵심은 두 가지입니다. 첫 번째는 새로운 모델인 Claude Opus 5 (claude-opus-5)의 추가로, Opus 선택 시의 기본(default) 모델이 되었다는 점입니다. 1M 토큰의 거대한 컨텍스트 윈도우 (context window)를 지원하며, fast mode 요금은 입력 $10 / 출력 $50 per Mtok입니다. 두 번째는 **서브 에이전트의 중첩 생성 (nested generation)**이 기본적으로 깊이 1에서 3까지 확대되었다는 점입니다.

이에 더해, MCP 연결의 진단 정보 강화, 관리자용 MCP 허가 목록(allowlist) 해결 로직의 변경(확인 필요), claude -p 실행 시의 출력 누락 버그 수정 등 개발자 및 운영 담당자 모두에게 영향을 미치는 변경 사항이 포함되어 있습니다. 본 기사에서는 특히 영향도가 높은 변경 사항을 중심으로 "무엇이 바뀌었는가", "왜 중요한가", "어떻게 대응해야 하는가"를 정리합니다.

📌 영향을 받는 사람

• Claude Code에서 Opus 모델이나 fast mode를 사용 중인 사람
• 서브 에이전트 (Task/Agent 도구)를 활용한 다단계 오케스트레이션 (orchestration)을 구성하고 있는 사람
• MCP 서버를 조직의 managed-settings에서 허가/거부 목록으로 관리하고 있는 사람
• claude -p나 stream-json으로 headless 연동을 하고 있는 사람

이번 릴리스에 포함된 변경 사항을 영향 영역별로 정리하면 다음과 같습니다.

큰 흐름으로는 "모델의 업그레이드"와 "에이전트의 자율성 확대"가 동시에 진행되었으며, 이를 뒷받침하는 MCP의 가시성(observability) 및 견고성 개선이 포함된 릴리스입니다.

영향도가 높은 변경 사항을 중심으로 표로 정리합니다.

⚠️ Breaking Change

managed MCP의 허가/거부 목록에서 ${VAR}를 사용하고 있는 경우, 이전에는 settings 파일의 env에서 변수가 해결되었으나, 앞으로는 실행 시의 환경 변수와 **managed-settings의 env**에서만 해결되도록 변경되었습니다. settings 파일 측의 env에만 변수를 정의해 두었던 구성은 결과가 달라질 수 있습니다 (예: 허가되어야 할 호스트가 거부되는 등).

1. Opus 사용자는 기본 모델 변경을 확인하십시오

/model에서 Opus를 선택하고 있는 경우, 다음 실행 시부터 Opus 5가 기본으로 사용됩니다. CLAUDE.md나 팀의 운영 문서에 모델명을 명시하고 있다면 업데이트하십시오.

2. Opus 4.7에서 fast mode를 사용하던 팀은 이행이 필수입니다

/fast 명령어는 Opus 5와 Opus 4.8에만 적용됩니다. CI/CD나 스크립트에서 모델을 하드코딩(hard-code)하고 있다면 영향을 받습니다.

3. 서브 에이전트의 중첩 확대는 동작 변화에 주의하십시오

지금까지 "서브 에이전트(sub-agent)는 추가적인 서브 에이전트를 생성할 수 없다"는 전제로 설계했던 워크플로우가 있다면, 깊이(depth) 3까지 중첩(nesting)이 가능해짐에 따라 예상치 못한 에이전트 계층이 발생할 가능성이 있습니다. 기존 동작으로 고정하고 싶은 경우에는 환경 변수로 비활성화할 수 있습니다.

4. MCP 관리자는 허용/거부 리스트의 동작을 확인하십시오

managed-settings.json 등에서 ${VAR} 확장을 사용하고 있는 경우, 실제로 허용 및 거부가 의도한 대로 기능하는지 재검증하십시오.

# 기본적으로 깊이 3까지 중첩 생성이 가능해졌으나,
# 기존 동작(중첩 비활성화)으로 고정하고 싶은 경우 아래를 설정
export CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1

// Before: 허용 리스트 외의 액세스 시 사용자에게 확인 프롬프트가 나타남
{
"sandbox": {
...

// After: 허용 리스트 외의 액세스는 프롬프트 없이 즉시 거부
{
"sandbox": {
...

// managed-settings.json
{
"env": {
...

변경 전에는 각 settings 파일의 env에서도 ${INTERNAL_MCP_HOST}가 해결(resolve)되었으나, 변경 후에는 실행 시의 환경 변수와 **managed-settings의 env**만 참조됩니다. 일반 settings 파일의 env에 변수 정의를 맡기고 있었다면, managed-settings.json 측이나 셸(shell)의 환경 변수로 옮겨야 합니다.

// stream-json의 init 이벤트 예시
{
"type": "system",
...

SDK나 CI 파이프라인에서 headless 실행을 하고 있는 경우, 이 필드를 통해 "MCP 서버 설정이 조용히 무시되고 있었던" 상황을 프로그램적으로 감지할 수 있게 되었습니다.

Claude Opus 5가 새로 추가되었으며, Opus 선택 시의 기본값이 되었습니다 (1M 컨텍스트, fast mode $10/$50 per Mtok)

서브 에이전트의 중첩 생성이 기본적으로 깊이 3까지 가능해졌습니다. 기존 동작으로 되돌리려면 CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1을 설정하십시오.

Opus 4.7은 fast mode 대상에서 제외되었으므로, 이용 중이던 팀은 Opus 5/4.8로의 이전이 필요합니다.

managed MCP의 허용/거부 리스트의 ${VAR} 해결 원천이 변경되어 의도치 않은 동작 변화의 리스크가 있으므로 확인이 필요합니다.

MCP 연결 진단 강화 및 headless의 mcp_server_errors 추가 등, 운영의 가관측성(observability)도 꾸준히 향상되었습니다.

모델 업그레이드와 에이전트의 자율성 확대가 동시에 진행된 릴리스입니다. 특히 서브 에이전트의 중첩 확대와 MCP 허용 리스트의 변경은 기존 운영 플로우에 영향을 미칠 가능성이 있으므로, 업데이트 후에는 반드시 동작 확인을 수행할 것을 권장합니다.