Claude Code 2.1.83 업데이트 정리

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

2026년 3월 25일 Claude Code 2.1.83이 배포되었습니다. 이번 버전은 팀별 정책 파일을 독립적으로 관리할 수 있는 managed-settings.d/ 디렉터리와 디렉터리·파일 변경에 반응하는 훅 이벤트가 주요 추가 사항입니다. Claude Code가 실행하는 하위 프로세스에서 인증 정보를 자동 제거하는 보안 기능이 더해졌고 UI 멈춤, 응답 없음, 스크롤 점프 등 35건 이상의 버그가 수정된 안정성 중심 릴리즈입니다.

3줄 요약

• managed-settings.d/ 디렉터리가 추가되어 팀별로 독립적인 정책 파일을 배포하고 알파벳 순으로 병합할 수 있습니다.
• CwdChanged와 FileChanged 훅 이벤트가 추가되어 작업 디렉터리나 파일이 바뀔 때 자동으로 환경을 전환할 수 있습니다.
• 시작 시 UI 멈춤, 대용량 파일 diff 응답 없음, 스크롤백 점프 등 35건 이상의 버그가 수정되었습니다.

주요 변경사항

팀별 정책 파일을 독립적으로 관리할 수 있습니다

managed-settings.json 옆에 managed-settings.d/ 디렉터리가 추가되었습니다. 이 디렉터리에 개별 JSON 파일을 넣어두면 파일 이름의 알파벳 순으로 자동 병합됩니다. 여러 팀이 하나의 managed-settings.json을 수정하다 충돌이 발생하는 문제 없이 각 팀이 자체 정책 파일만 관리하면 됩니다. 엔터프라이즈 환경에서 보안팀, 인프라팀, 개발팀이 각각 독립적으로 정책을 배포할 수 있습니다.

디렉터리·파일 변경에 반응하는 훅 이벤트가 추가되었습니다

CwdChanged와 FileChanged 두 가지 훅 이벤트가 추가되었습니다. 작업 디렉터리가 바뀌거나 특정 파일이 수정되면 미리 등록해 둔 스크립트를 자동으로 실행할 수 있습니다. 예를 들어 디렉터리를 이동할 때마다 해당 프로젝트에 맞는 환경 변수를 자동으로 불러오거나 설정 파일이 바뀌면 즉시 리로드하는 자동화를 구성할 수 있습니다.

Claude Code가 실행하는 하위 프로세스에서 인증 정보를 자동으로 제거할 수 있습니다

CLAUDE_CODE_SUBPROCESS_ENV_SCRUB=1 환경 변수를 설정하면 Claude Code가 내부적으로 실행하는 Bash 명령, 훅 스크립트, MCP 서버 등에 Anthropic API 키나 클라우드 인증 정보가 전달되지 않습니다. Claude Code 자체는 API 키를 사용하지만 그 안에서 실행되는 명령이나 외부 서버에는 인증 정보가 노출되지 않도록 차단하는 기능입니다.

트랜스크립트 모드에서 검색할 수 있습니다

Ctrl+O로 진입하는 트랜스크립트 모드에서 / 키를 누르면 검색이 시작됩니다. n과 N 키로 다음/이전 결과를 탐색할 수 있습니다. 긴 대화 기록에서 특정 내용을 찾아야 할 때 스크롤 없이 바로 이동할 수 있습니다.

부가 변경사항

보안

• sandbox.failIfUnavailable 설정이 추가되었습니다. 격리 환경인 샌드박스가 활성화되어 있지만 시작할 수 없을 때 샌드박스 없이 그냥 실행하는 대신 오류와 함께 종료합니다. 의도치 않게 격리 없이 실행되는 상황을 방지합니다.
• disableDeepLinkRegistration 설정이 추가되어 Claude Code가 운영 체제에 claude-cli:// 링크 핸들러를 등록하는 것을 비활성화할 수 있습니다.
• --mcp-config CLI 플래그가 조직에서 설정한 MCP 서버 허용/차단 정책을 우회하던 문제가 수정되었습니다.

이미지 및 편집기

