Claude Code 2.1.133 업데이트

💡

워크트리 베이스 브랜치를 `origin/<default>`로 되돌리는 `worktree.baseRef` 설정이 추가되고, 훅과 Bash 명령에서 현재 effort 레벨을 `$CLAUDE_EFFORT`로 읽을 수 있습니다. 리프레시 토큰 경쟁으로 병렬 세션이 모두 401에 빠지던 문제, MCP OAuth 흐름이 `HTTP(S)_PROXY`·mTLS를 지키지 않던 문제, 서브에이전트가 프로젝트·사용자·플러그인 스킬을 찾지 못하던 문제 등 인증·프록시·스킬 영역의 회귀가 정리되었습니다.

#Claude Code#업데이트
🔗 공식 발표 →

이 글은 공식 문서를 바탕으로 요약·정리한 내용입니다.

무엇이 바뀌었나?

Claude Code 2.1.133이 2026년 5월 7일(현지 시간) 릴리스되었습니다. 워크트리 기준 브랜치를 명시적으로 고를 수 있는 worktree.baseRef 설정과 훅·Bash에서 effort 레벨을 읽는 경로가 더해지고, 리프레시 토큰 경쟁·MCP OAuth 프록시·서브에이전트 스킬 탐색·매핑된 네트워크 드라이브 권한처럼 운영 환경에서 직접 부딪히던 결함이 폭넓게 수정되었습니다.

새 기능

  • worktree.baseRef — 워크트리 기준 브랜치 선택(fresh | head)

    2.1.128부터 --worktree·EnterWorktree·에이전트 격리용 워크트리는 기준 브랜치가 로컬 HEAD로 바뀌어 있었습니다. 이 때문에 푸시되지 않은 커밋이 새 워크트리에 따라 들어오는 흐름과, origin/<default>에서 깨끗하게 분기하길 원하는 흐름 사이에서 의도가 갈렸습니다. 이번 릴리스는 worktree.baseRef 설정을 추가하고 기본값을 fresh(= origin/<default>)로 되돌렸습니다. 푸시 전 커밋을 그대로 가져오던 동작을 유지하려면 worktree.baseRef: "head"로 설정합니다.

  • sandbox.bwrapPath / sandbox.socatPath — 샌드박스 바이너리 경로 지정(Linux·WSL)

    Linux·WSL 환경의 샌드박스는 bubblewrap(bwrap)과 socat을 호출합니다. 비표준 경로에 설치된 환경에서는 자동 탐색이 실패해 샌드박스가 동작하지 않았습니다. 두 managed 설정으로 바이너리 경로를 직접 지정할 수 있습니다.

  • parentSettingsBehavior — 관리자 계층 정책 병합 옵션('first-wins' | 'merge')

    SDK managedSettings(parent 계층)를 정책 병합에 포함시킬지 여부를 관리자가 선택할 수 있는 admin-tier 키입니다. merge로 두면 SDK 측 설정도 정책 병합에 합류합니다.

  • 훅·Bash에서 effort 레벨 읽기

    훅 입력 JSON에 effort.level 필드가 추가되고, 훅 환경변수와 Bash 도구가 실행하는 명령에서 $CLAUDE_EFFORT로 현재 effort 레벨을 읽을 수 있습니다. effort에 따라 분기하는 자동화 스크립트를 작성할 때 활용할 수 있습니다.

  • claude --help에 --remote-control 노출

    기존에 --remote-control-session-name-prefix만 표시되던 도움말에 --remote-control 자체가 함께 나열됩니다.

주요 개선

  • 포커스 모드 동작 개선

    포커스 모드의 흐름이 다듬어졌습니다.

  • 메모리 압박 시 워밍 워커 회수

    백그라운드에서 대기하던 warm-spare 워커가 메모리 압박 상황에서 해제되도록 변경되어, 장기 세션의 메모리 사용량이 줄어듭니다.

주요 버그 수정

