claudekit / updates / claude-code-2-1-153
[ PATCH · ]

Claude Code 2.1.153

`/model`이 IDE처럼 새 세션 기본값을 저장하도록 바뀌고, 현재 세션 한정 전환은 모델 픽커 `s` 키로 옮겨졌습니다(2.1.144 `d` 동작 반전, 키바인딩 마이그레이션 필요). 보안 관련으로 커스텀 API 게이트웨이가 사용자 Anthropic OAuth 자격을 받던 회귀, 서브에이전트 frontmatter MCP가 `--strict-mcp-config`와 엔터프라이즈 관리형 정책을 무시하던 문제가 정리됐습니다. 그 외 github/git 마켓플레이스 `skipLfs`, status line의 `COLUMNS`/`LINES`, macOS 권한 유지, 백그라운드 세션과 Windows 인스톨러 등 다수의 회귀가 정리됐습니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.153은 2026년 5월 28일에 출시됐습니다. /model 기본 동작이 IDE와 동일하게 “선택을 새 세션의 기본값으로 저장”으로 바뀌고, 현재 세션 한정 전환은 모델 픽커에서 s 키로 분리됐습니다(2.1.144의 d 키 동작이 반전된 형태로, 커스텀 키바인딩 사용자는 마이그레이션이 필요합니다). 보안 측면에서는 커스텀 API 게이트웨이가 사용자 Anthropic OAuth 자격을 받던 회귀, 서브에이전트 frontmatter MCP 서버가 --strict-mcp-config와 엔터프라이즈 관리형 MCP 설정, 관리형 allow/deny 정책을 무시하던 결함 두 건이 정리됐습니다. 나머지는 github/git 마켓플레이스 skipLfs, status line의 COLUMNS/LINES 환경변수, claude agents 자동완성과 PR 컬럼 표시, macOS 백그라운드 에이전트 권한 유지 같은 개선과, 백그라운드 세션 UI, Windows 인스톨러 등 다수의 회귀 정리입니다.

주요 개선

  • /model 기본 동작 변경 (IDE와 동일, s 키로 세션 한정)

    2.1.144에서 /model은 현재 세션 한정으로 바뀌고 새 세션 기본값은 모델 픽커의 d 키였습니다. 이제 IDE와 동일하게 /model 선택이 새 세션의 기본값으로 저장되고, 현재 세션 한정 전환은 픽커에서 s를 누릅니다. 기존 modelPicker:setAsDefault 키바인딩을 커스터마이즈했다면 keybindings.json에서 modelPicker:thisSessionOnly로 이름을 바꿔야 하며, d 액션은 s로 대체됐습니다.

  • github/git 플러그인 마켓플레이스 skipLfs 옵션

    큰 LFS 자산을 가진 리포를 마켓플레이스로 등록하면 clone과 update 시 의도치 않게 LFS 데이터를 전부 받았습니다. 이제 마켓플레이스 소스에 skipLfs를 설정해 LFS 다운로드를 생략할 수 있습니다.

  • status line 명령에 COLUMNS와 LINES 환경변수 전달

    status line 스크립트가 터미널 너비를 알 수 없어 길이가 다른 라인을 적절히 자르기 어려웠습니다. 이제 status line 명령 실행 시 COLUMNS와 LINES가 환경변수로 전달돼 스크립트가 출력 크기를 터미널에 맞출 수 있습니다.

  • claude agents 자동완성과 PR 컬럼 표시 개선

    dispatch 입력 자동완성이 프로젝트 스킬만 제안하고, PR 컬럼이 항상 단일 번호만 보여 다중 PR을 가진 워크스페이스를 구분하기 어려웠습니다. 이제 자동완성은 네이티브 슬래시 명령과 번들 스킬까지 제안하고, PR 컬럼은 단일 PR이면 PR #N, 여러 PR이면 N PRs로 표시합니다.

  • claude doctor가 마지막 업데이트 시도 결과를 표시

    업데이트가 조용히 실패했을 때 어디서 막혔는지 알 수 없었습니다. 이제 claude doctor가 직전 업데이트 시도 결과를 함께 보여줍니다.

  • npm 글로벌 인스톨이 자동 업데이트를 못 할 때 일회성 안내

    npm 글로벌 인스톨 환경에서 자동 업데이트가 막혀도 안내가 없어 사용자가 구버전을 계속 사용했습니다. 이제 한 번에 한해 알림을 띄우고, /doctor에 해결 방법이 함께 나열됩니다.

  • MCP 서버, 커넥터 인증 알림 통합

    시작 시점에 “needs authentication” 알림이 MCP 서버와 커넥터에 각각 별도로 떠 잡음이 컸습니다. 이제 두 알림이 단일 메시지로 묶입니다.

  • macOS: 백그라운드 에이전트가 Privacy & Security에 “Claude Code”로 등록, 권한이 업그레이드 후에도 유지

    macOS에서 백그라운드 에이전트가 별도 프로세스 이름으로 권한 다이얼로그를 띄우거나, 업그레이드 때마다 권한이 초기화돼 사용자가 반복 승인해야 했습니다. 이제 백그라운드 에이전트가 Privacy & Security에서 “Claude Code”로 표시되고, 권한이 업그레이드를 가로질러 유지됩니다.

  • 응답 중 /bg가 응답을 백그라운드 세션에서 이어감

    응답이 진행 중일 때 /bg로 백그라운드 전환하면 진행 중 응답이 폐기됐습니다. 이제 백그라운드 세션에서 응답이 계속됩니다.

