Claude Code 2.1.47 업데이트 정리

<클로드 코드 2.1.47 업데이트>

2026년 2월 18일, 클로드 코드 2.1.47 버전이 배포되었습니다. 이번 업데이트는 신규 기능 열 가지, 성능 개선 다섯 가지, 버그 수정 오십여 가지로 구성된 업데이트입니다. Windows 환경 안정성 강화, 세션 관리 개선, 메모리 최적화가 핵심입니다.

3줄 요약

• Windows 환경의 터미널 렌더링, 셸 실행, 파일 경로 관련 버그가 대폭 수정되었습니다.
• 세션 관리와 /resume 기능의 안정성이 크게 향상되었습니다.
• 메모리 사용량 최적화와 시작 속도 개선으로 장시간 작업 시 체감 성능이 나아졌습니다.

신규 기능

VS Code 플랜 미리보기 개선

VS Code에서 플랜 모드를 사용할 때의 미리보기 기능이 세 가지로 개선되었습니다. 첫째, Claude가 플랜을 작성하는 동안 미리보기가 실시간으로 업데이트됩니다. 둘째, 플랜이 검토 준비가 된 시점에만 코멘트 기능이 활성화됩니다. 셋째, 플랜을 거부해도 미리보기 창이 닫히지 않아 Claude가 바로 수정할 수 있습니다.

백그라운드 에이전트 제어 방식 변경

백그라운드 에이전트를 종료하는 단축키가 ESC 두 번에서 'ctrl+f'로 변경되었습니다. 백그라운드 에이전트는 Task 도구로 실행한 별도의 작업 프로세스입니다. 기존에는 ESC를 누르면 메인 스레드와 백그라운드 에이전트가 동시에 중단되었습니다. 이제 ESC는 메인 스레드만 취소하고, 백그라운드 에이전트는 계속 실행됩니다. 에이전트의 생명주기를 더 세밀하게 제어할 수 있게 된 것입니다.

팀메이트 탐색 간소화

팀메이트 간 전환 단축키가 Shift+Down 하나로 통합되었습니다. 팀메이트는 Agent Teams에서 협력하는 개별 에이전트를 말합니다. 기존에는 Shift+Up과 Shift+Down 두 가지를 사용했지만, 이제 Shift+Down만으로 순환 탐색이 가능합니다.

Hook에 최종 응답 메시지 필드 추가

Stop과 SubagentStop 훅 입력에 'last_assistant_message' 필드가 추가되었습니다. 훅은 특정 이벤트가 발생할 때 자동으로 실행되는 사용자 정의 명령어입니다. 이 필드를 통해 Claude의 최종 응답 텍스트를 훅에서 직접 접근할 수 있습니다. 기존에는 트랜스크립트 파일을 파싱해야 했던 작업이 간단해졌습니다.

멀티라인 입력 키바인딩 추가

'chat:newline' 키바인딩 액션이 추가되었습니다. 키바인딩은 특정 키 조합에 기능을 연결하는 설정입니다. 이 액션을 원하는 키에 매핑하면, 입력창에서 줄바꿈을 삽입하여 여러 줄에 걸친 메시지를 작성할 수 있습니다.

키바인딩, UI, 경로 관련 소규모 개선

• 상태 표시줄 JSON의 'workspace' 섹션에 'added_dirs' 필드가 추가되었습니다. '/add-dir'로 추가한 디렉토리 목록을 외부 스크립트에서 조회할 수 있습니다.
• '/rename' 명령어 실행 시 터미널 탭 제목도 함께 업데이트됩니다.
• /resume 세션 목록의 초기 표시 수가 10개에서 50개로 늘어났습니다. 세션을 더 빠르게 찾을 수 있습니다.
• 축소된 도구 결과에서 검색 패턴이 따옴표로 감싸져 표시되어 가독성이 개선되었습니다.
• 설정 백업 파일의 저장 경로가 홈 디렉토리에서 '~/.claude/backups/'로 변경되었습니다. 홈 디렉토리가 깔끔해집니다.

