티스토리 뷰

반응형

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

2026년 3월 26일 Claude Code 2.1.84가 배포되었습니다. 이번 버전의 가장 큰 변화는 Windows 환경에서 PowerShell 도구를 사용할 수 있게 된 것입니다. 옵트인 프리뷰 단계로 제공되며 기존 Bash 도구 외에 Windows 네이티브 셸을 직접 활용할 수 있습니다. 한국어를 포함한 CJK 입력기 사용자에게 영향을 주던 커서 추적 문제가 수정되었고 다수의 안정성 개선과 성능 최적화가 포함되었습니다.

3줄 요약

  • Windows용 PowerShell 도구가 옵트인 프리뷰로 추가되어 Bash 대신 PowerShell로 명령을 실행할 수 있습니다.
  • 한국어·중국어·일본어 입력 시 커서가 입력 위치를 따라가지 않던 문제가 수정되어 IME 조합이 정상적으로 표시됩니다.
  • 75분 이상 자리를 비운 뒤 돌아오면 /clear를 권유하는 안내가 표시되어 불필요한 토큰 재캐싱을 줄일 수 있습니다.

주요 변경사항

Windows에서 PowerShell 도구를 사용할 수 있습니다

Windows 환경에서 PowerShell을 직접 사용할 수 있는 도구가 옵트인 프리뷰로 추가되었습니다. 지금까지 Windows 사용자도 Bash(Git Bash 등)를 통해 명령을 실행해야 했는데 이제 PowerShell 스크립트와 cmdlet을 그대로 활용할 수 있습니다. .ps1 스크립트 실행이나 Windows 전용 관리 작업에서 별도의 변환 없이 자연스럽게 작업할 수 있습니다. 자세한 내용은 공식 문서에서 확인할 수 있습니다.

CJK 입력기 커서 추적 문제가 수정되었습니다

터미널의 네이티브 커서가 텍스트 입력 캐럿을 따라가지 않아 한국어, 중국어, 일본어 입력 시 IME 조합 창이 엉뚱한 위치에 표시되던 문제가 수정되었습니다. 스크린 리더도 입력 위치를 정확히 추적할 수 있게 되었습니다. 한국어 사용자라면 입력 중 조합 문자가 제자리에 나타나는 것을 확인할 수 있습니다.

오래 자리를 비운 뒤 돌아오면 컨텍스트 정리를 안내합니다

75분 이상 유휴 상태 후 돌아오면 /clear를 권유하는 안내 메시지가 표시됩니다. 오래된 세션을 그대로 이어가면 이미 만료된 캐시를 다시 생성하는 데 토큰이 소모되는데 이를 미리 안내하여 불필요한 비용을 줄여줍니다.

부가 변경사항

환경 설정 및 관리

  • 서드파티 API 제공자(Bedrock, Vertex, Foundry)에서 기본 모델의 기능 감지를 재정의할 수 있는 ANTHROPIC_DEFAULT_{OPUS,SONNET,HAIKU}_MODEL_SUPPORTS 환경 변수가 추가되었습니다. _MODEL_NAME_DESCRIPTION으로 /model 선택기의 레이블도 변경할 수 있습니다.
  • 스트리밍 유휴 감시 임계값을 설정하는 CLAUDE_STREAM_IDLE_TIMEOUT_MS 환경 변수가 추가되었습니다. 기본값은 90초입니다.
  • Team/Enterprise 관리자가 채널 플러그인 허용 목록을 정의할 수 있는 allowedChannelPlugins 관리형 설정이 추가되었습니다.
  • 규칙 및 스킬 경로의 frontmatter에서 YAML 리스트 형식의 glob 패턴을 사용할 수 있습니다.

훅 및 자동화

  • TaskCreate로 작업이 생성될 때 발동하는 TaskCreated 훅이 추가되었습니다.
  • WorktreeCreate 훅에서 type: "http"를 지원합니다. 응답 JSON의 hookSpecificOutput.worktreePath로 생성된 워크트리 경로를 반환할 수 있습니다.

MCP

  • MCP 도구 설명과 서버 지시문이 2KB로 제한됩니다. OpenAPI에서 자동 생성된 서버가 컨텍스트를 과도하게 차지하는 것을 방지합니다.
  • 로컬과 claude.ai 커넥터에 동시에 설정된 MCP 서버가 중복 제거됩니다. 로컬 설정이 우선합니다.
  • MCP 서버 재연결 시 도구/리소스 캐시가 누수되던 문제가 수정되었습니다.

터미널 및 UI

  • claude-cli:// 딥링크가 감지 목록의 첫 번째 터미널이 아닌 사용자가 선호하는 터미널에서 열립니다.
  • 백그라운드 Bash 작업이 대화형 프롬프트에서 멈춘 것처럼 보이면 약 45초 후 알림이 표시됩니다.
  • 100만 이상의 토큰 수가 "1512.6k" 대신 "1.5m"으로 표시됩니다.
  • 사용할 수 없는 슬래시 명령(/voice, /mobile, /chrome, /upgrade 등)이 목록에서 숨겨집니다.
  • 이슈/PR 참조가 owner/repo#123 형식으로 작성된 경우에만 클릭 가능한 링크가 됩니다. 단독 #123은 더 이상 자동 링크되지 않습니다.

