
Claude Code 주간 업데이트 요약 (2026/06/27 주)
요약
Claude Code v2.1.185~v2.1.195 버전의 주요 업데이트 내용을 요약합니다. 훅 매처(hook matcher)의 동작 방식 변경, MCP 인증 프로세스 개선, 셸 명령어 자동 응답 기능 등 개발 환경에 영향을 미치는 주요 변경 사항을 다룹니다.
핵심 포인트
- 훅 매처가 부분 일치에서 완전 일치 방식으로 변경되어 정규 표현식 사용 권장
- 브라우저 없이 MCP 인증이 가능해져 헤드리스 환경 활용성 증대
- 셸 명령어 실행 후 Claude가 결과를 바탕으로 자동 응답하는 기능 추가
- CPU 사용률 약 37% 절감 및 /rewind 기능 확장
이 기사는 AI가 Claude Code의 CHANGELOG를 정리한 것입니다. 오류가 포함될 가능성이 있으므로, 중요한 판단은 공식 문서를 통해 확인하시기 바랍니다.
2026년 6월 27일 주 요약: GitHub 릴리스 노트를 확인하여 Claude Code v2.1.185~v2.1.195의 변경 사항 7건을 정리했다 (누락: v2.1.184 / v2.1.188 / v2.1.189 / v2.1.192 / v2.1.194). 설정 변경이 필요할 가능성이 높은 것은 v2.1.195의 훅 매처 (hook matcher) 수정으로, 하이픈이 포함된 식별자를 포함하는 훅 설정에 동작 변화가 생긴다. v2.1.186에서는 MCP 인증의 브라우저 불필요화, v2.1.191에서는 /rewind 확장 및 CPU 사용률 약 37% 절감이 보고되었다.
이번 주 Claude Code 업데이트를 정리했다. 대상은 v2.1.185~v2.1.195의 변경 사항이다 (지난번: 2026/06/20 주).
v2.1.190, v2.1.191, v2.1.193, v2.1.195의 출시일은 GitHub 타임스탬프 (UTC)로부터 추정한 값으로, ±1일의 오차가 발생할 가능성이 있다. 공식 What's New (code.claude.com/docs/ja/whats-new)는 본문 작성 시점에서 Week 24 (v2.1.166~176)까지만 게재되어 있으므로, 이 버전들에 대해서는 공식 문서에서의 확인을 권장한다.
무엇이 바뀌었나: 하이픈을 포함하는 식별자 (예: code-reviewer, mcp__brave-search)를 사용한 훅이 기존에는 잘못하여 부분 일치(partial match)하고 있었다. v2.1.195에서 이 문제가 수정되어 완전 일치(exact match)로 변경되었다.
사용 방법 및 주의사항: 이 수정은 기존 설정에 파괴적 변경(breaking change)을 가져올 수 있다. 예를 들어 mcp__brave-search를 hook matcher로 지정했을 경우, 수정 후에는 완전 일치로 평가되므로, 여러 도구에 패턴 매칭을 시키고 싶다면 mcp__brave-search__.*와 같은 정규 표현식 (regular expression) 표기법으로의 이행이 필요하다.
settings.local.json이나 CLAUDE.md의 hooks 섹션에 하이픈이 포함된 식별자를 적어두었다면, 업데이트 후에 훅이 의도한 대로 발화(trigger)되고 있는지 확인하는 것을 권장한다. 조용히 작동하지 않게 되는 타입의 변경이므로 간과하기 쉽다.
더불어 v2.1.195에서는 일본어, 중국어, 태국어 등 단어 사이에 공백을 넣지 않는 언어에서 음성 입력이 자동 전송되지 않던 버그도 수정되었다. 또한, 전체 화면 모드의 마우스 클릭/드래그/호버 조작을 환경 변수 CLAUDE_CODE_DISABLE_MOUSE_CLICKS로 무효화할 수 있게 되었다.
무엇이 바뀌었나: claude mcp login / claude mcp logout 명령어로 브라우저를 열지 않고 MCP 인증 플로우를 완결할 수 있게 되었다. 헤드리스 (headless) 환경이나 원격 서버 상에서의 MCP 이용 시, 브라우저를 사용할 수 없는 상황에서의 인증이 현실적으로 가능해진다.
! 명령어의 동작 변화:
! 명령어로 셸 명령어 (shell command)를 실행하면, 그 결과를 받아 Claude가 자동으로 응답을 반환하게 되었다. 셸 명령어의 실행 결과를 매번 확인하면서 대화할 수 있는 흐름이지만, 자동 응답이 필요하지 않은 경우에는 respondToBashCommands: false 설정으로 무효화할 수 있다. 기타: /workflows에 상태 필터 (실행 중, 완료됨으로 필터링 가능), /plugin에 Skills 섹션이 추가되었다.
무엇이 바뀌었나: 지금까지 /rewind (대화 되감기)는 직전의 /clear 이후 대화만을 대상으로 했으나, v2.1.191부터는 /clear 실행 전의 대화로도 거슬러 올라갈 수 있도록 확장되었다. 긴 세션 도중 중간에 /clear를 한 뒤
기타 수정 사항: 스크롤 점프(scroll jump) 수정, 백그라운드 에이전트(background agent)가 오작동하여 다시 활성화되는 버그 수정, 풀스크린(full screen) 모드에서 링크의 Cmd+Click이 작동하도록 개선된 3가지 사항이 포함된다.
| 버전 | 기능명 | 개요 | 영향도 |
|---|---|---|---|
| v2.1.185 | stream-stall hint 개선 | API 응답 대기 표시가 "20초 후 재시도" 방식으로 변경됨 (기존: 10초 후). 서브 에이전트(sub-agent) 내에서의 WebSearch 결과 없음 버그도 수정됨 | 낮음 |
| v2.1.187 | sandbox.credentials 설정 · 조직 모델 제한 · 마우스 클릭 대응 | ||
sandbox.credentials를 통해 인증 정보 파일에 대한 액세스를 차단할 수 있음. 조직 전체에서 사용할 모델을 제한하는 설정 추가. 풀스크린에서 마우스 클릭 조작이 가능해짐 (v2.1.195의 환경 변수로 비활성화 가능). 원격 MCP 도구 호출에 5분 타임아웃(timeout) 추가 | 중간 | ||
| v2.1.190 | 버그 수정 · 신뢰성 개선 | 버그 수정 및 신뢰성 향상만 포함. GitHub 릴리스(release)에 상세 내용 기재 없음 | 낮음 |
| v2.1.193 | autoMode.classifyAllShell · Bash 경로 자동 완성 · OpenTelemetry | ||
autoMode.classifyAllShell 설정으로 모든 Bash/PowerShell 명령을 auto mode 분류기(classifier)를 통해 라우팅할 수 있음. ! (Bash 모드)에서 라이브 파일 경로 자동 완성 추가. OTEL_LOG_ASSISTANT_RESPONSES=1 설정으로 assistant 응답을 OpenTelemetry로 출력하는 기능 추가. MCP 인증 스타트업(startup) 알림도 추가됨 | 중간 |
v2.1.195의 훅 매처(hook matcher) 수정은 개인의 settings.local.json에도 영향을 미칠 가능성이 있으므로, 직접 동작을 확인하는 대로 별도로 정리할 예정이다.
v2.1.185~v2.1.195 사이의 7가지 변경 사항을 확인했다. 하이픈(-)이 포함된 식별자의 훅 매처(hook matcher) 수정(v2.1.195)은 설정 파일의 재검토가 필요할 수 있으므로, 업데이트 후 조기에 확인해 두는 것이 좋다. CPU 사용률 37% 절감(v2.1.191)과 /rewind의 확장은 일상적인 사용 경험에 직결되는 변경 사항으로, 장시간 세션이 많은 사용자라면 체감하기 쉬울 것이다. hooks 섹션에 하이픈이 포함된 식별자(예: mcp__brave-search)를 사용하고 있다면, v2.1.195로 업데이트한 후 동작 확인을 권장한다.
settings.local.json이나 CLAUDE.md의 hooks 섹션에 하이픈이 포함된 식별자(예: code-reviewer, mcp__brave-search 등)를 사용하고 있다면 확인을 권장한다. v2.1.195부터 완전 일치(exact match) 방식으로 변경되었기 때문에, 여러 도구에 대한 매칭이 필요한 경우에는 mcp__brave-search__.*와 같은 정규 표현식(regular expression) 표기법으로의 전환이 필요하다.
이 기사는 はてなブログ(Hatena Blog)로부터의 크로스 포스트입니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 Qiita AI의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기