성능 개선

메모리 사용량 최적화

장시간 세션에서의 메모리 사용량이 세 가지 방면에서 개선되었습니다. 첫째, API 스트림 버퍼, 에이전트 컨텍스트, 스킬 상태가 사용 후 즉시 해제됩니다. 둘째, 에이전트 작업 완료 후 메시지 이력이 정리됩니다. 셋째, 진행 업데이트에서 메시지가 제곱으로 누적되던 비효율이 제거되었습니다. 대화가 길어질수록 업데이트 메시지가 기존 메시지 위에 중복 추가되면서 메모리가 급격히 증가하는 구조적 문제였습니다.

시작 속도 향상

SessionStart 훅의 실행 시점이 지연 처리되어 시작 속도가 약 500ms 빨라졌습니다. SessionStart 훅은 Claude Code가 시작될 때 자동으로 실행되는 사용자 정의 명령어입니다. 기존에는 이 훅이 완료될 때까지 화면이 대기 상태였지만, 이제 백그라운드에서 실행되어 사용자가 더 빨리 입력을 시작할 수 있습니다.

@ 파일 멘션 성능 개선

입력창에서 '@'로 파일을 참조할 때 제안 목록이 더 빠르게 표시됩니다. 시작 시점에 파일 인덱스를 미리 구축하고, 세션 기반 캐시와 백그라운드 갱신을 적용한 결과입니다.

버그 수정

Windows 환경 안정성 대폭 개선

Windows 사용자에게 영향을 주던 다수의 문제가 수정되었습니다.

• 터미널 렌더링 오류: Windows의 줄바꿈 문자('\r\n')가 표시 코드에서 올바르게 처리되지 않아 줄 수가 항상 1로 표시되던 문제가 수정되었습니다. 같은 원인으로 마크다운의 볼드 텍스트와 컬러 텍스트가 잘못된 위치에 표시되던 문제도 함께 해결되었습니다.
• MSYS2/Cygwin 셸 출력 누락: MSYS2나 Cygwin 셸을 사용할 때 Bash 도구의 출력이 무시되던 문제가 수정되었습니다. MSYS2와 Cygwin은 Windows에서 Linux 명령어를 실행할 수 있게 해주는 환경입니다.
• 임시 파일 누적: 현재 작업 디렉토리 추적용 임시 파일이 삭제되지 않고 무한히 쌓이던 문제가 수정되었습니다.
• CLAUDE.md 이중 로딩: 드라이브 문자의 대소문자가 다를 때 같은 CLAUDE.md 파일이 두 번 로딩되던 문제가 수정되었습니다. 예를 들어 'C:'와 'c:'를 다른 경로로 인식하던 것입니다.
• 훅 실행 실패: Windows에서 PreToolUse, PostToolUse 훅이 cmd.exe 환경에서 실행되지 않던 문제가 수정되었습니다. 이제 Git Bash를 통해 실행됩니다.
• Right Alt 키 잔여 문자: Windows의 Git Bash 터미널에서 Right Alt 키를 누르면 '[25~' 이스케이프 시퀀스가 입력창에 남던 문제가 수정되었습니다.
• WSL2 이미지 붙여넣기: WSL2 환경에서 Windows가 이미지를 BMP 형식으로 복사할 때 붙여넣기가 동작하지 않던 문제가 수정되었습니다.
• CJK 문자 정렬: 한국어, 중국어, 일본어 등 전각 문자가 포함된 경우 타임스탬프와 레이아웃 요소의 정렬이 어긋나던 문제가 수정되었습니다.
• Worktree 세션 매칭: Git worktree 사용 시 드라이브 문자의 대소문자 차이로 세션이 올바르게 매칭되지 않던 문제가 수정되었습니다.

세션 관리 및 /resume 안정성 개선

세션 관리와 /resume 기능에서 발생하던 다수의 문제가 수정되었습니다.