주요 버그 수정

보안과 엔터프라이즈

  • 커스텀 API 게이트웨이가 게이트웨이 자체 토큰 대신 사용자의 Anthropic OAuth 자격을 받던 회귀 — 게이트웨이는 자신의 토큰만 받습니다.
  • 서브에이전트(Agent 도구) frontmatter MCP 서버가 --strict-mcp-config, --bare, 원격 모드, 엔터프라이즈 관리형 MCP 설정, 관리형 allow/deny 정책을 모두 무시하던 문제 — 이제 모든 정책이 적용됩니다.
  • --strict-mcp-config가 명시적으로 전달된 에이전트 정의(--agents, SDK agents)의 인라인 mcpServers까지 제거하던 문제 — 인라인 정의는 유지되며, 차단된 서브에이전트 MCP 서버는 시각적 경고를 띄웁니다.

MCP와 플러그인

  • optional GET SSE 스트림이 없는 stateful MCP 서버가 tools/list에서 reconnect 루프에 빠지던 문제 (v2.1.147 회귀) — 정상 동작.
  • MCP 도구 progress 알림이 collapsed 도구 뷰에서 렌더되지 않던 문제 — 렌더됩니다.

인스톨러와 업데이트

  • Windows PowerShell 인스톨러가 실제로 실패했는데도 “Installation complete!”를 보고하던 문제 — 실패 시 명확히 보고합니다.
  • claude update가 npm 인스톨에서 설정된 릴리스 채널 버전 대신 latest를 설치하던 문제 — 채널 설정을 존중합니다.
  • Windows 업데이트 롤백 — 업데이트가 실패하면 원본 실행 파일을 복사로 복구하고 복구 안내를 표시합니다.

세션과 에이전트

  • 저장된 세션이 많은 머신에서 transcript 파일 경로로 세션을 resume하면 메모리 사용이 수 GB로 치솟던 문제 — 정상 수준으로 동작.
  • claude agents와 claude --bg가 binary-takeover 지원 이전에 시작된 stale daemon에서 동작하던 문제(업그레이드 후에도) — 업그레이드 후 새 daemon을 사용합니다.
  • stream-json 모드에서 stdin이 EOF 없이 닫히면 CLI가 종료되지 않고 stale 세션 마커를 남기던 hang — 정상 종료.
  • subagent_type: 'claude'인 Agent 도구가 문서화되지 않은 임시 worktree에서 실행돼 gitignored 경로 출력이 조용히 사라지던 문제 — 정상 worktree에서 실행됩니다.

