이번 주 요약
- v2.1.160 — 셸·빌드 설정 보안 강화와 백그라운드 안정성 개선
- v2.1.163 — 버전 제한 도입과 플러그인·백그라운드 버그를 개선
- v2.1.165 — 버그 수정과 안정성 개선이 이루어졌습니다.
- v2.1.166 — 폴백 모델 추가와 보안·안정성 버그를 수정
- v2.1.167 — 버그를 수정하고 안정성을 개선했습니다.
v2.1.160 — v2.1.160
공개일: 2026-06-02 · 원문 보기
변경 사항
- 셸 시작 파일(
.zshenv,.zlogin,.bash_login)과~/.config/git/에 쓰기 전에 프롬프트를 추가했습니다. 그렇지 않으면 의도하지 않은 명령 실행으로 이어질 수 있습니다. - 이제
acceptEdits모드는 코드 실행 권한을 부여하는 빌드 도구 설정 파일(.npmrc,.yarnrc*,bunfig.toml,.bazelrc,.pre-commit-config.yaml,.devcontainer/등)에 쓰기 전에 프롬프트를 표시합니다. - 편집은 더 이상
grep으로 파일을 본 뒤 별도의 Read를 요구하지 않습니다. 이제 단일 파일grep/egrep/fgrep명령은 읽기 후 편집 검사(read-before-edit check)를 충족합니다. - WSL에서 선택 시 복사가 Windows 클립보드에 기록되지 않던 문제를 수정했습니다. 이제 MobaXterm 같은 터미널이 지원하지 않는 OSC 52 대신 PowerShell 상호 운용성을 사용합니다.
claude agents에서 완료된 세션을 복원할 때 채팅 기록이 사라지고 원래 프롬프트가 다시 실행되던 문제를 수정했습니다.- 밤새 휴면 후 다시 연결된 백그라운드 세션에서 대화 내용이 사라지고 원래 프롬프트가 다시 실행되던 문제를 수정했습니다.
- 부하가 큰 머신에서 백그라운드 daemon이 콜드 스타트될 때
claude --bg가 가끔 “socket missing”으로 실패하던 문제를 수정했습니다. - Windows에서 백그라운드 세션을 시작한 디렉터리를
claude rm후 백그라운드 daemon이 종료될 때까지 삭제할 수 없던 문제를 수정했습니다. - 작업을 재개한 백그라운드 에이전트가 에이전트 목록의 Completed 아래에 표시되던 문제를 수정했습니다.
- 자동 업데이트가 종료할 때마다 다시 확인하면서
claude agents가 세션 목록으로 돌아갈 때 몇 초 동안 멈추던 문제를 수정했습니다. - 호스트에 CPU 부하가 큰 상태에서 백그라운드 세션에 연결했거나 에이전트 보기에서 Esc, 방향키, 입력이 Windows에서 응답하지 않던 문제를 수정했습니다.
- 백그라운드 에이전트가 터미널 동기화 출력 마커를 지원하지 않는 터미널(Apple Terminal, tmux)에 내보내어, 실행 중인 에이전트에 들어갈 때 렌더링 아티팩트가 발생하던 문제를 수정했습니다.
- 에이전트 목록에서 세션을 연 직후 마우스 휠이 대화록 대신 프롬프트 기록을 스크롤하던 문제를 수정했습니다.
claude agents보기에서 CJK IME 조합이 입력 커서가 아니라 화면 왼쪽 아래에 나타나던 문제를 수정했습니다.- 유효한
file:///C:/...링크가 하이퍼링크를 지원하는 Windows 터미널에서 깨진 경로로 다시 쓰이던 문제를 수정했습니다. - 프로젝트 디렉터리 또는 브랜치 이름에 ASCII가 아닌 문자나 특수 문자가 포함되면 음성 모드가 연결에 실패하던 문제를 수정했습니다.
- 서드파티 제공자(Bedrock/Vertex/Foundry)에서 자동 모드 사용 불가 메시지가 모델을 잘못 탓하는 대신
CLAUDE_CODE_ENABLE_AUTO_MODE옵트인으로 안내하도록 수정했습니다. - 모델이 xhigh를 실행할 수 없을 때
/effort ultracode가 동적 워크플로 설정을 잘못 탓하던 문제를 수정했습니다. 이제 ultracode는 이를 지원하지 않는 모델에서는 더 이상 제공되지 않습니다. - SDK나 다른 호스트에서 실행할 때(
--modelCLI 플래그가 적용되지 않는 경우) model-not-found 오류가--model을 제안하던 문제를 수정했습니다. - 짧은 모드가 꺼진 상태에서 짧은 모드 세션을 재개할 때 Claude의 이전 답변이 스크롤백에서 사라지던 문제를 수정했습니다.
- vim 모드에서 레지스터가
v$로 yank되었을 때p가 커서 위치가 아니라 한 줄 아래에 붙여넣던 문제를 수정했습니다. claude agents에서 최근에 비활성화된 백그라운드 에이전트 세션을 여는 성능을 개선했습니다.- 일상적인 작업에서 추론을 줄여 자동 모드 분류기 지연 시간을 개선했고, “이 작업을 평가할 수 없습니다” 차단이 발생할 가능성을 낮췄습니다.
- 백그라운드 세션 종료(
claude rm/stop, 유휴 회수)를 개선하여, 정리 핸들러가 실행되도록SIGKILL전에 실행 중인 셸 하위 프로세스에SIGTERM을 보냅니다. CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE를 제거했습니다. 이제 이 환경 변수는 아무 동작도 하지 않습니다.- 시작 시 JetBrains 플러그인 설치 제안을 제거했습니다.
- 동적 워크플로 트리거 키워드를
workflow에서ultracode로 이름 변경했습니다. “workflow”라는 단어는 더 이상 실행을 트리거하지 않습니다. 자신의 말로 워크플로를 요청하는 것은 여전히 작동합니다. 트리거 키워드는 프롬프트 입력란에서 보라색으로 강조 표시됩니다
v2.1.163 — v2.1.163
공개일: 2026-06-05 · 원문 보기
변경 사항
requiredMinimumVersion및requiredMaximumVersion관리형 설정을 추가했습니다. Claude Code는 버전이 허용 범위를 벗어나면 시작을 거부하고, 승인된 버전으로 사용자를 안내합니다.- 설치된 플러그인을 나열하는
/plugin list명령을 추가했으며,--enabled/--disabled필터를 지원합니다. /btw에 “c to copy” 단축키를 추가했습니다. 이 단축키는 원시 Markdown 답변을 클립보드에 복사하여, 다른 곳에 붙여넣을 때 서식을 보존합니다.- 훅: Stop 및 SubagentStop 훅이 이제
hookSpecificOutput.additionalContext를 반환하여, 훅 오류로 표시되지 않은 채 Claude에 피드백을 주고 턴을 계속 진행할 수 있습니다. - Skills: 명령 본문에서 숫자 앞의 리터럴
$를 포함하기 위한$이스케이프 문법을 추가했습니다. - 이제 stdio MCP 서버도
--resume시 훅/Bash와 동일한CLAUDE_CODE_SESSION_ID를 받습니다. - 백그라운드로 실행된 명령이 종료되지 않을 때
claude -p가 최종 결과 뒤에 영원히 멈추는 문제를 수정했습니다. 이제 stdin이 닫힌 뒤 결과가 나온 약 5초 후 백그라운드 셸이 중지됩니다. CI=true이고 Anthropic API 키가 설정되지 않은 경우, Bedrock/Vertex/Foundry에서claude -p가 “ANTHROPIC_API_KEY required”로 실패하던 문제를 수정했습니다.- bazel 및 EDR 보호가 적용된 Go 워크플로에서 Bash 명령이 실패하던 문제를 수정했습니다.
$TMPDIR이 샌드박스된 명령에만이 아니라 모든 명령에 대해/tmp/claude-{uid}로 재정의되도록 했습니다(2.1.154의 회귀). - 세션-env 디렉터리가 읽기 전용 속성을 가지거나 OneDrive 안에 있을 때 Windows에서 Bash 명령이 “EEXIST: file already exists”로 실패하던 문제를 수정했습니다.
- 새 구성 디렉터리에서 시작 중 관리형 설정 가져오기가 완료되었을 때, 조직 관리 권한 규칙이 세션 전체에 적용되지 않던 문제를 수정했습니다.
claude agents의 백그라운드 세션이 Claude Code 업데이트 후 다시 연결되었을 때 실행 중이던 백그라운드 작업을 잃어버리던 문제를 수정했습니다.- Esc를 눌러 에이전트 뷰를 종료할 때 터미널 정렬이 어긋나고 몇 초간 멈추던 문제를 수정했습니다.
- 데스크톱 앱에서 백그라운드 작업 칩의 Stop을 클릭했을 때, 기반 프로세스가 이미 사라진 경우 칩이 지워지지 않던 문제를 수정했습니다.
- 붙여넣기 작업 후 터미널이 끝 마커를 드롭할 때 키보드 입력이 영구적으로 응답하지 않게 되던 문제를 수정했습니다.
- 훅
if: "Bash(...)"조건이$()또는$VAR를 포함하는 모든 Bash 명령에서 발동하던 문제를 수정했습니다. 이제 패턴은 서브셸과 백틱 안의 명령에도 일치합니다. - 홈 디렉터리 경로에 대한 거부 규칙(예:
Read(~/Desktop/**))이$HOME을 통해 경로를 참조하는 Bash 명령을 차단하지 못하던 문제를 수정했습니다. /mcp및/plugins같은 패널 대화상자를 닫은 뒤 대화 기록에 남던 불필요한 “(no content)” 줄을 수정했습니다.- 백그라운드 에이전트 세션이 이제 백그라운드에서 새 Claude Code 버전으로 업데이트되므로, 업데이트 후 세션을 열 때 더 이상 콜드 재시작을 기다리지 않습니다.
/메뉴에서 내장 명령과 스킬에 대한 설명을 더 명확하게 했습니다.- 구독 전환 제안이 이제 토스트 대신 시작 알림 슬롯에 표시됩니다.
- 상태별 그룹 보기에서 디스패치되는
claude agents가 이제 세션을 에이전트 뷰를 연 디렉터리에서 시작합니다.
v2.1.165 — v2.1.165
공개일: 2026-06-05 · 원문 보기
변경 사항
- 버그 수정 및 안정성 개선
v2.1.166 — v2.1.166
공개일: 2026-06-06 · 원문 보기
변경 사항
- 주 모델이 과부하되었거나 사용할 수 없을 때 순서대로 최대 3개의 폴백 모델을 시도하도록
fallbackModel설정을 추가했습니다.--fallback-model은 이제 대화형 세션에도 적용됩니다. - 거부 규칙의 도구 이름 위치에서 glob 패턴 지원을 추가했습니다(
"*"는 모든 도구를 거부함). 허용 규칙은 MCP가 아닌 glob를 거부하며, 거부 규칙의 알 수 없는 도구 이름은 시작 시 경고를 표시합니다. - 세션 간 메시징을 강화했습니다: 다른 Claude 세션에서
SendMessage로 중계된 메시지는 더 이상 사용자 권한을 포함하지 않으며, 수신자는 중계된 권한 요청을 거부하고 자동 모드가 이를 차단합니다. MAX_THINKING_TOKENS=0,--thinking disabled, 그리고 모델별 thinking 토글은 이제 Claude API에서 기본적으로 thinking을 사용하는 모델에 대해 thinking을 비활성화합니다(3P 제공자는 변경 없음).- Claude Code는 API가 예상치 못한 재시도 불가능한 오류를 반환할 때 폴백 모델에서 한 턴을 한 번 재시도합니다. 다만 인증, 속도 제한, 요청 크기, 전송 오류는 여전히 즉시 표면화됩니다.
claude update는 이제 조용히 넘어가지 않고 다운로드 전에 대상 버전을 알립니다.claude agents: 목록에 URL을 입력하면 이제 첫 프롬프트에 그 URL이 포함된 세션으로 필터링됩니다.- 처리할 수 없는 이미지가 세션으로 전송되었을 때 발생하던 반복적인 “image could not be processed” 오류와 추가 토큰 사용을 수정했습니다.
- 시작 시 워커 등록 중 일시적인 백엔드 장애가 발생했을 때 원격 세션이 영구적으로 멈추는 문제를 수정했습니다.
- 2026.1+의 JetBrains IDE 터미널(IntelliJ, PyCharm, WebStorm 등)에서 동기화된 출력을 활성화하여 깜빡임을 수정했습니다.
- Kitty 키보드 프로토콜(WezTerm, Ghostty, kitty)을 사용하는 터미널에서 Shift+비ASCII 문자(예: Shift+ä → Ä)가 누락되던 문제를 수정했습니다.
- 종료된 프로세스의 자식이 출력 파이프를 점유하고 있을 때, Windows에서 PowerShell 명령 검증이 때때로 시간 예산을 훨씬 넘겨 멈추는 문제를 수정했습니다.
- 데몬이 macOS에서 연결된 상태로 종료된 후 고아가 된
claude --bg-pty-host프로세스가 CPU 100%를 사용하며 회전하던 문제를 수정했습니다. /voice전환 후 오래된 인증 검사를 지우기 위해/login이 필요하던 음성 모드 문제를 수정했습니다.- 잘못된 항목이 포함된 관리 설정이 나머지 유효한 정책 적용을 조용히 비활성화하던 문제를 수정했습니다.
- 관리 설정의
allowedMcpServers/deniedMcpServers술어가${VAR}참조를 사용할 때 일치하지 않던 문제를 수정했습니다. - git worktree에 들어간 배경 에이전트 세션이
claude agents에서 다시 열 때 “No conversation found”로 크래시 루프에 빠지던 문제를 수정했습니다. - 스트리밍 중 Ctrl+O 대화록 보기에서 생각 내용이 중복 표시되던 문제를 수정했습니다.
- 원격 세션 안에서 실행할 때
/doctor가 모순된 실패 메시지인 “Not inside a remote session” 검사를 표시하던 문제를 수정했습니다. claude agents의 dispatch 및 reply 입력창에서 여러 줄 프롬프트를 입력할 때 커서가 첫 줄 끝에 붙어 있던 문제를 수정했습니다.- 유니코드를 지원하지 않는 터미널에서 작업 목록의 배경 에이전트 행 사이에 빈 줄이 나타나던 문제를 수정했습니다.
v2.1.167 — v2.1.167
공개일: 2026-06-06 · 원문 보기
변경 사항
- 버그 수정 및 안정성 개선
이 글은 Claude Code 공식 릴리스 노트를 자동 번역·요약한 결과입니다. 원문은 GitHub releases에서 확인할 수 있습니다.