• '/rename'으로 지정한 세션 제목이 대화를 이어서 열 때 사라지던 문제가 수정되었습니다.
• '/clear' 명령어 실행 후에도 상태 표시줄에 세션 이름이 남아 있던 문제가 수정되었습니다.
• 첫 메시지가 16KB를 초과하는 세션이 /resume 목록에서 누락되던 문제가 수정되었습니다. 같은 원인으로 '/resume <세션ID>' 명령어로도 해당 세션을 찾지 못하던 문제가 함께 해결되었습니다.
• 컨텍스트 압축 후 세션 이름이 사라지던 문제가 수정되었습니다. 컨텍스트 압축은 대화가 길어질 때 이전 내용을 요약하여 토큰 사용량을 줄이는 기능입니다.

에이전트, 플러그인, 스킬 관련 수정

에이전트와 스킬 시스템의 안정성이 개선되었습니다.

• 플러그인 스킬을 정식 명칭 대신 약칭으로 참조할 때 로딩이 실패하던 문제가 수정되었습니다.
• NFS나 FUSE 파일 시스템에서 사용자 정의 에이전트 파일이 하나만 로딩되던 문제가 수정되었습니다. NFS와 FUSE는 네트워크 또는 가상 파일 시스템으로, inode 값을 0으로 보고하는 특성 때문에 발생한 문제였습니다.
• Git worktree에서 실행할 때 '.claude/agents/'와 '.claude/skills/' 디렉토리의 에이전트와 스킬이 인식되지 않던 문제가 수정되었습니다. Git worktree는 하나의 저장소에서 여러 작업 브랜치를 동시에 체크아웃할 수 있는 기능입니다.
• 커스텀 에이전트의 'model' 필드가 팀메이트 생성 시 무시되던 문제가 수정되었습니다.
• 백그라운드 에이전트 결과가 최종 응답 대신 원시 트랜스크립트 데이터를 반환하던 문제가 수정되었습니다.
• SKILL.md 프론트매터의 'name'이나 'description'이 숫자일 때 발생하던 크래시가 수정되었습니다. 이제 문자열로 자동 변환됩니다.
• SKILL.md 프론트매터의 'argument-hint'가 YAML 배열 문법을 사용할 때 React 크래시(error #31)가 발생하던 문제가 수정되었습니다.
• 'claude doctor'와 'claude plugin validate' 같은 비대화형 하위 명령어가 중첩된 Claude 세션 내부에서 차단되던 문제가 수정되었습니다.
• 사용자 스킬이 많이 설치된 경우 '/help', '/model' 등 기본 슬래시 명령어가 자동완성 목록에서 사라지던 문제가 수정되었습니다.
• 지연 로딩 후 MCP 서버가 MCP 관리 대화상자에 표시되지 않던 문제가 수정되었습니다.

파일 편집 및 쓰기 관련 수정

• 파일 쓰기 도구가 파일 끝의 의도적인 빈 줄을 제거하던 문제가 수정되었습니다. 내부적으로 사용하던 'trimEnd()' 함수가 후행 공백을 자동으로 지우고 있었습니다.
• 하나의 파일 쓰기/편집 오류가 동시에 진행 중인 다른 파일 작업까지 중단시키던 문제가 수정되었습니다. 이제 독립적인 파일 작업은 다른 작업의 실패와 관계없이 완료됩니다.
• 편집 도구가 유니코드 둥근 따옴표(Unicode curly quotes)를 직선 따옴표로 자동 변환하여 원본 내용을 손상시키던 문제가 수정되었습니다.

Shell 및 터미널 관련 수정

• 역슬래시 줄바꿈('')으로 여러 줄에 걸쳐 작성된 셸 명령어가 빈 인자를 생성하여 실행이 실패하던 문제가 수정되었습니다.
• 셸 명령어가 자신의 작업 디렉토리를 삭제한 후 모든 셸 명령어가 영구적으로 실패하던 문제가 수정되었습니다.
• 이중 밑줄('')로 시작하는 셸 함수가 세션 간에 유지되지 않던 문제가 수정되었습니다. 'git_ps1' 같은 함수가 이에 해당합니다.
• 샌드박스 환경에서 zsh heredoc이 "read-only file system" 오류를 발생시키던 문제가 수정되었습니다.
• 마크다운 내 인라인 코드 스팬이 Bash 명령어로 잘못 인식되던 문제가 수정되었습니다.

기타 수정

• 대화에 PDF 문서가 많이 포함된 경우 컨텍스트 압축이 실패하던 문제가 수정되었습니다. 압축 API에 전송하기 전에 문서 블록을 이미지와 함께 제거하도록 변경되었습니다.
• 동시 실행 에이전트가 있는 세션에서 "thinking blocks cannot be modified" API 400 오류가 발생하던 문제가 수정되었습니다. 스트리밍 콘텐츠 블록이 교차되면서 메시지 병합이 실패하는 것이 원인이었습니다.
• 컨텍스트 압축 후 플랜 모드가 해제되어 Claude가 계획 대신 구현을 시작하던 문제가 수정되었습니다.
• settings.json의 'alwaysThinkingEnabled: true' 설정이 Bedrock과 Vertex 환경에서 적용되지 않던 문제가 수정되었습니다.
• 웹 검색을 사용한 세션에서 '/fork' 명령어 실행 시 크래시가 발생하던 문제가 수정되었습니다.
• 읽기 전용 git 명령어가 macOS에서 FSEvents 파일 감시 루프를 유발하던 문제가 수정되었습니다. '--no-optional-locks' 플래그를 추가하여 해결했습니다.
• 'claude doctor'가 mise와 asdf로 관리되는 설치를 네이티브 설치로 잘못 분류하던 문제가 수정되었습니다. mise와 asdf는 프로그래밍 언어의 버전을 관리하는 도구입니다.
• Bash 권한 분류기가 실제 규칙과 일치하지 않는 설명을 생성하여 잘못된 권한을 부여하던 문제가 수정되었습니다.
• 멀티라인 Bash 명령어에 "항상 허용"을 설정할 때 잘못된 권한 패턴이 생성되어 설정 파일이 손상되던 문제가 수정되었습니다.
• Git worktree에서 백그라운드 작업이 실패하던 문제가 수정되었습니다.
• 에이전트 진행 표시기의 도구 사용 횟수가 부풀려 표시되던 문제가 수정되었습니다.
• Warp 터미널에서 Shift+Enter 설정 안내가 불필요하게 표시되던 문제가 수정되었습니다. Warp은 해당 기능을 기본 지원합니다.
• LSP의 'findReferences' 등 위치 기반 작업이 'node_modules'나 'venv' 같은 gitignore 대상 파일의 결과를 포함하던 문제가 수정되었습니다.
• 좁은 터미널에서 축소된 읽기/검색 힌트 텍스트가 넘치던 문제가 수정되었습니다.
• 스피너에 토큰이 수신되기 전에 "0 tokens" 카운터가 표시되던 문제가 수정되었습니다.
• VS Code에서 AskUserQuestion 대화상자가 열려 있을 때 대화 메시지가 흐리게 표시되던 문제가 수정되었습니다.
• OSC 8 하이퍼링크가 여러 줄에 걸칠 때 첫 번째 줄에서만 클릭할 수 있던 문제가 수정되었습니다.
• 팀메이트 스피너가 설정의 'spinnerVerbs'를 반영하지 않던 문제가 수정되었습니다.
• headless/SDK 모드에서 'tool_decision' 텔레메트리 이벤트가 전송되지 않던 문제가 수정되었습니다.

결론

2.1.47 버전은 Windows 사용자라면 터미널 렌더링, 훅 실행, 파일 경로 처리 등 다방면에서 안정성이 개선되었으므로 반드시 업데이트를 권장합니다. 장시간 Claude Code를 사용하는 사용자에게는 메모리 최적화와 시작 속도 향상이 체감되는 변화입니다. 세션 관리와 /resume 기능의 신뢰성도 크게 높아져, 작업 연속성이 중요한 환경에서 활용도가 높아졌습니다.

<ㅎㅎ>