이 글에서 알 수 있는 것: Claude Code v2.1.325의 보안 수정 내용은 무엇인지, 기업이나 팀에서 사용하고 있다면 오늘 확인해야 할 변경점은 무엇인지, MCP(Multi-agent Collaboration Protocol) 및 인증/세션 관련 수정의 상세 내용입니다.
2026년 11월 14일, Claude Code v2.1.325가 출시되었습니다. 방금 나온 릴리스 노트를 읽고, 기업에서 Claude Code를 사용하는 입장에서 내용을 정리했습니다.
보안 수정이 포함되어 있으므로 오늘 중으로 업데이트하는 것을 강력히 권장합니다.
- 사내에서 Claude Code를 사용하는 엔지니어 또는 AI 추진 담당자
- 기업용 관리 설정(managed settings)을 사용하여 Claude Code를 관리하는 사람
- Claude Code의 업데이트 내용을 종합적으로 파악하고 싶은 사람
- MCP를 업무 흐름에 통합하여 사용 중인 팀
이번 릴리스에서 가장 먼저 언급된 것은 zstd 압축 응답 디코딩 관련 보안 수정입니다.
zstd(Zstandard)은 고속/고효율의 압축 알고리즘으로, HTTP 응답 전송량을 줄이는 데 사용됩니다. Claude Code가 서버로부터 zstd 압축 응답을 받을 때 디코드 처리 과정에 취약점이 있었던 것으로 알려졌습니다. 릴리스 노트에는 'Fixed a security issue in how zstd-compressed responses are decoded'라는 한 문장만 적혀 있을 뿐, CVE 번호나 영향 범위의 상세 내용은 공개되지 않았습니다.
보안 수정이 포함된 업데이트는 기능 추가보다 우선하여 적용하는 것이 기본입니다. 기업이나 조직에서 Claude Code를 사용하고 있다면 오늘 중으로 아래 명령어를 사용하여 업데이트할 것을 권장합니다.
npm install -g @anthropic-ai/claude-code
# 또는
claude update
업데이트 후에는 claude --version을 실행하여 v2.1.325 이상인지 확인하세요.
보안 수정의 배경으로, Claude Code는 서버로부터 응답을 여러 압축 형식으로 받을 수 있도록 설계되어 있습니다. zstd가 그중 하나이며, 특히 큰 컨텍스트를 다룰 때 사용되기 쉽습니다. 디코드 처리 버그가 어느 정도 영향을 미치는지에 대한 상세 정보는 공개되지 않았지만, '보안 문제'라고 명시된 이상 방치할 경우 위험이 큽니다.
VS Code나 유사한 통합 터미널을 사용하는 경우, 작지만 유용한 개선 사항이 추가되었습니다.
Claude가 Jupyter Notebook의 셀을 읽거나 편집한 후, '노트북 셀 재실행 방법'이라는 안내 스피너 칩(spinner chip)이 추가되었습니다. 노트북으로 실험을 반복하는 사람들에게는 다음 행동을 쉽게 알 수 있게 해주는 변경점입니다. 사소하지만 데이터 분석이나 ML 프로젝트에서 Claude Code를 사용하는 팀에게 실질적인 도움이 될 것입니다.
기업에서 관리 설정(managed settings)을 사용하여 Claude Code를 관리하는 경우와 관련된 변경 사항입니다.
기존에는 조직의 정책으로 인해 요청이 차단되었을 때 에러 메시지만 표시되어 다음 행동을 파악하기 어려웠습니다. 이번부터는 에러 아래에 '/rewind로 메시지를 변경하거나, /clear를 실행해 주세요'라는 안내가 추가되었습니다.
사용자가 정책 위반으로 인해 멈추었을 때 어떻게 해야 할지 몰라 막히는 상황이 줄어들 것입니다. 기업 전개 측면에서는 헬프데스크 문의 감소로 이어질 가능성이 있습니다.
여러 수정 사항이 포함되어 있으며, 기업에서 복잡한 에이전트 워크플로우를 구성하는 경우 영향을 받는 내용들이 포함되어 있습니다.
opusplan / haiku 모드에서의 모델 설정 문제: 모델 설정이 opusplan이나 haiku로 되어 있을 때, 서브 에이전트가 플랜 모드의 모델에 끌려가는 문제가 수정되었습니다. 의도한 모델로 서브 에이전트가 작동하지 않았을 가능성이 있습니다.
파일 읽기 크기 문제: 서브 에이전트가 다른 모델로 작동할 때, 메인 세션의 모델에서 파일 크기나 MCP 결과 크기를 판단하던 문제가 수정되었습니다. 메인과 서브에 각각 다른 모델을 사용하는 팀은 이 버그의 영향을 받았을 수 있습니다.
두 경우 모두 '작동하는 것처럼 보였지만, 의도한 모델이나 설정으로 작동하지 않았던' 사례입니다. 서브 에이전트를 사용하는 워크플로우가 있다면 업데이트 후 동작 확인을 해보는 것이 좋습니다.
기업 이용 시에는 인증 관련 버그가 작업에 직접적인 영향을 주는 경우가 많습니다. 이번에도 여러 수정 사항이 포함되었습니다.
사드파티 게이트웨이에서의 오류: 많은 사드파티 게이트웨이나 Foundry에서 세션을 사용할 수 없어 턴마다 컨텍스트 길이 오류(context length error)가 발생하던 문제가 수정되었습니다. 컴팩션이 되지 않은 상태에서 턴마다 에러가 발생했다면 상당한 스트레스였을 것입니다.
재개 세션의 누락: Claude Code를 깨끗하게 종료하지 않고 중지한 후 재개했을 때, 최근 턴이 사라지는 경우가 있었습니다. 이것이 수정되었습니다. 세션을 자주 중간에 닫는 경우와 관련됩니다.
작업 디렉터리가 삭제된 후의 셸 명령어: 작업 디렉터리가 삭제된 후에 셸 명령어를 실행하면, 시작 디렉터리에서 작동하던 문제가 수정되었습니다. 앞으로는 "삭제되었습니다"라는 메시지가 표시되고 재실행을 요청하는 형태로 변경됩니다. CI/CD 파이프라인에서 흔한 상황이라 영향을 받은 사람이 많았을 수 있습니다.
계획 폴더에 쓰기 실패 시 대응: 플랜(plan)을 승인할 때, plansDirectory 폴더에 쓰기가 실패하면 승인이 사라지는 문제가 있었습니다. 앞으로는 기본 계획 폴더에 저장되며, 어디에 저장되었는지와 이유가 통지됩니다.
Amazon Bedrock에서의 토큰 문제: allowedProviders의 관리형 설정에서 프로바이더가 허용되지 않았을 때, 대화 내용이 Bedrock으로 전송되던 문제가 수정되었습니다. 기업에서 Bedrock을 사용하는 경우와 관련됩니다. 의도하지 않은 프로바이더로 요청이 발생했을 가능성이 있으므로, Bedrock 이용자는 확인해 보시기 바랍니다.
/security-review 명령어 또는 스킬 내 인라인 git 명령어가 베어 리포지토리(--separate-git-dir) 체크아웃, Android 레포 체크아웃의 워크트리에서 에러가 나며 멈추던 문제가 수정되었습니다. 보안 검토를 자동화 파이프라인에 통합하는 팀은 특히 확인해야 할 변경 사항입니다. 베어 리포지토리를 사용하는 경우는 적을 수 있지만, --separate-git-dir는 CI에서 자주 사용되는 구성이라 영향을 받은 환경이 있었을 가능성이 있습니다.
이번에는 MCP 관련 수정 사항이 특히 많습니다. 기업에서 여러 MCP를 사용하는 경우 주의 깊게 살펴보시기 바랍니다.
인증 문제: 일시적으로 토큰 새로 고침(token refresh)이 거부된 후에도, MCP 서버가 "인증이 필요한 상태"로 남아있던 문제가 수정되었습니다. 인증에 성공했음에도 MCP를 사용할 수 없는 상태가 지속되었다면 이것이 원인이었을 수 있습니다.
elicitation 취소: 헤드리스 모드에서 서버 연결이 전환된 직후에 도구 호출의 elicitation(확인 요청)이 취소되던 문제가 수정되었습니다.
"Not connected" 오류: SDK 호스트에서 MCP 도구를 호출했을 때, 재연결 후 "Not connected"를 반환하던 문제가 수정되었습니다. 재연결 처리는 정상적으로 작동했으나, 도구 호출 측에 통지되지 않았던 문제로 보입니다.
멈추는 문제: 백그라운드 MCP 작업이 질문을 Esc 키로 닫거나 다시 표시한 후에 멈추던 문제가 수정되었습니다. 푸터에 "입력이 필요합니다"라고 표시되고, /tasks에서 Enter를 누르면 질문이 다시 표시되는 형태로 변경되었습니다.
다른 호출로 연결 끊김 후 업데이트 중지: 같은 서버에 대한 다른 호출이 연결을 잃고, 그 이후의 호출에서 재연결했을 때, 백그라운드 MCP 작업의 업데이트가 멈추던 문제가 수정되었습니다.
작업 중 입력란에 태스크 질문이 겹치는 문제: 백그라운드 MCP 작업의 질문이, 메시지를 입력하는 상단에 겹쳐 표시되던 문제가 있었습니다. 앞으로는 전송 또는 초안을 지울 때까지 대기하며, 스피너와 턴 타이머는 계속 작동하게 됩니다.
MCP 수정 사항이 이렇게 많은 것은 이용자가 늘어나면서 피드백이 많이 모였기 때문일 것입니다. 에지 케이스(edge case)가 보이기 시작하는 단계라고 생각합니다.
일상적인 조작과 관련된 수정도 몇 가지 있습니다.
/stats의 날짜 오류: 활성 일수 합계가 하루 더 많이 표시되었습니다. 사소하지만, 이용 현황을 주기적으로 확인하던 사람은 지금까지 데이터가 하루 분만큼 틀렸다는 의미입니다.
** /insights 문제**: 대상 세션이 없는데도 '보고서가 준비되었습니다'라고 표시하던 문제와, HTML 보고서에 값을 작성할 때 이스케이프(escape) 처리가 되지 않던 문제가 수정되었습니다.
** /voice 수정**: 관리 설정이나 설정 파일이 음성 모드(Voice mode)를 고정하고 있더라도 '음성 모드가 변경되었습니다'라고 표시하던 문제가 수정되었습니다. 이제는 어떤 요소가 모드를 고정하고 있는지 표시됩니다.
** /fast 오표시**: 키가 없는 콘솔 로그인 시 '조직에 의해 Fast 모드가 비활성화되어 있습니다'라고 표시되던 문제가 수정되었습니다. 실제로는 서버에서 확인하지 않았기 때문입니다.
** /model 오표시**: 네트워크 연결이 안 된 상황에서도 '모델이 제한됩니다'라고 표시되던 문제가 수정되었습니다.
IDE 환영 다이얼로그(Welcome Dialog) 표시 오류: Windows와 Linux에서 Cmd+Esc로 표시되던 문제가 수정되었습니다.
그 외에도 다수의 수정 사항이 포함되어 있습니다.
- 샌드박스(Sandbox)의 git checkout/stash가 보호 파일을 업데이트할 수 없을 경우 Claude에 주석을 추가하도록 했습니다.
sonnet[1m] 모델 설정이 신규 설치 시 API에서 거부하는 ID로 덮어쓰여지던 문제가 수정되었습니다. - 스케줄 작업(Schedule task)이 응답한 후, 포커스 보기(Focus view)가 응답을 숨기던 문제가 수정되었습니다.
- 백그라운드 서브 에이전트(Background sub-agent)의 뷰에서 프롬프트가 보이지 않던 문제가 수정되었습니다.
- 긴 옵션(long option)이 목록이나 권한 프롬프트 중간에 덮어씌워지던 문제가 수정되었습니다.
- 시작 시 경고(권한 규칙 또는 'N개의 MCP 서버가 인증을 필요로 합니다')가 스크롤 아웃된 상태에서 '확인됨'으로 기록되던 문제가 수정되었습니다.
- Slack 앱의 힌트가 조직 정책에 의해 클라우드 세션이 거부되었음에도 표시되던 문제가 수정되었습니다.
claude purge가 터미널 없이 멈추는(hang) 문제가 수정되었습니다. - claude plugin eval --output-dir ''가 현재 폴더에 작성하던 문제 (오류로 종료되도록 변경됨)가 수정되었습니다. - .oauth_refresh.lock.owner.tmp.* 파일이 쌓여가던 문제가 수정되었습니다. - Worktree의 희소 경로(sparse path) 설정으로 인해 리포지토리의 루트 파일이 누락되던 문제가 수정되었습니다.
업데이트는 다음 명령어로 진행합니다.
# npm으로 설치한 경우
npm install -g @anthropic-ai/claude-code
# 내장 업데이트 명령어
...
업데이트 후에는 사용 중인 MCP 연결 확인과 주요 워크플로우의 작동 여부를 점검해 보는 것이 안전합니다.
이번 정리 내용은 공개된 릴리스 노트만을 기반으로 합니다. 보안 수정에 대한 CVE 번호, 영향 범위, CVSS 점수는 공개되지 않았기 때문에 상세한 취약점 평가는 되어 있지 않습니다. 기업의 보안 정책상 상세 정보가 필요한 경우 Anthropic에 직접 문의해 주시길 바랍니다.
MCP 관련 수정은 몇 가지 엣지 케이스(edge case)를 대상으로 했으며, 모든 환경에서 재현되던 것은 아닙니다. 실제로 사용해보시고 본인의 환경에서 적용되었는지 판단하는 부분이 있습니다.
출처: Claude Code v2.1.325 릴리스 노트 (2026년 11월 14일 공개)
Copilot이나 AI 도구를 대기업에서 어떻게 전개할지에 대해 작성한 글은 여기입니다:
'더 이상 이전 방식으로 돌아갈 수 없다'고 들었던 날 — Copilot이 200명에게 확산되기까지의 이야기
무인 실행 중단 원인 점검을 코코나라(Coconala)에서 받고 있습니다 ('Claude Code 점검'으로 검색).