v2.1.69

원문: Claude Code v2.1.69 Release Notes

변경된 사항

Claude API 및 Anthropic SDK를 사용하여 애플리케이션을 구축할 수 있는 /claude-api 스킬을 추가했습니다.
빈 bash 프롬프트(!)에서 Ctrl+U를 입력하면 bash 모드를 종료하도록 추가했습니다. 이는 escape 및 backspace 키와 동일한 기능을 합니다.
클로드의 인터뷰 질문에서 옵션을 선택할 때 숫자 키패드 지원이 추가되었습니다(이전에는 QWERTY 키보드 상단의 숫자 행만 작동했습니다).
/remote-control 및 claude remote-control에 선택적 이름 인수를 추가했습니다(/remote-control My Project 또는 --name "My Project"). 이를 통해 claude.ai/code에 표시될 사용자 지정 세션 제목을 설정할 수 있습니다.
10개 언어(총 20개)에 대한 음성 STT 지원 추가 — 러시아어, 폴란드어, 터키어, 네덜란드어, 우크라이나어, 그리스어, 체코어, 덴마크어, 스웨덴어, 노르웨이어
로고와 로딩 아이콘에 노력 수준 표시(예: “낮은 노력”)를 추가하여, 현재 어떤 노력 설정이 적용되어 있는지 한눈에 알 수 있게 되었습니다
claude --agent를 사용할 때 터미널 제목에 에이전트 이름이 표시되도록 했습니다
httpProxyPort를 사용하여 사용자 정의 MITM 프록시를 활용할 때 gh, gcloud, terraform과 같은 Go 프로그램이 TLS 인증서를 검증할 수 있도록 sandbox.enableWeakerNetworkIsolation 설정(macOS 전용)을 추가했습니다.
Claude의 시스템 프롬프트에서 내장된 커밋 및 PR 워크플로 지침을 제거하기 위해 includeGitInstructions 설정(및 CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS 환경 변수)을 추가했습니다.
서버를 재시작하지 않고도 적용 대기 중인 플러그인 변경 사항을 활성화하는 /reload-plugins 명령어를 추가했습니다.
macOS 및 Windows에서 Claude Code Desktop을 추천하는 일회성 시작 안내 메시지를 추가했습니다(최대 3회 표시되며, 닫을 수 있음).
스킬이 SKILL.md 콘텐츠 내에서 자체 디렉터리를 참조할 수 있도록 ${CLAUDE_SKILL_DIR} 변수를 추가했습니다.
CLAUDE.md 또는 .claude/rules/*.md 파일이 컨텍스트에 로드될 때 트리거되는 InstructionsLoaded 훅 이벤트를 추가했습니다
훅 이벤트에 agent_id(서브 에이전트용) 및 agent_type(서브 에이전트 및 --agent용)을 추가했습니다
--worktree 세션에서 실행할 때, 상태 표시줄 훅 명령어에 이름, 경로, 브랜치 및 원본 저장소 디렉터리를 포함하는 worktree 필드를 추가했습니다.
설치 전에 표시되는 플러그인 신뢰 경고에 조직별 컨텍스트를 추가하기 위해 관리 설정에 pluginTrustMessage를 추가했습니다.
엔터프라이즈 플랜뿐만 아니라 팀 플랜 OAuth 사용자에 대해서도 정책 제한 사항(예: 원격 제어 제한) 조회 기능을 추가했습니다.
hostPattern 제한 사항과 함께 파일/디렉터리 마켓플레이스 소스에 대한 정규식 일치를 위해 strictKnownMarketplaces에 pathPattern을 추가했습니다.
Git 저장소 내의 하위 디렉터리를 가리키도록 git-subdir 플러그인 소스 유형을 추가했습니다
표준 검색이 실패할 경우 MCP 서버가 사용자 지정 OAuth 메타데이터 검색 URL을 지정할 수 있도록 oauth.authServerMetadataUrl 구성 옵션을 추가했습니다.
중첩된 스킬 검색 기능이 node_modules와 같이 Git 무시 목록에 포함된 디렉터리에서 스킬을 불러올 수 있었던 보안 문제를 수정했습니다.
첫 실행 시 모든 .mcp.json 서버가 아무런 알림 없이 자동으로 승인되도록 설정되던 문제를 수정했습니다. 이제 예상대로 서버별로 승인 대화 상자가 표시됩니다.
npm 설치 시 “bad option: –sdk-url” 오류와 함께 claude remote-control이 즉시 종료되는 문제를 수정했습니다 (anthropics/claude-code#28334)
--model claude-opus-4-0 및 --model claude-opus-4-1이 최신 버전이 아닌 더 이상 사용되지 않는 Opus 버전으로 연결되던 문제를 수정했습니다.
여러 OAuth MCP 서버를 사용할 때 발생하는 macOS 키체인 손상 문제를 수정했습니다. 대용량 OAuth 메타데이터 블롭이 security -i 표준 입력(stdin) 버퍼를 넘치게 하여, 오래된 자격 증명이 처리되지 않은 채 남게 되고 /login 프롬프트가 반복적으로 표시되는 현상이 발생했습니다.
토큰 갱신 중 프로필 엔드포인트에 일시적인 오류가 발생할 때 .credentials.json에서 subscriptionType이 누락되는 문제(“Claude Pro”/“Claude Max” 대신 “Claude API”로 표시됨)를 수정했습니다 (anthropics/claude-code#30185)
리눅스에서 샌드박스화된 Bash 명령어를 실행한 후 작업 디렉터리에 추적되지 않은 파일로 나타나는 유령 도트 파일(.bashrc, HEAD 등) 문제를 수정했습니다.
SSH를 통해 Ghostty에서 Shift+Enter를 누를 때 줄 바꿈이 삽입되지 않고 [27;2;13~이 출력되던 문제를 수정했습니다.
클로드가 작업 중인 상태에서 메시지를 전송할 때 임시 저장함(Ctrl+S)의 내용이 지워지던 문제를 수정했습니다
파일 편집이 많은 장시간 세션에서 Ctrl+O(대본 표시/숨기기)를 누르면 몇 초 동안 화면이 멈추는 현상을 수정했습니다.
플랜 모드 피드백 입력에서 여러 줄 텍스트 입력이 지원되지 않던 문제를 수정했습니다(이제 백슬래시+Enter 및 Shift+Enter를 누르면 줄 바꿈이 삽입됩니다).
입력 상자 상단의 빈 줄로 커서가 아래로 이동하지 않던 문제를 수정했습니다.
트랜스크립트 파일에 타임스탬프가 누락되었거나 형식이 잘못된 항목이 포함되어 있을 때 /stats 명령어가 중단되는 문제를 수정했습니다.
장시간 세션 중 스트리밍 오류 발생 후 잠시 멈추는 현상을 수정했습니다(이전에는 한 줄을 제거하기 위해 대본 전체를 다시 작성했으나, 이제는 해당 위치에서 바로 잘라냅니다).
--setting-sources user 옵션이 동적으로 탐지된 프로젝트 스킬을 차단하지 않는 문제를 수정했습니다
메인 저장소 내에 중첩된 작업 디렉터리에서 실행할 때(예: claude -w) 발생하는 CLAUDE.md 파일, 슬래시 명령어, 에이전트 및 규칙의 중복 문제를 수정했습니다.
/plugin 명령어 실행 후 플러그인의 Stop/SessionEnd/기타 훅이 작동하지 않던 문제를 수정했습니다.
두 개의 플러그인이 동일한 ${CLAUDE_PLUGIN_ROOT}/... 명령어 템플릿을 사용할 때 플러그인 훅이 아무런 경고 없이 제거되던 문제를 수정했습니다.
대화 메시지가 불필요하게 유지되던 장시간 실행되는 SDK/CCR 세션의 메모리 누수 문제를 수정했습니다.
도구 배치 처리 도중 중단된 세션을 재개할 때 포크된 에이전트(autocompact, summarization)에서 발생하던 API 400 오류를 수정했습니다.
고아 상태의 도구 결과로 시작되는 대화를 재개할 때 발생하는 “tool_result 블록에서 예기치 않은 tool_use_id가 발견됨” 오류를 수정했습니다.
에이전트 도구의 name 매개변수를 통해 팀원이 의도치 않게 중첩된 팀원을 생성하는 문제를 수정했습니다.
대화 압축 과정에서 CLAUDE_CODE_MAX_OUTPUT_TOKENS가 무시되던 문제를 수정했습니다.
SDK를 사용하는 환경(Claude Code Remote 웹 UI, VSCode 확장 프로그램)에서 /compact 요약이 사용자 팝업으로 표시되던 문제를 수정했습니다.
음성 인식 실패 후 음성 스페이스 바가 응답하지 않는 현상 수정 (모듈 로딩 경합, GrowthBook 초기화)
Windows에서 작업 트리 파일 복사 문제 수정
Windows에서 글로벌 .claude 폴더 감지 문제를 수정했습니다
acceptEdits 모드에서 심볼릭 링크된 상위 디렉터리를 통해 새 파일을 작성할 경우 작업 디렉터리를 벗어나는 심볼릭 링크 우회 문제를 수정했습니다.
관리 설정에서 allowManagedDomainsOnly가 활성화된 경우, 허용되지 않은 도메인에 대해 사용자에게 승인을 요청하던 샌드박스 문제를 수정했습니다. 이제 허용되지 않은 도메인은 우회할 수 없도록 자동으로 차단됩니다.
스킬의 allowed-tools에 나열된 대화형 도구(예: AskUserQuestion)가 권한 확인 메시지 없이 자동으로 허용되어, 빈 답변으로 실행되는 문제를 수정했습니다.
작업 디렉토리에 있는 대용량 미추적 바이너리 파일을 커밋할 때 발생하는 수 GB 규모의 메모리 급증 현상을 수정했습니다.
입력란에 초안 텍스트가 있을 때 Esc 키를 눌러도 진행 중인 턴이 중단되지 않던 문제를 수정했습니다. 위쪽 화살표 키를 눌러 대기 중인 메시지를 불러와 편집하거나, Ctrl+U를 눌러 입력란을 지울 수 있습니다.
원격 제어 세션에서 로컬 슬래시 명령어(/voice, /cost)를 실행할 때 발생하던 Android 앱 강제 종료 문제를 수정했습니다.
장시간 세션 동안 React 컴파일러의 memoCache에 이전 메시지 배열 버전이 누적되어 발생하는 메모리 누수 문제를 수정했습니다.
장시간 세션 동안 REPL 렌더링 범위가 누적되어 발생하는 메모리 누수 문제를 수정했습니다(1,000턴 기준 약 35MB).
진행 중인 팀원의 메모리 유지 문제를 수정했습니다. 이전에는 부모 팀원의 전체 대화 내역이 해당 팀원의 수명 동안 고정되어 있어, /clear 명령어나 자동 압축 후 가비지 컬렉션이 수행되지 않는 문제가 있었습니다.
대화형 모드에서 장시간 세션이 진행될 경우 훅 이벤트가 무한정 누적되는 메모리 누수 문제를 수정했습니다.
--mcp-config가 손상된 파일을 가리킬 때 발생하는 멈춤 현상 수정
많은 스킬/플러그인이 설치되어 있을 때 발생하는 시작 지연 현상 수정
cd <외부 디렉터리> && <명령어> 입력 시, 단순히 “예, <디렉터리>/에서 읽기를 허용하시겠습니까?"라는 메시지만 표시되던 권한 확인 창이 수정되어, 연결된 명령어가 명확히 표시되도록 했습니다.
.claude/rules/*.md 파일(프론트매터에 paths:가 포함된 파일) 및 중첩된 CLAUDE.md 파일이 인쇄 모드(claude -p)에서 로드되지 않던 문제를 수정했습니다.
/clear 명령어가 모든 세션 캐시를 완전히 지우지 못하던 문제를 수정하여, 장시간 세션 시 메모리 점유량을 줄였습니다.
스크롤백 경계에서 애니메이션 요소로 인해 발생하던 터미널 화면 깜빡임 현상을 수정했습니다.
OAuth를 사용하는 MCP 서버에서 macOS의 UI 프레임 드롭 현상 수정 (2.1.x 버전에서 발생한 회귀 현상)
동기식 디버그 로그 플러시로 인해 입력 중 가끔 발생하던 프레임 멈춤 현상을 수정했습니다
TeammateIdle 및 TaskCompleted 훅을 수정하여 {"continue": false, "stopReason": "..."} 구문을 지원하도록 하여 팀원을 중지할 수 있게 했으며, 이는 Stop 훅의 동작과 일치합니다.
WorktreeCreate 및 WorktreeRemove 플러그인 훅이 아무런 오류 메시지 없이 무시되던 문제를 수정했습니다
SKILL.md 프론트매터에서 콜론(:)이 포함된 스킬 설명(예: “발동 조건: X, Y, Z”)이 로드되지 않는 문제를 수정했습니다.
description: 프론트매터 필드가 없는 프로젝트 스킬이 Claude의 사용 가능한 스킬 목록에 표시되지 않던 문제를 수정했습니다.
서버의 모든 MCP 도구에 대해 /context 명령어가 동일한 토큰 수를 표시하던 문제를 수정했습니다
모델이 Git Bash에서 CMD 스타일의 2>nul 리디렉션을 사용할 때 Windows에서 nul 파일 생성 오류를 수정했습니다.
확장된 하위 에이전트 대화 기록 보기(Ctrl+O)에서 각 도구 호출 아래에 불필요한 빈 줄이 표시되던 문제를 수정했습니다.
/config 검색 상자에 포커스가 맞춰져 있지만 내용이 비어 있을 때, Tab 키나 화살표 키를 눌러도 설정 탭이 순차적으로 전환되지 않던 문제를 수정했습니다.
프로필 범위 엔드포인트에서 발생하는 403 오류로 인해 서비스 키 OAuth 세션(CCR 컨테이너)이 [ERROR] 로그를 과도하게 생성하는 문제를 수정했습니다.
“리모컨 활성화” 상태 표시기의 색상 불일치 문제를 수정했습니다.
입력 도중 음성 인식 시 음성 파형 커서가 첫 번째 접미사 문자를 가리는 현상을 수정했습니다.
음성 입력 시 준비 단계에서 최대 2개 정도로 제한되어야 하는데 5개 공간이 모두 표시되던 문제를 수정했습니다(“계속 누르고 계세요…”라는 안내 문구와 일치하도록).
50ms 애니메이션 루프를 주변 셸에서 분리하여 턴 진행 중 렌더링 및 CPU 부하를 줄임으로써 스피너 성능을 개선했습니다
React 컴파일러를 사용하여 네이티브 바이너리의 UI 렌더링 성능이 개선되었습니다
시작 경로에서 git 하위 프로세스를 제거하여 --worktree 시작 기능을 개선했습니다
관리되는 설정이 해결될 때 불필요한 설정 파일 재로드를 방지하여 macOS 시작 성능을 개선했습니다
불필요한 키체인 조회 과정을 생략하여 Claude.ai 엔터프라이즈/팀 사용자의 macOS 시작 성능을 개선했습니다
claude.ai 구성 정보 가져오기를 로컬 연결을 통해 파이프라인 처리하고, 순차적 일괄 처리 대신 동시성 풀을 사용함으로써 MCP -p 시작 성능을 개선했습니다.
재렌더링으로 인한 끊김 현상을 유발하던, 눈에 띄지 않는 워밍업 펄스 애니메이션을 제거하여 음성 시작 기능을 개선했습니다
MCP 바이너리 콘텐츠 처리 기능 개선: PDF, Office 문서 또는 오디오 파일을 반환하는 도구는 이제 원시 base64 데이터를 대화 컨텍스트에 그대로 저장하는 대신, 디코딩된 바이트 데이터를 올바른 파일 확장자와 함께 디스크에 저장합니다. 또한 WebFetch는 요약 정보와 함께 바이너리 응답도 저장합니다.
메시지 업데이트 시 onSubmit을 안정화하여 장시간 세션에서의 메모리 사용량을 개선했습니다
LSP 도구 렌더링 및 메모리 컨텍스트 구축 기능을 개선하여 더 이상 전체 파일을 읽지 않도록 했습니다
세션 업로드 및 메모리 동기화 기능을 개선하여, 크기/바이너리 검사 전에 대용량 파일을 메모리로 불러오는 것을 방지합니다
파일 존재 여부 확인 시 파일 내용을 읽지 않도록 하여 파일 처리 성능을 개선했습니다(6개 사이트)
--append-system-prompt-file 및 --system-prompt-file 옵션이 대화형 모드에서도 작동한다는 점을 명확히 하기 위해 문서를 개선했습니다(기존 문서에는 인쇄 모드에서만 작동한다고 명시되어 있었습니다).
Yoga WASM 사전 로딩을 연기하여 기본 메모리 사용량을 약 16MB 줄였습니다
stream-json 출력을 사용하여 SDK 및 CCR 세션의 메모리 사용량을 줄였습니다
대용량 세션(압축된 기록 포함)을 재개할 때 메모리 사용량이 줄어듭니다.
더 간결해진 하위 에이전트 최종 보고서를 통해 다중 에이전트 작업에서 토큰 사용량을 줄였습니다
Pro/Max/Team Premium 버전의 Sonnet 4.5 사용자를 Sonnet 4.6으로 자동 마이그레이션하도록 변경했습니다.
/resume 선택기에서 첫 번째 프롬프트 대신 가장 최근의 프롬프트가 표시되도록 변경했습니다. 이로 인해 일부 제목이 (session)으로 표시되던 문제도 해결되었습니다.
claude.ai MCP 커넥터 오류 발생 시, 도구 목록에서 아무런 알림 없이 사라지던 현상을 수정하여 이제 알림이 표시되도록 했습니다.
예제 명령어 제안이 Haiku를 호출하는 방식 대신 결정론적으로 생성되도록 변경했습니다
압축 후 재개 시, 작업을 계속하기 전에 서문 요약이 표시되지 않도록 변경했습니다.
[SDK] 작업 생성 시 activeForm 필드가 더 이상 필요하지 않도록 변경되었습니다. 로딩 아이콘은 작업 제목으로 대체됩니다.
[VSCode] 요약 내용이 포함된 접을 수 있는 “압축된 채팅” 카드를 추가했습니다.
[VSCode] 권한 모드 선택기에서 이제 유효한 Claude Code 설정(관리형/정책 설정 포함)의 permissions.disableBypassPermissionsMode 값을 반영합니다. 이 값이 disable로 설정된 경우, 권한 우회 모드가 선택기에서 숨겨집니다.
[VSCode] 채팅 패널에서 RTL 텍스트(아랍어, 히브리어, 페르시아어)가 거꾸로 표시되던 문제 수정 (v2.1.63 버전의 회귀 현상)