성능 개선

  • setup()을 슬래시 명령·에이전트 로딩과 병렬로 실행하여 인터랙티브 시작이 약 30ms 빨라졌습니다.
  • MCP 서버가 있는 환경에서 claude "prompt" 실행 시 모든 서버 연결을 기다리지 않고 REPL이 즉시 렌더링됩니다.
  • ToolSearch가 활성화된 환경에서도 글로벌 시스템 프롬프트 캐싱이 동작합니다. MCP 도구를 사용하는 사용자도 포함됩니다.
  • p90 프롬프트 캐시 적중률이 개선되었습니다.
  • 긴 세션에서 메시지 창이 컴팩션과 그룹 변경에 영향받지 않아 스크롤이 최상단으로 초기화되는 현상이 줄었습니다.
  • 애니메이션 도구 진행 표시가 뷰포트 위로 스크롤될 때 발생하던 터미널 깜빡임이 줄었습니다.

버그 수정

  • 음성 길게 눌러 말하기 사용 시 음성 키를 누르고 있는 동안 문자가 텍스트 입력에 삽입되던 문제가 수정되었습니다. 트랜스크립트도 올바른 위치에 삽입됩니다.
  • 푸터 항목에 포커스가 있을 때 위/아래 화살표 키가 반응하지 않던 문제가 수정되었습니다.
  • 여러 줄 입력에서 줄 경계에 위치할 때 Ctrl+U(줄 시작까지 삭제)가 동작하지 않던 문제가 수정되었습니다. 반복 입력 시 줄을 넘어 삭제할 수 있습니다.
  • 기본 코드 바인딩을 null로 해제해도(예: "ctrl+x ctrl+k": null) 코드 대기 모드에 진입하던 문제가 수정되어 접두 키가 올바르게 해제됩니다.
  • 트랜스크립트 검색 입력에 마우스 이벤트가 "mouse" 문자로 삽입되던 문제가 수정되었습니다.
  • 외부 세션이 --json-schema를 사용하고 서브에이전트도 스키마를 지정할 때 워크플로 서브에이전트가 API 400 오류로 실패하던 문제가 수정되었습니다.
  • 일부 터미널에서 사용자 메시지 버블의 특정 이모지 뒤에 배경색이 누락되던 문제가 수정되었습니다.
  • Edit(.claude) 허용 규칙이 있는 사용자에게 "이 세션에서 Claude가 자체 설정을 편집하도록 허용" 권한 옵션이 유지되지 않던 문제가 수정되었습니다.
  • 대용량 편집 파일의 첨부 스니펫을 생성할 때 멈추던 문제가 수정되었습니다.
  • 부분 클론 리포지토리(Scalar/GVFS)에서 시작 시 대량 blob 다운로드가 발생하던 성능 문제가 수정되었습니다.
  • macOS에서 일시적인 키체인 읽기 실패로 인해 "로그인되지 않음" 오류가 잘못 표시되던 문제가 수정되었습니다.
  • 콜드스타트 시 핵심 도구가 바이패스 없이 지연 로드되어 Edit/WriteInputValidationError로 실패하던 레이스 컨디션이 수정되었습니다.
  • Windows 드라이브 루트(C:\, C:\Windows 등)의 위험한 삭제에 대한 감지가 개선되었습니다.

Remote Control

  • 차단되었을 때 "아직 활성화되지 않음"이라는 일반적인 메시지 대신 구체적인 차단 사유가 표시됩니다.

API 디버깅

  • API 요청에 x-client-request-id 헤더가 추가되어 타임아웃 디버깅이 용이해졌습니다.

VSCode

  • 사용량 비율과 초기화 시간을 표시하는 속도 제한 경고 배너가 추가되었습니다.
  • /stats에서 Ctrl+S로 캡처하는 통계 스크린샷이 모든 빌드에서 동작하며 속도가 16배 빨라졌습니다.

결론

Claude Code 2.1.84는 Windows 사용자를 위한 PowerShell 도구 프리뷰가 가장 눈에 띄는 변화입니다. Windows 환경에서 Bash를 거치지 않고 네이티브 셸을 직접 사용할 수 있어 작업 흐름이 한결 자연스러워질 것으로 보입니다.

한국어 사용자에게는 IME 커서 추적 수정이 반가운 소식입니다. 입력 중 조합 문자가 엉뚱한 위치에 표시되던 불편함이 해소되었습니다.

MCP 도구 설명 2KB 제한과 서버 중복 제거로 컨텍스트 관리가 효율적으로 개선되었고 시작 성능 최적화와 다수의 버그 수정으로 전반적인 안정성이 높아졌습니다.

반응형
댓글
최근에 올라온 글
최근에 달린 댓글