이번 주 요약
- v2.1.216 — 세션·권한·워크트리 문제를 폭넓게 수정하고 UX를 개선
- v2.1.217 — 이모지 자동완성·안정성 개선, 서브에이전트 제어 강화
- v2.1.218 — 백그라운드 리뷰·자동 모드·MCP 안정성 대폭 개선
- v2.1.219 — Claude Opus 5 기본화와 워크플로 크기 기본값 추가
- v2.1.220 — 버그 수정과 안정성을 개선했습니다.
v2.1.216 — v2.1.216
공개일: 2026-07-21 · 원문 보기
변경 사항
- 네트워크 외부로의 egress 제어는 유지하면서 파일시스템 격리를 건너뛰는
sandbox.filesystem.disabled설정을 추가했습니다. - 긴 세션에서 메시지 정규화 비용이 턴 수에 따라 이차적으로 증가해, 수초간 멈춤과 느린 재개를 유발하던 문제를 수정했습니다.
- 세션 중 OAuth 토큰이 만료되거나 교체된 뒤 자동 모드가 “HTTP 401” 분류기 오류로 명령을 거부하던 문제를 수정했습니다.
- 답변이 먼저 기다리거나 설명하라고 요청했는데도 AskUserQuestion이 Claude에게 계속 진행하라고 하던 문제를 수정했습니다. 이제 자유 서술 답변에는 중립적인 문구를 사용합니다.
- 웹의 Claude Code가 몇 분간 유휴 상태가 된 뒤 같은 질문을 다시 묻고 답변을 버리던 문제를 수정했습니다.
- 파일 수정 훅 뒤에 @-멘션이 조용히 아무것도 첨부하지 않던 문제, vim의
c연산자와 붙여넣기에서의 dot-repeat, 재개 시 상태줄이 두 번 실행되던 문제, 그리고 실패 시 resume-picker가 멈추던 문제를 수정했습니다. - 재개된 백그라운드 에이전트 세션이 기본 에이전트로 되돌아가던 문제를 수정했습니다. 이제 에이전트의 프롬프트와 도구 제한이 복원됩니다.
- worktree로 격리된 하위 에이전트가
git -C,--git-dir, 또는GIT_DIR/GIT_WORK_TREE를 통해 git을 공유 체크아웃으로 우회시키던 문제를 수정했습니다. - 작업 디렉터리가 선택한 프로젝트와 일치하지 않을 때, 다른 프로젝트의 남아 있던 worktree에 세션이 들어가던 문제를 수정했습니다.
- worktree에 git 저장소가 없는 백그라운드 세션을 삭제할 수 없던 문제를 수정했습니다.
- 오래된 레거시 데몬 잠금 파일 때문에
claude daemon stop --any가 관련 없는 프로세스를 종료할 수 있던 문제를 수정했습니다. - 유휴 프롬프트에서
Esc-Esc가 백그라운드 작업이 있는 장기 실행 세션에서 rewind 선택기를 열지 않던 문제를 수정했습니다. &&목록이나 부정문 안의 리디렉션이 있는 복합문에 대한 Bash 명령 권한 검사를 수정했습니다.- 에이전트 목록에서
Ctrl+X를 두 번 눌러도 세션이 삭제되지 않던 문제와, 백그라운드 워커가 죽었을 때 삭제된 세션이 다시 나타나던 문제를 수정했습니다. - 백그라운드 하위 에이전트가 시작 중에 높은 우선순위 메시지가 도착하면 취소되던 문제를 수정했습니다.
/memory,/plan,/keybindings, 또는Ctrl+G로 연 GUI 편집기가 열려 있는 동안 터미널의 마우스/포커스 잡음 문제를 수정했습니다./memory는 더 이상 편집기가 닫히길 기다리지 않습니다.- OAuth 토큰에 필요한 범위(scope)가 없을 때 Claude-in-Chrome이 재연결 시 403 루프에 빠지던 문제를 수정했습니다.
.claude의 심볼릭 링크를 따라가 워크플로 저장 및 예약 작업 쓰기가 프로젝트 밖으로 리디렉션되던 문제를 수정했습니다.- MCP 재인증 시 새 로그인에 성공하기 전에 작동 중인 자격 증명을 취소하던 문제와, 백그라운드 세션의 재연결 needs-auth 메시지가 사용할 수 없는 명령을 가리키던 문제를 수정했습니다.
- Windows에서 읽기 전용 명령이 권한 프롬프트 없이 네트워크 경로에 접근하던 문제를 수정했습니다.
- Bash 명령의 비ASCII 문자 파싱을 실제 셸의 단어 경계와 일치하도록 수정했습니다.
- 보이지 않는 유니코드 문자가 포함된 명령에 대한 PowerShell 도구 권한 검증을 수정했습니다.
- 전체 화면 모드에서 대화상자가 패널의 오른쪽 가장자리를 넘어 늘어나던 문제를 수정했습니다.
- 전체 화면 모드의
/config설정 목록이 키보드 힌트 푸터를 잘라내던 문제를 수정했습니다. - 104열보다 좁은 터미널에서 기록 모드(
Ctrl+O) 푸터 힌트가 줄바꿈되던 문제를 수정했습니다. - Prometheus 메트릭 엔드포인트(
OTEL_METRICS_EXPORTER=prometheus)가 잘못된# UNIT줄을 내보내던 문제를 수정했습니다. - 세션 중 변경된 스킬과 명령이 재시작 전까지 슬래시 메뉴에 나타나지 않던 문제를 수정했습니다.
name프론트매터 필드가 있는 플러그인 스킬이 슬래시 명령 자동완성에서 플러그인 접두사를 잃던 문제를 수정했습니다.- 텔레메트리가 권한 거부를 잘못 보고하던 문제를 수정했습니다. 실패한 권한 프롬프트 요청은 더 이상 사용자 거부로 집계되지 않으며, 사용자 인터럽트는 이제 거부가 아니라 사용자 중단으로 보고됩니다.
/fork확인을 한 줄로 개선해 새 세션 이름,claude attachID, 그리고 복사본이 체크아웃을 공유할 때의 안내를 표시합니다.- PowerShell 도구에서
git및gh명령 인자 검증을 개선했습니다. /ultrareview의 diff-too-large 오류를 개선해 설정된 한도, 측정된 diff 크기, 가장 많이 기여한 파일들을 표시합니다./code-review ultra의 빈 diff 메시지를 개선해 정확한 base ref를 표시하고 명시적 base 전달을 제안합니다.- 지출 한도 조정 프롬프트를 개선해 한도 변경이 거부될 때 서버의 사유를 표시합니다.
- 대화가 컨텍스트 윈도를 초과하면
/context가 명시적 경고를 표시하고, 실패한/compact는 오류로 표시합니다. /rewind가 더 이상 추적된 경로의 심볼릭 링크나 하드 링크를 통해 파일을 복원하거나 삭제하지 않으며, 건너뛴 경로 수를 보고합니다.- 백그라운드 세션에서 클라이언트가 연결되어 있지 않으면
/mcp와/install-github-app가 이제 에이전트 보기에서 “needs input” 요청을 대기시킵니다. - 번들된 dataviz 스킬을 업데이트했습니다. 기본 차트 팔레트의 순서를 재정렬하고, 4개 시리즈 차트에 직접 레이블을 권장하던 안내를 수정했습니다.
- [VSCode] 영어 또는 코드와 섞였을 때 오른쪽에서 왼쪽으로 쓰는 텍스트(아랍어, 히브리어, 페르시아어)가 잘못된 순서로 렌더링되던 문제를 수정했습니다.
- 세션의 컨테이너가 턴 도중 재시작되면 진행 중이던 메시지를 잃어버리던 클라우드 세션 문제를 수정했습니다. 이제 중단된 턴은 재개 시 다시 실행되며, 세션이 응답하지 않는 상태로 남지 않습니다.
v2.1.217 — v2.1.217
공개일: 2026-07-22 · 원문 보기
변경 사항
- 프롬프트 입력에 이모지 단축코드 자동완성을 추가했습니다:
:heart:를 입력하면 ❤️를 삽입하고,:hea를 입력하면 제안이 표시됩니다 —emojiCompletionEnabled설정으로 비활성화할 수 있습니다 - 트랜스크립트 쓰기가 실패할 때(예: 디스크 가득 참) 또는 상속된 환경 변수 때문에 세션 저장이 꺼졌을 때, 트랜스크립트를 조용히 잃어버리는 대신 경고를 추가했습니다
- 잘린 MCP 도구 출력이 세션 내내 전체의 잘리지 않은 결과를 메모리에 유지하던 메모리 누수를 수정했습니다
claude.exe가 누락될 수 있던 Windows 자동 업데이트 실패를 수정했습니다; 이제 실패한 업데이트는 보존된 실행 파일을 자동으로 복원합니다- 심볼릭 링크가 걸린 작업 디렉터리를 정규화하지 않던 백그라운드 세션 격리 문제를 수정했습니다. 이로 인해 세션이 작업 공간 폴더를 벗어날 수 있었습니다
- Claude Opus 4.8 on Bedrock에서 자동 압축이 전혀 트리거되지 않던 문제와, 한도를 초과했을 때
/compact가 실패하던 문제를 수정했습니다 - Claude Desktop 세션에서 기업용 mTLS, TLS-verify, OAuth 범위, 프록시 설정이 무시되던 문제를 수정했습니다
- 스크린 리더 모드의 시작 안내가 첫 프롬프트 렌더링에 의해 잘리던 문제와, 경과 시간 및 토큰 수를 갱신하기 위해 생각 상태 행이 몇 초마다 다시 렌더링되던 문제를 수정했습니다
OTEL_EXPORTER_OTLP_ENDPOINT를 설정하는 관리형 설정이 모든 신호를 제어하지 않던 문제를 수정했습니다 — 더 낮은 범위의 신호별 재정의가 더 이상 텔레메트리를 관리형 엔드포인트에서 벗어나게 하지 않습니다- 트랜스크립트에 잘못된 첨부 항목이 있을 때
--resume/--continue및/resume이 TypeError로 실패하던 문제를 수정했습니다 - 원격 제어(Remote Control) 세션에서 대기 중인 권한 프롬프트나 대화 상자가 나타난 뒤에 연결한 시청자에게 보이지 않던 문제를 수정했습니다
- 세션을 백그라운드로 보냈을 때(
/background또는←) 또는 세션이 과부하된 머신에서 종료될 때 백그라운드 셸을 때때로 중지할 수 없게 되던 문제를 수정했습니다. 특히 Windows에서 두드러졌습니다 - 많은 중괄호 그룹이 있는
CLAUDE.md또는SKILL.md경로 frontmatter 값이 CLI 시작 시 OOM 종료 또는 멈춤을 유발하던 문제를 수정했습니다 — 이제 중괄호 확장은 예산 제한이 적용됩니다 - 시작 중인 백그라운드 세션에 연결할 때 트랜스크립트 미리보기가 입력 영역에 딱 붙어 있던 문제를 수정했습니다; 이제 실시간 레이아웃과 같은 한 줄 간격을 남기므로, 세션이 전환될 때 트랜스크립트가 더 이상 밀리지 않습니다
- 터미널 지원을 감지할 수 없을 때도(예: ssh/tmux 경유) 푸터 PR 배지 링크가 클릭 가능한 하이퍼링크가 되도록 개선했습니다; 제외하려면
FORCE_HYPERLINK=0을 설정하세요 - 로그인 만료 경고가 만료 5일 전이 아니라 3일 전에 나타나도록 변경했습니다
- frontend-design 플러그인 제안 팁을 평생 3회 노출로 제한하여, 무한히 반복되지 않도록 했습니다
- 한 번의 메시지가 무제한으로 백그라운드 에이전트를 퍼뜨리지 않도록, 동시에 실행되는 서브에이전트 수에 상한을 추가했습니다(기본값 20,
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS로 재정의 가능) - 서브에이전트가 기본적으로 중첩 서브에이전트를 더 이상 생성하지 않도록 변경했습니다; 더 깊은 중첩을 허용하려면
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH를 설정하세요 --max-budget-usd가 백그라운드 서브에이전트를 중단하지 않던 문제를 수정했습니다: 한도에 도달하면 새 생성은 거부되고 실행 중인 백그라운드 에이전트는 중단됩니다
v2.1.218 — v2.1.218
공개일: 2026-07-23 · 원문 보기
변경 사항
/code-review가 백그라운드 하위 에이전트로 실행되도록 변경되어, 이제 리뷰 작업이 대화를 채우지 않으며 누적된 슬래시 명령을 리뷰 대상으로 유지합니다--ax-screen-reader모드에서 단어 및 줄 삭제(Option+Delete,Ctrl+W,Cmd+Backspace,Ctrl+U,Ctrl+K)에 대해 삭제된 텍스트를 스크린 리더에 알리도록 추가했습니다- 도구 입력에서
\u로 시작하는 세그먼트가 있는 Windows 경로(예:C:\Users\unicorn)가 CJK 문자로 손상되어 해당 파일에 접근할 수 없던 문제를 수정했습니다 - 왼쪽 화살표 키가 대화를 되돌릴 수 없이 버리던 문제를 수정했습니다. 이제 편집 직후의 누름은 확인을 요구하며, 에이전트 보기에서 Esc를 누르면 백그라운드로 보낸 대화로 돌아갑니다
- 서버 연결에 실패할 때
claude mcp list와/mcp에 HTTP 상태와 오류 텍스트를 추가했고, 앞이나 뒤에 숨은 공백이 있는 MCP 설정 값에는 경고를 추가했습니다 - 붙여넣은 줄바꿈을 Ctrl+J로 인코딩하는 터미널에서, 여러 줄 붙여넣기가 줄바꿈 대신
j가 들어간 한 줄로 접히던 문제를 수정했습니다 - 메시지 선택기에서 compact 후
/context가 오래된 사전-compact 토큰 사용량을 보고하던 문제를 수정했습니다 /ultrareview가 “review my auth changes” 같은 설명형 인수에서 실패하던 문제를 수정했습니다. 이제 해당 텍스트를 발견 사항에 대한 메모로 적용한 채 현재 브랜치에 대한 리뷰를 실행합니다/code-review ultra가 비대화형 세션에서 조용히 로컬 리뷰를 실행하던 문제를 수정했습니다. 이제 클라우드 리뷰를 시작합니다- 게이트웨이 사용량 계량이 Bedrock application-inference-profile ARN 및 기타 설정으로 매핑된 상위 모델 ID를 구성된 모델의 요금으로 책정하도록 수정했습니다
- 긴 IDE 선택이 이모지 중간에서 잘렸을 때 발생하던 mojibake와, 도구 실행기 오류가 조용히 누락될 수 있던 문제를 수정했습니다
- 엔진 종료 경쟁 상태로 인해 유령 turn이 시작되었다가 버려질 수 있던 문제를 수정했고, 종료 후에 주입된 입력이 일관되게 거부되도록 했습니다
- 중단된 도구 호출 뒤에 잘못 표시되던 “[Request interrupted by user]” 메시지와, 도구가 응답 도중 중단될 때 대화 기록에 짝이 맞지 않는
tool_use블록이 남던 문제를 수정했습니다 --ax-screen-reader모드에서 VoiceOver가 입력 끝의 공백을 따라 읽지 않고 “new line”이라고 읽던 문제를 수정했습니다- 플러그인 및 설정 패널이 포커스된 행으로 터미널 커서를 옮기지 않던 문제를 수정하여, 스크린 리더와 확대경이 화살표 키 탐색을 따라갈 수 있게 했습니다
- 깊게 중첩된 감시 디렉터리 트리가 삭제되거나 이동될 때, 그리고 깊게 중첩된 UI 트리를 렌더링할 때 발생하던 크래시(최대 호출 스택 초과)를 수정했습니다
- 세션이 PR을 생성하거나 연결한 직후 종료될 때 pull request 이벤트가 가끔 유실되던 문제를 수정했습니다
- 분할된 AWS 리전과 프록시 전용 네트워크에서 assume-role 프로필의 프로필 검증에 실패하던 Bedrock 설정 마법사를 수정했습니다
- 시스템 시계 조정 후 turn 지속 시간이 드물게 음수 또는 잘못 계산되던 문제를, 단조 시계로 turn 시간을 측정하도록 하여 수정했습니다
- “N MCP servers need authentication” 시작 알림이 claude.ai에서 연결되지 않은 claude.ai 커넥터를 과다 집계하던 문제를 수정했습니다
- 히스토리 쓰기가 경쟁하거나 실패할 때 프롬프트 히스토리 항목이 누락되거나 중복되던 문제를 수정했습니다
- 큰 thinking budget과 함께 context overflow 오류가 발생한 뒤 동일한 실패 요청을 다시 보내는 재시도 루프를 수정했습니다.
Ctrl+B백그라운딩은 이제 다른 경로와 동일한 백그라운드 셸 제한을 적용합니다 - 신뢰되지 않은 폴더에서 실행되던 에이전트 frontmatter 훅을 수정했습니다. 이제 훅은 에이전트 파일 자체의 폴더가 작업공간 신뢰를 수락한 경우에만 허용됩니다
- 헤드리스 및 SDK 세션에서 compact 후 fork-session 계보가 사라지던 문제를 수정했습니다
- 기록에 잘못된 delta 첨부가 있을 때 resumed session이 매 turn 실패하거나, 재개 시 크래시하던 문제를 수정했습니다
- Claude가 잘못된 인수를 그대로 재시도하는 대신 수정할 수 있도록
/ultrareview의 오류 피드백을 개선했습니다 - 자동 모드를 개선했습니다: dangerous-rm, background-
&, 의심스러운 Windows 경로 검사에서 더 이상 권한 대화상자를 열지 않으며, 대신 자동 모드 분류기가 이를 판정합니다 - IDE 상호작용에 대한 샌드박스 명령 제한을 개선했습니다
- 권한 부여가 적용되는 저장소 루트 이름을 신뢰 대화상자에 표시하도록 개선했습니다
/deep-research가 수동으로 호출될 때만 시작되도록 변경했습니다. 이제 Claude가 스스로 실행하지 않습니다- 자동이 켜진 계획 모드에서 정적 분석기가 읽기 전용임을 증명할 수 없는 Bash 명령에 더 이상 프롬프트를 띄우지 않도록 변경했습니다. 대신 자동 모드 분류기가 이를 판정합니다
/config model=또는 Remote Control을 통해 모델을 전환한 결과 fast mode가 변경될 때 알림을 추가했습니다- 서버 관리 설정에서 무해한 기능 및 비용 토글이 더 이상 설정 승인 프롬프트를 유발하지 않도록 변경했습니다
- 에이전트 markdown 파일이
:를 포함한 에이전트 이름을 거부하도록 변경했습니다.:는 플러그인 네임스페이스용으로 예약되어 있습니다 context: fork가 있는 스킬은 기본적으로 백그라운드에서 실행되도록 변경했습니다. 스킬별로background: false로 제외할 수 있습니다- 스킬 및 플러그인 frontmatter 불리언에
true/false와 함께yes/no/on/off/1/0(대소문자 무시)을 허용 값으로 추가했습니다 - 워커가 교체된 뒤에도 원격 세션이 하트비트를 계속 보내, 장시간 실행되는 데스크톱 및 IDE 프로세스가 거부된 요청을 몇 초마다 무한히 재시도하던 문제를 수정했습니다
v2.1.219 — v2.1.219
공개일: 2026-07-25 · 원문 보기
변경 사항
- Claude Opus 5 (
claude-opus-5)를 추가했습니다. 이제 기본 Opus 모델입니다 — 1M 컨텍스트, Mtok당 $10/$50의 fast mode - 샌드박스된 명령이 프롬프트 없이 허용 목록에 없는 호스트를 거부하도록
sandbox.network.strictAllowlist설정을 추가했습니다 /add-dir또는 SDKregister_repo_root제어 요청이 세션 중간에 새 작업 디렉터리를 등록한 뒤에 실행되는DirectoryAdded훅을 추가했습니다- 구성 검증에서 건너뛰어진
--mcp-config항목을 나열하는mcp_server_errors를 headless stream-json init 이벤트에 추가했습니다. 터미널 실행에서는 시작 경고를 출력합니다 - 권고용 Dynamic workflow size guideline을 어떤 설정 파일에서든 설정할 수 있도록
workflowSizeGuideline설정 키를 추가했습니다. 하나라도 사용 중이면/config행은 숨겨집니다 - stream-json에 중첩 서브에이전트 전달을 추가했습니다. 이제 깊이 2+에서 생성된 서브에이전트는
--forward-subagent-text가 설정된 경우, 생성한 Agent의tool_useid를 키로 하여 표시됩니다 - 중간 스트림 API 오류로 턴이 종료될 때 이미 생성된 답변이 사라지던
claude -p텍스트 출력 문제를 수정했습니다 - 서버 연결 실패 시
claude mcp list와/mcp에 HTTP 상태와 오류 텍스트를 추가했고, 앞이나 뒤에 숨은 공백이 있는 MCP 구성 값에 대한 경고를 추가했습니다 - 자체 호스팅 러너가 재시작되는 동안 승인한 권한이 세션 재개 시 누락되던 문제를 수정했습니다. 이제 승인된 작업이 실행됩니다
- 오래된 캐시로 인해 레이블이 저장되어 있을 때, 해당 모델이 포함된 플랜에서도 Fable 모델 행에 “Requires usage credits”가 표시되던 문제를 수정했습니다
- 자체 호스팅 러너 시작 중에 SIGTERM이 도착하면 임대가 만료될 때까지 오래된 활성 행이 남아 있던 문제를 수정했습니다. 이제 깔끔하게 등록 해제됩니다
- 자체 호스팅 러너 시작 및 세션 실패에 구조화된 실패 범주를 추가했습니다. 그래서 훅 오류, 러너 충돌, 구성 오류를 구분할 수 있습니다
/model선택기에서 병합된 Opus 행이 “Opus (1M context)”가 아니라 단순히 “Opus”로 표시되던 문제를 수정했습니다- GNU screen 내부에서 선택하여 복사할 때 터미널에 base64가 출력되던 문제를 수정했습니다
- 모델 전환, 재연결, 또는 실패한 조직 확인 이후 Remote Control 클라이언트가 오래된 fast-mode 상태를 유지하던 문제를 수정했습니다
- Windows에서
CLAUDE_CODE_GIT_BASH_PATH가 bash/sh 바이너리가 아닌 경로일 때 종료되거나 bash로 사용되던 문제를 수정했습니다. 이제 경고와 함께 무시됩니다 - Vim 모드: 빈 프롬프트에서 ← 키를 누르면 이제 INSERT뿐 아니라 NORMAL 모드에서도 에이전트 보기로 돌아갑니다
- 스크린 리더 모드가 키를 누를 때마다 전체 입력 줄을 다시 쓰던 대신, 입력한 문자만 에코하도록 수정했습니다
- “Remote Control is only available via api.anthropic.com” 오류가 이 오류를 유발한 특정 설정의 이름을 표시하도록 개선했습니다
claude --teleport가 현재 체크아웃이 세션의 저장소와 일치하지 않을 때, 현재 체크아웃이 어느 저장소를 가리키는지 표시하도록 개선했습니다- 동적 워크플로의 기본값을 중간 크기 guideline으로 변경했습니다(에이전트 수를 15개 미만으로 유지하도록 권장). 다른 크기나 제한 없음은
/config의 Dynamic workflow size에서 선택하세요 - 관리형 MCP allowlist/denylist의
${VAR}항목이 설정 파일 env가 아니라 시작 환경과 managed-settings env에서 해석되도록 변경했습니다 /model선택기가 가장 최신 모델의 이름만 강조 표시하도록 변경했습니다. 이제 강조는 목록의 임의 부분이 아니라 새 릴리스를 표시합니다- 실행 중인 워크플로 상태 표시줄에 현재 기본 workflow size를 추가했고, 변경하려면
/config를 가리키도록 했습니다 - Opus 4.7을 fast mode에서 제거했습니다. 이제
/fast는 Opus 5와 Opus 4.8에 적용됩니다 - claude-api 스킬을 Claude Opus 5를 기본값으로 사용하도록 업데이트했으며, Opus 4.8에서의 마이그레이션 경로를 추가했습니다
- 이제 서브에이전트는 기본적으로 깊이 3까지 중첩 서브에이전트를 생성할 수 있습니다(기존 1). 중첩을 비활성화하려면
CLAUDE_CODE_MAX_SUBAGENT_SPAWN_DEPTH=1로 설정하세요
v2.1.220 — v2.1.220
공개일: 2026-07-25 · 원문 보기
변경 사항
- 버그 수정 및 안정성 개선
이 글은 Claude Code 공식 릴리스 노트를 자동 번역·요약한 결과입니다. 원문은 GitHub releases에서 확인할 수 있습니다.