백그라운드 세션

  • /btw 키보드 단축키가 백그라운드 세션에서 작업 진행 중일 때 응답하지 않던 문제 — 응답합니다.
  • 백그라운드 세션이 $CLAUDE_JOB_DIR에 temp 파일을 쓸 때 “sensitive file” 권한 프롬프트가 뜨던 문제 — 트리거되지 않습니다.
  • working directory가 삭제된 백그라운드 에이전트를 복구할 때 잘린 스택 트레이스 대신 명확한 에러 메시지 표시 — 가독성 개선.
  • EnterWorktree가 백그라운드 세션에서 즉시 사용 불가하던 문제 (ToolSearch를 먼저 호출해야 했음) — 즉시 사용 가능합니다.
  • iTerm2, Terminal.app의 cmd+k가 attached 백그라운드 세션을 repaint하지 않던 문제 — repaint됩니다.
  • Windows의 attached 백그라운드 세션에서 IME 후보창이 입력 caret 옆이 아니라 화면 하단에 뜨던 문제 — caret 옆에 정확히 위치합니다.
  • 256-color 전용 터미널에서 file diff 렌더 후 백그라운드 에이전트에 attach하면 배경색이 번지던 문제 — 정리됩니다.
  • tmux 안에서 백그라운드 세션에 attached 상태일 때 /copy와 copy-on-select가 시스템 클립보드 갱신에 조용히 실패하던 문제 — 정상 동작.
  • Remote Control 활성 상태에서 claude agents를 열고 종료하면 Code 탭에 좀비 세션 항목이 남던 문제 — 정리됩니다.
  • 백그라운드 세션의 /rename이 세션 배너를 즉시 갱신하지 않던 문제 — 즉시 갱신됩니다.

터미널과 UI

  • Claude 응답 내부의 malformed file:// 링크가 터미널에서 클릭되지 않던 문제 — 클릭 가능합니다.
  • 92열 미만 터미널에서 claude --help 출력이 줄바꿈 없이 렌더되던 문제 — 적절히 wrap됩니다.

Windows와 VS Code

  • VS Code가 Windows에서 종료될 때 Claude Code 프로세스가 깨끗하게 종료되지 않아 false “unclean exit” 리포트와 고아 MCP 서버가 발생하던 문제 — 정상 종료됩니다.

알아두면 좋은 점

  • /model 동작 반전 — 2.1.144와 반대: 2.1.144에서 /model은 현재 세션 한정으로 바뀌고 새 세션 기본값은 d였습니다. 2.1.153에서는 그 반대 — 선택이 새 세션 기본값으로 저장되고, 현재 세션 한정은 s입니다. modelPicker:setAsDefault를 커스터마이즈한 사용자는 keybindings.json에서 modelPicker:thisSessionOnly로 이름을 바꿔야 합니다.
  • 보안 패치 두 건 즉시 업데이트 권장: 커스텀 API 게이트웨이의 OAuth 자격 누수, 서브에이전트 frontmatter MCP의 관리형 정책 우회 — 모두 자격 또는 정책 경계를 침해할 수 있어 엔터프라이즈 환경은 빠르게 업그레이드하는 것이 권장됩니다.
  • skipLfs는 마켓플레이스 소스 옵션: 사용자 글로벌 설정이 아니라 github/git 마켓플레이스 소스 정의에 적용합니다. LFS 자산이 큰 리포를 마켓플레이스로 다룰 때만 효과가 있습니다.
  • macOS 권한 다이얼로그 정리: 업그레이드마다 다시 승인해야 했던 사용자는 이번 릴리스 후 한 번 더 승인하면 이후 업그레이드에서 유지됩니다.
  • 백그라운드 세션 안정성 광범위 개선: 키보드 단축키, IME, 클립보드, 좀비 세션, 디렉터리 삭제 복구 등 attached 환경에서 발생하던 다수 문제가 한꺼번에 정리됐습니다. 백그라운드 세션을 일상적으로 사용하는 워크플로는 체감 개선이 클 가능성이 있습니다.