Claude Code v2.1.211은 백그라운드 에이전트를 실행하거나, 플러그인 MCP 서버를 사용하거나, 멀티 에이전트 워크플로우를 처리하는 사용자들을 위한 실용적인 업데이트입니다. 이 버전은 새로운 모델이나 새로운 에이전트 프레임워크를 도입하지 않습니다. 대신, 서브 에이전트에 대한 관찰 가능성(observability)을 추가하고, 에이전트 워크플로우를 혼란스럽거나, 멈추게 하거나, 안전하지 않게 만들 수 있는 긴 목록의 실패 모드들을 수정했습니다.

이 업데이트는 7월 15일에 게시되었습니다. v2.1.211 전체 릴리스 노트 읽기.

주요 변경 사항: 스트림-json에서 서브 에이전트 출력 전방 전달(forward subagent output in stream-json)

이번 릴리스에서는 --forward-subagent-text 플래그와 CLAUDE_CODE_FORWARD_SUBAGENT_TEXT 환경 변수가 추가되었습니다. 이들은 서브 에이전트의 텍스트와 사고 과정(thinking)을 stream-json 출력에 포함합니다.

이는 Claude Code가 다른 시스템, 예를 들어 대시보드, CI 작업, 오케스트레이터 또는 사용자 지정 터미널 UI의 일부로 사용될 때 중요합니다. 위임된 작업에 대한 가시성이 없으면, 부모 태스크는 서브 에이전트가 실제로 진행 중이거나, 막혔거나, 중요한 발견을 내고 있음에도 불구하고 유휴 상태인 것처럼 보일 수 있습니다.

추가 스트림은 유용할 때만 사용하세요. 이는 로그 볼륨을 증가시키고, 다운스트림 시스템에 더 많은 작업 세부 정보를 노출하며, 파서를 더 복잡하게 만들 수 있습니다. 프로덕션 통합의 경우, 전체 서브 에이전트 텍스트가 필요한지, 라이프사이클 상태(lifecycle status)만 필요한지, 아니면 필터링된 이벤트 피드가 필요한지를 결정해야 합니다.

백그라운드 에이전트: 가짜 완료 감소 및 오래된 작업 감소

여러 수정 사항들이 백그라운드 및 멀티 세션 사용을 목표로 합니다:

• Claude Code는 이제 여전히 실행 중인 백그라운드 에이전트의 상태를 보고하고, 결과를 임의로 생성하기보다 실제 완료를 기다립니다.
• 사용자가 종료했지만 나중에 자동 재개되어 오래된 프롬프트를 다시 실행했던 백그라운드 에이전트 문제를 수정했습니다.
• 여러 세션이 하나의 자격 증명 저장소(credential store)를 공유할 때, 절전 모드에서 깨어난 후 모두 로그아웃되던 문제를 수정했습니다.
• 데몬 재개 후

이러한 유형의 실패는 가시적인 증상이 모호한 경우가 많아 디버깅 시간을 낭비하게 만듭니다. 예를 들어, 에이전트가 작업을 완료한 것처럼 보이거나, 세션이 끊긴 것처럼 보이거나, 혹은 오래된 작업이 갑자기 나타나는 식입니다.

팀이 컨텍스트를 공유해야 할지 아니면 위임해야 할지를 결정하는 데 대한 더 자세한 가이드는 Claude Code Agent Teams: When Shared Context Beats More Subagents를 참조하세요.

MCP 및 모델 선택 신뢰성

v2.1.211 버전은 유휴 웹 세션이 깨어난 후 플러그인 MCP (Model Context Protocol) 서버가 재연결되지 않던 문제도 수정했습니다. 이전에는 다음 메시지가 전달될 때까지 MCP 호출이 실패할 수 있었습니다. 플러그인 서버를 통해 외부 도구에 의존하는 경우, 업그레이드 후 유휴 상태에서 재개되는 경로를 테스트해 보시기 바랍니다.

이번 릴리스에서는 또한 두 가지 모델 선택 (model-selection) 문제도 수정했습니다:

1. Vertex AI 및 Bedrock 기반의 Claude Code가 시작 시 기본 Opus 모델을 시도하려고 시도하며, 모델이 명시적으로 설정되어 있음에도 불구하고 오해의 소지가 있는 폴백 (fallback) 알림을 표시하던 문제.
2. 모델을 명시적으로 오버라이드 (override)한 서브 에이전트가 재개되거나 후속 메시지를 받은 후 부모 모델로 되돌아가는 문제.