인증·세션

  • 리프레시 토큰 경쟁으로 병렬 세션이 모두 401에 빠지던 문제 수정 — 여러 세션이 동시에 토큰을 갱신하다가 공유 자격 증명이 지워지면 이후 세션이 모두 401로 막혔습니다.
  • claude.ai의 Remote Control stop/interrupt가 로컬 Esc만큼 세션을 완전히 취소하지 못해, 멈춘 도구·프롬프트를 인터럽트한 뒤 큐에 쌓인 메시지가 진행되지 않던 문제 수정.

권한·파일 접근

  • Edit·Write 허용 규칙이 드라이브 루트(C:\)나 POSIX 루트(/)로 지정됐을 때 매칭이 잘못되어 항상 권한 프롬프트가 뜨던 문제 수정.
  • --add-dir·SDK additionalDirectories로 전달된 매핑된 네트워크 드라이브에서 Read/Write/Edit이 거부되던 문제 수정.

MCP·프록시

  • MCP OAuth 흐름 전체(discovery, dynamic client registration, token exchange, token refresh)가 HTTP(S)_PROXY·NO_PROXY·mTLS 설정을 따르지 않던 문제 수정 — 기업 프록시·인증서 환경에서 MCP OAuth가 우회되거나 실패하던 흐름이 정리되었습니다.

Effort·스킬

  • 한 세션에서 /effort로 effort를 바꾸면 동시에 실행 중인 다른 세션의 effort까지 변경되던 문제, 그리고 IDE에서 effort를 바꾸면 조용히 무시되던 문제 수정.
  • 서브에이전트가 Skill 도구로 프로젝트·사용자·플러그인 스킬을 찾지 못하던 문제 수정.

안정성

  • 시계 편차나 느린 디스크로 히스토리·세션 로그 파일 락이 손상되면 처리되지 않은 거부(ECOMPROMISED)가 발생하던 문제 수정.
  • 대화 압축 중 Esc를 누르면 “Error compacting conversation” 알림이 잘못 표시되던 문제 수정.

IDE

  • [VSCode] 확장 빌드에 Claude 바이너리가 번들되지 않은 환경에서 claudeCode.claudeProcessWrapper가 “Unsupported platform”으로 실패하던 문제 수정.

알아두면 좋은 점

  • worktree.baseRef 기본값이 fresh로 환원 — 2.1.128부터 로컬 HEAD로 분기하던 동작이 다시 origin/<default>로 돌아갔습니다. 푸시되지 않은 커밋을 새 워크트리에 그대로 가져오던 흐름에 의존하고 있었다면 worktree.baseRef: "head"를 명시적으로 설정해야 합니다.
  • MCP OAuth 프록시·mTLS 미적용 수정 — Zscaler·Netskope 같은 TLS 프록시나 사내 mTLS 환경에서 MCP OAuth 흐름이 우회되거나 끊기던 회귀가 해소되었습니다. 별도 설정 변경 없이 환경변수를 그대로 따릅니다.
  • /effort 세션 분리 수정 — /effort는 이제 호출한 세션에만 적용됩니다. effort를 세션별로 다르게 운영하던 환경은 이번 버전부터 의도대로 동작합니다.
  • 서브에이전트 스킬 탐색 복구 — 서브에이전트에서 Skill 도구가 동작하지 않아 프로젝트·플러그인 스킬을 호출하지 못하던 사례가 있었다면 이 버전에서 정상화됩니다.
  • $CLAUDE_EFFORT — 훅과 Bash 명령에서 현재 effort 레벨을 읽을 수 있습니다. high·medium·low 분기를 가진 자동화 스크립트에서 활용 가능합니다.
  • 샌드박스 바이너리 경로 — Linux·WSL에서 bwrap·socat이 비표준 경로에 설치돼 샌드박스가 동작하지 않았다면 sandbox.bwrapPath·sandbox.socatPath로 직접 지정하세요.