v2.1.72

원문: Claude Code v2.1.72 Release Notes

변경된 사항

• 환경 변수가 설정된 경우, 도구 검색 시 타사 프록시 게이트를 우회하도록 변경했습니다(이전에는 CLAUDE_CODE_PROXY_SUPPORTS_TOOL_REFERENCE를 사용했으나, 이 변수는 이제 제거되었습니다).
• /copy 명령어에 w 키를 추가하여, 클립보드를 거치지 않고 선택된 내용을 직접 파일에 기록할 수 있게 했습니다(SSH 환경에서 유용함).
• /plan 명령어에 선택적 설명 인수를 추가했습니다(예: /plan fix the auth bug). 이 명령어를 실행하면 계획 모드로 진입하고 즉시 작업을 시작합니다.
• claude plugin의 별칭으로 claude plugins을 추가했습니다
• EnterWorktree 세션을 종료하기 위한 ExitWorktree 도구를 추가했습니다
• 세션 도중 예약된 크론 작업을 즉시 중지하기 위해 CLAUDE_CODE_DISABLE_CRON 환경 변수를 추가했습니다.
• lsof, pgrep, tput, ss, fd, fdfind를 bash 자동 승인 허용 목록에 추가하여, 일반적인 읽기 전용 작업 시 권한 확인 메시지가 표시되는 횟수를 줄였습니다.
• .git 접미사가 없는 마켓플레이스 Git URL 지원이 추가되었습니다(Azure DevOps, AWS CodeCommit).
• 호출별 모델 재정의 기능을 위해 에이전트 도구의 model 매개변수를 복원했습니다
• 노력 수준을 ‘낮음/중간/높음’으로 단순화하고(‘최대’ 옵션 제거), 새로운 기호(○ ◐ ●)를 적용했으며, 지속 표시되는 아이콘 대신 간단한 알림을 표시합니다. /effort auto 명령어를 사용하면 기본값으로 재설정할 수 있습니다.
• /config 기능 개선 — 이제 Esc 키를 누르면 변경 사항을 취소하고, Enter 키를 누르면 저장 후 창을 닫으며, 스페이스 바를 누르면 설정을 전환합니다.
• 여러 세션을 동시에 실행할 때, 위쪽 화살표(↑)를 눌렀을 때 현재 세션의 메시지가 먼저 표시되도록 기록 기능을 개선했습니다.
• 리포지토리 이름 및 일반적인 개발 용어(정규식, OAuth, JSON)에 대한 음성 입력 변환 정확도 향상
• Git에서 표준 오류 출력(stderr)이 발생하지 않는 경우에도 진단 정보를 표시하도록 마켓플레이스 복제 오류 메시지를 개선했습니다.
• claude plugin validate 명령어를 개선하여, ../ 경로를 거부할 때 marketplace.json의 소스 경로가 리포지토리 루트 경로를 기준으로 한다는 점을 설명하도록 했습니다.
• 네이티브 모듈로 전환하여 bash 명령어 구문 분석 기능을 개선했습니다. 초기화 속도가 빨라졌으며 메모리 누수가 발생하지 않습니다.
• bash 권한 확인 메시지의 오탐지 감소 — tree-sitter 파서가 이제 find -exec, 변수 할당, 명령어 대체 및 이전에 불필요한 확인 메시지를 유발했던 여러 다른 패턴을 처리합니다. 또한 npm을 통해 설치된 버전에서 tree-sitter가 로드되지 않던 문제도 수정되었습니다.
• 번들 크기를 약 510KB 줄였습니다
• CLAUDE.md 파일의 HTML 주석(<!-- ... -->)이 자동 삽입될 때 Claude에서 보이지 않도록 변경했습니다. ‘읽기’ 도구를 사용하여 읽을 때는 주석이 계속 표시됩니다.
• 백그라운드 작업이나 훅의 응답이 느릴 때 종료 속도가 느려지는 문제를 수정했습니다
• 에이전트 작업 진행 상황이 “초기화 중…” 상태에서 멈춰 있던 문제를 수정했습니다.
• 모델이 훅이 활성화된 스킬을 호출할 때, 이벤트당 스킬 훅이 두 번 발동되던 문제를 수정했습니다.
• 음성 모드와 관련된 몇 가지 문제를 수정했습니다: 간헐적으로 발생하는 입력 지연, 푸시-투-톡(PTT) 버튼을 뗀 후 잘못 표시되던 “음성 감지되지 않음” 오류, 그리고 전송 후에도 오래된 대본이 프롬프트에 다시 채워지는 현상 등이 해결되었습니다.
• --compact 실행 후 --continue를 사용해도 가장 최근 지점부터 재개되지 않던 문제를 수정했습니다.
• bash 보안 파싱의 극단적인 경우를 수정했습니다
• 여러 플러그인 문제를 수정했습니다: OneDrive 폴더에서 EEXIST 오류로 인해 Windows에서 설치가 실패하는 문제, 프로젝트 범위 설치가 존재할 때 마켓플레이스가 사용자 범위 설치를 차단하는 문제, CLAUDE_CODE_PLUGIN_CACHE_DIR이 리터럴 ~ 디렉터리를 생성하는 문제, 그리고 마켓플레이스 전용 필드가 포함된 plugin.json 파일이 로드되지 않는 문제
• 장시간 세션 중 피드백 설문조사가 너무 자주 표시되던 문제를 수정했습니다
• 시작 시 관련 없는 설정 기록으로 인해 --effort CLI 플래그가 초기화되던 문제를 수정했습니다.
• 백그라운드에서 실행 중인 Ctrl+B 쿼리가 /clear 명령어 실행 후 대화 내역을 잃어버리거나 새 대화 내용이 손상되는 문제를 수정했습니다.
• /clear 명령어가 백그라운드 에이전트/bash 작업을 종료하는 문제를 수정했습니다. 이제 포그라운드 작업만 정리됩니다.
• 워크트리 격리 관련 문제 수정: 작업 도구 재개 시 현재 작업 디렉터리가 복원되지 않는 문제, 그리고 백그라운드 작업 알림에서 worktreePath 및 worktreeBranch가 누락되던 문제
• Claude가 작업 중인 상태에서 /model을 실행했을 때 결과가 표시되지 않던 문제를 수정했습니다
• 계획 모드 권한 요청 창에서 숫자 키를 누르면 텍스트를 입력하는 대신 메뉴 옵션이 선택되던 문제를 수정했습니다.
• 샌드박스 권한 관련 문제를 수정했습니다: 특정 파일 쓰기 작업이 확인 메시지 없이 잘못 허용되던 문제와, 허용 목록에 포함된 디렉터리(예: /tmp/claude/)로의 출력 리디렉션 시 불필요하게 확인 메시지가 표시되던 문제를 해결했습니다.
• 장시간 세션에서 CPU 사용률 개선
• SDK의 query() 호출 시 프롬프트 캐시 무효화 문제를 수정하여 입력 토큰 비용을 최대 12배까지 절감했습니다.
• 쿼리를 취소한 후 Esc 키가 반응하지 않는 문제를 수정했습니다
• 백그라운드 에이전트나 작업이 실행 중일 때 Ctrl+C를 두 번 눌러도 종료되지 않던 문제를 수정했습니다
• 팀 요원들이 리더의 모델을 상속하도록 수정했습니다
• 더 이상 일치하지 않는 “항상 허용” 저장 권한 규칙 문제를 수정했습니다
• 여러 후크 관련 문제를 수정했습니다: 재개되거나 포크된 세션에서 transcript_path가 잘못된 디렉터리를 가리키는 문제, 설정을 저장할 때마다 agent prompt가 settings.json에서 아무런 경고 없이 삭제되는 문제, PostToolUse 블록의 사유가 두 번 표시되는 문제, bash read -r을 사용할 때 비동기 후크가 stdin을 수신하지 못하는 문제, 그리고 유효성 검사 오류 메시지에 유효성 검사에 실패하는 예시가 표시되는 문제
• U+2028/U+2029 문자가 포함된 파일을 읽을 때 발생하는 Desktop/SDK 세션 충돌 문제를 수정했습니다.
• CLAUDE_CODE_DISABLE_TERMINAL_TITLE이 설정된 경우에도 종료 시 터미널 제목이 지워지던 문제를 수정했습니다
• 여러 권한 규칙 일치 문제를 수정했습니다: 와일드카드 규칙이 heredoc, 내장된 줄바꿈, 또는 인수가 없는 명령어와 일치하지 않는 문제; 환경 변수 접두사가 포함된 경우 sandbox.excludedCommands가 오류가 발생하는 문제; 중첩된 CLI 도구에 대해 지나치게 광범위한 접두사를 제안하는 “항상 허용” 설정; 그리고 거부 규칙이 모든 명령어 형식에 적용되지 않는 문제
• Bash 데이터 URL 출력 시 이미지가 지나치게 크거나 잘리는 문제를 수정했습니다.
• Bedrock API 오류가 포함된 세션을 재개할 때 발생하는 충돌 문제를 수정했습니다.
• 편집, Bash 및 Grep 도구 입력란에서 간헐적으로 발생하던 “부울 값을 기대했으나 문자열이 입력되었습니다”라는 유효성 검사 오류를 수정했습니다
• 첫 번째 메시지에 줄바꿈이 포함된 대화에서 새 대화로 분기할 때 여러 줄로 표시되던 세션 제목 문제를 수정했습니다
• 대기 중인 메시지에 첨부된 이미지가 표시되지 않던 문제와, ↑ 키를 눌러 대기 중인 메시지를 편집할 때 이미지가 사라지던 문제를 수정했습니다.
• Read/WebFetch/Glob 호출이 실패할 경우 해당 호출과 병렬로 실행 중인 다른 호출까지 취소되던 문제를 수정했습니다. 이제 Bash 오류만 연쇄적으로 전달됩니다.
• VSCode: 통합 터미널의 스크롤 속도가 기본 터미널과 일치하지 않던 문제를 수정했습니다
• VSCode: 이전 키 바인딩을 사용하는 사용자의 경우, Shift+Enter를 누르면 새 줄이 삽입되지 않고 입력 내용이 전송되던 문제를 수정했습니다.
• VSCode: 입력 영역 테두리에 난이도 표시기를 추가했습니다
• VSCode: vscode://anthropic.claude-code/open URI 핸들러를 추가하여, 선택 사항인 prompt 및 session 쿼리 매개변수를 사용하여 프로그래밍 방식으로 새로운 Claude Code 탭을 열 수 있게 되었습니다.