두 번째 수정 사항은 비용 및 라우팅 (routing) 정책과 특히 관련이 깊습니다. 서브 에이전트에 의도적으로 더 저렴하거나 특화된 모델을 할당한 경우, 해당 할당이 재개 후에도 유지되는지 확인하십시오. 모델 라우팅 정책은 작업의 실제 라이프사이클(lifecycle) 동안 지속될 때에만 유용합니다.

권한, 업로드 및 워크트리 (worktrees)

이번 릴리스에는 주목할 만한 보안 및 워크플로 (workflow) 수정 사항도 포함되어 있습니다:

• 채팅 채널로 전달되는 권한 미리보기 (Permission previews)에서 이제 양방향 오버라이드 (bidirectional-override), 제로 너비 (zero-width), 유사 인용 부호 (look-alike quote) 문자를 무력화하므로, 도구 입력값이 승인 메시지를 시각적으로 변조할 수 없습니다.
• 샌드박스 처리되지 않은 Bash에 대한 PreToolUse 훅의 ask 결정은 더 이상 자동 모드 (auto mode)에 의해 오버라이드될 수 없습니다. 이제 해당 결정은 프롬프트 (prompt) 상태로 유지됩니다.
• “항상 허용 (Always allow)” 권한 규칙이 이제 리포지토리 루트 (repository root)에 저장되어, Git 워크트리 (worktree)에서 부여된 승인이 세션 및 워크트리 전반에 걸쳐 유지됩니다.
• 파일 업로드 검증 시 DOS 장치 접미사(device suffix)나 마지막 점(trailing dot)으로 끝나는 파일명은 허용하는 반면, 여러 개의 하드 링크 (hard links)를 가진 파일은 거부합니다.
• Chrome 내의 Claude는 파일 업로드 경로 검증을 강화합니다.

권한 미리보기 수정 사항의 실질적인 보안 영향에 대해서는 Your Coding Agent’s Approval Prompt Is a Security Boundary를 참조하세요.

기타 개발자 경험 (developer-experience) 수정 사항

CLI를 집중적으로 사용하는 경우 다음 몇 가지 변경 사항이 중요할 것입니다:

지금 해야 할 일

1. Claude Code v2.1.211로 업그레이드하고, 전체 목록은 공식 릴리스 노트 (official release notes)를 확인하세요.
2. stream-json을 사용하는 경우, 서브 에이전트 (subagent) 텍스트를 로그에서 전달, 필터링 또는 생략할지 여부를 평가하세요.
3. 사용하는 각 플러그인 MCP 서버에 대해 유휴 및 재개 (idle-and-resume) 테스트를 한 번씩 실행하세요.
4. 명시적인 모델 오버라이드 (model override)와 함께 서브 에이전트를 재개하고, 할당된 모델이 유지되는지 확인하세요.
5. 중단된 백그라운드 에이전트 (background agent)를 테스트하여 이전 프롬프트를 다시 실행하지 않는지 확인하세요.
6. 팀이 “항상 허용 (always allow)” 규칙에 의존하는 경우, 워크트리 권한 동작을 검토하세요.

이번 업데이트는 Claude Code를 단순한 단일 대화형 터미널이 아닌, 에이전트 시스템 (agent system)으로 운영하는 팀에게 가장 유용합니다. 만약 짧은 로컬 편집 용도로만 사용한다면 변경 사항이 덜 눈에 띌 수 있습니다. 하지만 백그라운드 작업 (background tasks), 도구 통합 (tool integrations), 모델 라우팅 (model routing), 그리고 공유 워크트리 (shared worktrees)를 사용하는 경우에는 이번 수정 사항들이 여러 까다로운 문제점들을 해결해 줄 것입니다.

이러한 종류의 에이전트 실패에 대한 회귀 테스트 커버리지 (regression coverage)를 구축하고 있다면, 매 업그레이드마다 수동으로 재테스트에 의존하는 대신 프로덕션 트레이스 (production traces)를 반복 가능한 평가 케이스로 전환하세요.

출처

• Claude Code v2.1.211 release notes

v2.1.211의 변경 사항 중 귀하의 워크플로 (workflow)에서 가장 중요한 것은 무엇인가요: 서브 에이전트 스트리밍 (subagent streaming), MCP 복구 (MCP recovery), 모델 오버라이드 (model overrides), 아니면 백그라운드 에이전트의 신뢰성 (background-agent reliability)인가요?