• 붙여넣기한 이미지가 커서 위치에 [Image #N] 칩으로 삽입됩니다. 프롬프트에서 "Image #1을 분석해줘"처럼 이미지를 위치로 참조할 수 있습니다.
• Ctrl+X Ctrl+E가 외부 편집기 열기의 추가 단축키로 등록되었습니다. 기존 Ctrl+G도 유지됩니다.
• Claude가 클립보드에서 붙여넣은 이미지의 디스크 경로를 참조하여 파일 작업을 수행할 수 있습니다.
• Ctrl+L이 화면 초기화와 전체 다시 그리기를 수행합니다. Cmd+K로 UI가 부분적으로 비는 현상을 복구할 때 사용할 수 있습니다.

플러그인 및 에이전트

• 에이전트 설정 파일 상단의 메타데이터 영역에 initialPrompt를 선언하면 에이전트가 시작될 때 첫 메시지를 자동으로 제출할 수 있습니다.
• 플러그인이 사용자에게 설정값을 입력받을 수 있는 manifest.userConfig 기능이 추가되었습니다. 민감한 값은 macOS에서는 키체인에, 다른 플랫폼에서는 보호된 인증 정보 파일에 안전하게 저장됩니다.
• 조직에서 관리하는 MCP 커넥터와 중복되는 플러그인 MCP 서버는 두 번째 연결 없이 억제됩니다.
• 제거된 플러그인의 훅이 다음 세션까지 계속 실행되던 문제가 수정되었습니다.

성능 개선

• AWS Bedrock을 통해 처음 호출할 때 발생하는 초기 지연이 프로필 가져오기와 다른 부팅 작업을 동시에 처리하여 개선되었습니다.
• --resume으로 이전 세션을 이어서 열 때 메모리 사용량과 시작 지연이 대규모 세션에서 개선되었습니다.
• 플러그인 시작 시 명령, 스킬, 에이전트가 디스크 캐시에서 로드되어 매번 다시 가져오지 않아도 됩니다.
• WebFetch가 대용량 페이지를 처리할 때 최대 메모리 사용량이 줄었습니다.
• --bare -p 조합으로 SDK에서 호출할 때 API 요청까지 약 14% 빨라졌습니다.
• 인증 없이 연결하는 HTTP/SSE MCP 서버를 사용할 때 claude -p 시작이 약 600ms 빨라졌습니다.
• 스트리밍이 실패했을 때 사용하는 비스트리밍 폴백 방식의 토큰 상한이 21k에서 64k로, 시간 제한이 120초에서 300초로 늘어나 응답이 중간에 잘리는 현상이 줄었습니다.

터미널 및 UI

• Claude Code 종료 후 마우스 관련 제어 코드가 셸 프롬프트에 남아 깨진 문자가 표시되던 문제가 수정되었습니다.
• 유휴 상태에서 몇 초 후 화면이 빈 채로 깜빡이던 문제가 수정되었습니다.
• 공통 라인이 적은 대용량 파일의 diff에서 응답이 멈추던 문제가 수정되었습니다. 5초 후 자동으로 타임아웃됩니다.
• 음성 입력 활성화 시 오디오 모듈을 즉시 로드하면서 1~8초 동안 UI가 멈추던 문제가 수정되었습니다.
• claude.ai MCP 설정을 가져올 때까지 약 3초간 시작이 지연되던 회귀가 수정되었습니다.
• 축소된 읽기/검색 그룹이 화면 밖에서 완료될 때 스크롤이 갑자기 튀던 문제가 수정되었습니다.
• 모델이 사고를 시작하거나 멈출 때 스크롤이 최상단으로 튀던 문제가 수정되었습니다.
• 응답이 시작되기 전에 프롬프트를 중단하면 입력한 내용이 자동으로 복원되어 수정 후 다시 보낼 수 있습니다.
• /status가 Claude 응답 중에도 즉시 동작합니다. 턴이 끝날 때까지 대기하지 않습니다.
• 높이 제한된 목록에서 항목이 넘칠 때 잔상 문자가 나타나던 문제가 수정되었습니다.
• 슬래시 명령이 메시지 처리 중 제출되면 명령이 아닌 일반 텍스트로 전송되던 문제가 수정되었습니다.
• 대기 중인 명령이 스트리밍 응답 중 깜빡이던 문제가 수정되었습니다.
• /config 메뉴에서 검색 커서와 목록 선택이 동시에 표시되던 문제가 수정되었습니다.

안정성

• macOS에서 Claude Code가 종료 시 멈추던 문제가 수정되었습니다.
• Mac에서 Claude Code가 종료된 뒤에도 잠자기 방지 프로세스가 남아 Mac이 잠자기 모드에 들어가지 않던 문제가 수정되었습니다.
• 대화가 길어져 컨텍스트가 압축된 후 백그라운드 에이전트가 보이지 않게 되어 같은 에이전트가 중복 생성될 수 있던 문제가 수정되었습니다.
• 백그라운드 에이전트 작업이 git이나 API 호출에서 응답을 받지 못해 "실행 중" 상태로 멈추던 문제가 수정되었습니다.
• 세션을 재개할 때 내부 메시지 연결 고리가 끊어져 이전 대화 기록이 손실되던 문제가 수정되었습니다.
• 도구 결과 파일이 cleanupPeriodDays 설정을 무시하고 삭제되지 않던 문제가 수정되었습니다.
• MCP 서버와의 실시간 스트리밍 연결이 중간에 끊어져 재연결 시도를 모두 소진하면 도구 호출이 무한 대기하던 문제가 수정되었습니다.
• Linux 샌드박스 모드에서 rg ... | wc -l 같은 파이프 명령이 멈추며 0을 반환하던 문제가 수정되었습니다.

음성 모드

• Docker, 헤드리스 서버, WSL1처럼 오디오 하드웨어가 없는 Linux 환경에서 음성 모드 사용 시 ALSA 오류가 터미널 UI를 손상시키던 문제가 수정되었습니다.
• Termux나 Android에서 커널 제한으로 인해 오디오 처리에 필요한 SoX를 감지하지 못하던 문제가 수정되었습니다.
• 한국어, 중국어, 일본어 입력기가 전각 공백을 삽입할 때 길게 눌러 말하기 기능이 활성화되지 않던 문제가 수정되었습니다.
• 길게 눌러 말하기를 해제한 후 최대 3초간 스페이스 키가 먹히지 않던 문제가 수정되었습니다.

Remote Control

• 활성 실행 중인 세션이 웹 세션 목록에서 "유휴"로 표시되던 문제가 수정되었습니다.
• 원격 세션에서 도구 호출 식별자가 무한히 누적되는 메모리 누수가 수정되었습니다.
• AI가 생성하는 세션 제목이 첫 메시지 후 몇 초 내에 표시되도록 개선되었습니다.
• 백그라운드 에이전트가 첫 사용자 메시지 전에 완료되면 세션 제목에 원시 XML 태그가 그대로 표시되던 문제가 수정되었습니다.
• 컨테이너 재시작 후 대화 기록이 손실되던 문제가 수정되었습니다.
• 일시적인 인증 오류가 발생했을 때 자동 재시도 대신 재로그인을 요구하던 문제가 수정되었습니다.

기타

• chat:killAgents와 chat:fastMode를 ~/.claude/keybindings.json에서 원하는 키로 재바인딩할 수 있습니다.
• "모든 백그라운드 에이전트 중지" 단축키가 Ctrl+F에서 Ctrl+X Ctrl+K로 변경되었습니다. 기존 Ctrl+F가 터미널의 커서 앞으로 이동 기능과 충돌하던 문제를 해소합니다.
• Ctrl+B가 아무 작업도 없는 유휴 상태에서 터미널의 커서 뒤로 이동 기능을 방해하지 않도록 수정되었습니다. 백그라운드로 보낼 작업이 있을 때만 동작합니다.
• 명령 입력 시 나타나는 자동 완성 힌트에 방금 실행한 명령이 즉시 반영됩니다.
• TaskOutput 도구가 더 이상 사용되지 않으며 백그라운드 작업의 출력 파일 경로를 Read로 읽는 방식으로 대체됩니다.
• WebFetch가 Claude-User라는 이름으로 자신을 식별합니다. 사이트 운영자가 robots.txt를 통해 Claude Code의 웹 접근을 별도로 관리할 수 있습니다.
• Linux에서 claude-cli:// 링크 핸들러 등록 시 사용자가 지정한 데이터 디렉터리 경로를 준수합니다.
• MEMORY.md 인덱스가 200줄뿐 아니라 25KB 용량 기준으로도 잘립니다.
• --channels 활성화 시 사용자에게 질문하는 도구와 플랜 모드 도구가 비활성화됩니다.
• claude.ai에서 연결한 Slack, Gmail 같은 MCP 커넥터가 단일 턴 --print 모드에서 사용할 수 없던 문제가 수정되었습니다.
• bash 모드가 !로 시작하는 명령 제안을 탭으로 수락할 때 활성화되지 않던 문제가 수정되었습니다.
• --worktree에서 워크트리 이름에 슬래시가 포함되면 아무 반응 없이 멈추던 문제가 수정되었습니다.
• 업그레이드 후 첫 실행 시 --channels에서 "채널을 현재 사용할 수 없음"이 표시되던 문제가 수정되었습니다.
• 도구 호출이 실패하는 도중에 이미지를 붙여넣으면 API 400 오류가 발생하던 문제가 수정되었습니다.

VSCode

• 백엔드가 60초간 응답하지 않으면 스피너가 빨간색으로 바뀌고 "Not responding"이 표시됩니다.
• URL이나 재시작을 통해 세션을 다시 열 때 세션 기록이 올바르게 로드되지 않던 문제가 수정되었습니다.
• Esc를 두 번 누르거나 /rewind를 입력하면 키보드로 탐색 가능한 되감기 선택기를 열 수 있습니다.
• "여기서 대화 분기"와 되감기 동작이 세션 캐시가 오래되면 조용히 실패하던 문제가 수정되었습니다.

결론

Claude Code 2.1.83은 managed-settings.d/ 디렉터리로 엔터프라이즈 환경의 정책 관리를 개선하고 CwdChanged/FileChanged 훅 이벤트로 환경 전환 자동화를 지원합니다.

보안 측면에서는 CLAUDE_CODE_SUBPROCESS_ENV_SCRUB로 하위 프로세스에 인증 정보가 유출되는 것을 방지할 수 있고 sandbox.failIfUnavailable로 격리 환경 없이 실행되는 것을 차단할 수 있습니다.

35건이 넘는 버그 수정으로 시작 지연, UI 멈춤, 스크롤 점프 등 다양한 안정성 문제가 해소되었습니다. Remote Control과 음성 모드 관련 수정이 많아 해당 기능을 사용하는 분들에게 체감 개선이 클 것으로 보입니다.