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

Claude Code 2.1.143 업데이트

플러그인 의존성 강제(`claude plugin disable`/`enable`이 의존 체인을 인식), `/plugin` 마켓플레이스에 설치 전 예상 컨텍스트 비용 표시, worktree가 비현실적인 리포를 위한 `worktree.bgIsolation: "none"`, PowerShell 툴 `-ExecutionPolicy Bypass`, 백그라운드 세션 깨어남 후 모델·effort 보존, Shift+Tab 사이클에 auto 모드가 추가됐습니다. 그 외 손상된 `.credentials.json`으로 인한 시작 행, stop 훅 무한 루프, macOS Full Disk Access 폴더에서의 백그라운드 세션 권한 오류, `git worktree remove` 실패 시 `rm -rf` 폴백 등 인증·훅·세션·UI 결함이 함께 정리됐습니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.143이 2026년 5월 15일(현지 시간) 릴리스되었습니다. 플러그인 운영 측면에서는 의존성 그래프가 처음으로 강제되어 claude plugin disable은 다른 활성 플러그인이 대상에 의존하면 거부하면서 그대로 복사해 실행할 수 있는 disable 체인 힌트를 보여주고, claude plugin enable은 transitive 의존성을 함께 강제 활성합니다. /plugin 마켓플레이스 브라우즈 패널에는 turn·invocation별 예상 컨텍스트 비용 토큰 추정치가 표시되고, worktree가 비현실적인 리포에서는 worktree.bgIsolation: "none" 설정으로 백그라운드 세션이 EnterWorktree 없이 작업 사본을 직접 편집할 수 있게 되었습니다. PowerShell 툴은 -ExecutionPolicy Bypass로 호출되며(CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1로 옵트아웃), 윈도우의 Bedrock·Vertex·Foundry 사용자에게는 기본 활성됩니다(CLAUDE_CODE_USE_POWERSHELL_TOOL=0으로 옵트아웃). 그리고 아이들 상태에서 깨어난 백그라운드 세션이 사용자가 지정한 모델·effort 레벨을 그대로 유지하고, 어태치된 에이전트 세션의 Shift+Tab 사이클에 auto 모드가 포함됩니다. 동시에 손상된 .credentials.json의 비배열 scopes 값이 CLI 시작을 멈추거나 OAuth 토큰 갱신을 조용히 끊던 문제, stop 훅의 반복 블로킹이 무한 루프로 빠지던 문제, Full Disk Access를 줘도 macOS 백그라운드 잡이 ~/Documents·~/Desktop·~/Downloads에서 거절당하던 문제, worktree 정리가 rm -rf로 폴백해 gitignored·진행 중 파일을 잃던 문제처럼 운영에 직접 영향을 주는 결함이 한 차례에 해결되었습니다.

새 기능

  • 플러그인 의존성 강제 — claude plugin disable은 의존 활성 플러그인이 있으면 거부, claude plugin enable은 transitive 의존성 강제 활성

    지금까지는 어떤 플러그인이 다른 플러그인에 의존해도 의존성 그래프가 강제되지 않아, 의존되는 플러그인을 비활성화하면 의존하는 플러그인이 조용히 깨지거나, 새 플러그인을 활성화해도 그 의존성을 사용자가 직접 켜야 했습니다. 이번 릴리스에서 claude plugin disable은 다른 활성 플러그인이 대상에 의존하고 있으면 비활성화를 거부하고, 그대로 복사해 실행할 수 있는 disable 체인 힌트를 함께 보여줍니다. claude plugin enable은 transitive 의존성을 함께 강제 활성합니다.

  • /plugin 마켓플레이스 브라우즈 패널 — turn·invocation별 예상 컨텍스트 비용 토큰 추정치 표시

    플러그인을 설치하기 전에 컨텍스트 윈도우를 얼마나 차지할지 가늠하기 어려워, 무거운 플러그인을 일단 설치한 뒤 컨텍스트가 빠르게 줄어들고 나서야 체감하는 경우가 있었습니다. 이제 /plugin 마켓플레이스 브라우즈 패널이 plugin이 turn당, invocation당 예상으로 소비할 토큰 추정치를 함께 보여줘 설치 전에 비용을 사전 비교할 수 있습니다.

  • worktree.bgIsolation: "none" 설정 — 백그라운드 세션이 EnterWorktree 없이 작업 사본 직접 편집

    백그라운드 세션의 worktree 격리가 강제되어 모노레포처럼 worktree 운용이 현실적으로 어려운 리포에서는 백그라운드 잡을 운영하기가 까다로웠습니다. 이제 worktree.bgIsolation: "none" 설정으로 백그라운드 세션이 별도 worktree 없이 작업 사본을 직접 편집하도록 할 수 있어, worktree가 비현실적인 리포에서도 백그라운드 잡을 그대로 사용할 수 있습니다.

  • PowerShell 툴 — -ExecutionPolicy Bypass 통과, 윈도우 Bedrock·Vertex·Foundry 기본 활성

    PowerShell 툴이 실행 정책(execution policy) 때문에 막혀, 스크립트 실행이 의도와 달리 거절되는 경우가 있었습니다. 이번 릴리스에서 PowerShell 툴은 -ExecutionPolicy Bypass로 호출되며, 호스트 실행 정책을 그대로 따르고 싶으면 CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1을 설정하면 됩니다. 또 윈도우의 Bedrock·Vertex·Foundry 사용자에게는 PowerShell 툴이 기본 활성으로 켜지며, 끄려면 CLAUDE_CODE_USE_POWERSHELL_TOOL=0을 설정합니다.

  • 아이들 상태에서 깨어난 백그라운드 세션 — 사용자가 지정한 모델·effort 보존

    백그라운드 세션이 아이들 후 깨어나면 사용자가 지정해둔 모델·effort 레벨이 기본값으로 되돌아가, 다음 턴이 의도와 다른 구성으로 실행되는 경우가 있었습니다. 이제 세션이 아이들에서 깨어날 때 사용자가 지정한 모델과 effort 레벨을 그대로 유지합니다.

  • 어태치된 에이전트 세션 — Shift+Tab 사이클에 auto 모드 포함

    어태치된 에이전트 세션에서 Shift+Tab으로 권한 모드를 순환할 때 auto 모드가 빠져 있어, auto 모드로 전환하려면 별도 절차를 거쳐야 했습니다. 이제 Shift+Tab 사이클에 auto 모드가 포함되어 어태치된 상태에서도 같은 키 한 번으로 전환할 수 있습니다.

  • claude agents 디스패치 플래그 정착 — --add-dir/--settings/--mcp-config/--plugin-dir이 대시보드·디스패치 세션에 모두 적용

    v2.1.142에서 claude agents에 도입된 디스패치 플래그가 이번 릴리스에서 대시보드(dashboard)와 거기서 디스패치되는 백그라운드 세션 양쪽에 일관되게 적용되도록 정착했습니다. 같은 맥락에서 --permission-mode, --model, --effort, --dangerously-skip-permissions도 view에서 디스패치되는 세션의 기본값으로 설정 가능합니다.

  • /bg 플래그 보존 — --mcp-config/--settings/--add-dir/--plugin-dir/--strict-mcp-config 유지

    /bg로 세션을 백그라운드로 보낼 때 일부 CLI 플래그가 respawn 과정에서 사라져, 백그라운드 세션이 MCP 서버나 설정 컨텍스트 없이 다시 떠오르는 경우가 있었습니다. 이제 /bg가 --mcp-config, --settings, --add-dir, --plugin-dir, --strict-mcp-config을 함께 보존해 백그라운드 세션이 respawn 후에도 MCP 서버와 설정을 그대로 유지합니다.

  • /bg·←-detach — --fallback-model·--allow-dangerously-skip-permissions 보존

    /bg나 ←-detach로 백그라운드로 분기한 워커가 --fallback-model 설정을 잃어, 과부하 시 폴백 대신 하드 실패하던 문제와, --allow-dangerously-skip-permissions이 분기된 워커의 Shift+Tab 사이클에서 사라지던 문제가 있었습니다. 이제 두 옵션 모두 분기된 워커에 그대로 전달됩니다.

  • claude --bg --dangerously-skip-permissions — retire→wake 가로질러 유지

    claude --bg --dangerously-skip-permissions로 띄운 세션이 retire→wake를 가로질러 옵션을 잃던 회귀가 해소되었습니다.

주요 버그 수정

인증·OAuth

  • .credentials.json의 scopes 값이 배열이 아닌 경우 CLI 시작이 멈추거나 OAuth 토큰 갱신이 조용히 중단되던 문제 — 손상된 자격 증명 파일 형식을 견고하게 처리하도록 수정.

권한·훅

  • stop 훅이 블록을 반복하며 무한 루프에 빠지던 문제 — 이제 8회 연속 블록되면 경고와 함께 턴이 종료됩니다. 한계 값은 CLAUDE_CODE_STOP_HOOK_BLOCK_CAP으로 조정 가능.
  • claude agents --allow-dangerously-skip-permissions가 디스패치된 세션을 기본 bypass 모드로 띄우던 문제 — 이제 권한 사이클에서 사용할 수 있는 옵션으로만 노출되고 기본 모드로는 적용되지 않습니다.
  • claude agents에서 디스패치된 백그라운드 세션이 settings.json의 permissions.defaultMode를 무시하고 auto 모드로 강제되던 문제 — 이제 설정된 기본 모드를 그대로 따릅니다.

/loop·/goal

  • Claude가 반복 간 아이들 상태일 때 Esc/Ctrl+C가 대기 중인 /loop 깨우기 호출을 취소하지 못하던 문제 수정.
  • /goal 평가기가 백그라운드 셸이나 위임된 서브에이전트가 아직 동작 중일 때 발화하던 문제 수정.

환경 변수·UI 색상

  • settings.json env의 NO_COLOR·FORCE_COLOR가 Claude Code 자체 UI 색상까지 벗기던 문제 — 이제 두 변수는 서브프로세스에만 적용됩니다.

백그라운드 세션·데몬

  • 윈도우의 에이전트 뷰가 세션을 나열할 때 PowerShell 프로세스를 반복 spawn 하던 문제 수정.
  • /bg를 프롬프트 없이 실행하면 분기된 세션에 “continue”가 전송되던 문제 — 이제 분기는 입력을 기다립니다.
  • 윈도우 터미널에서 어태치된 백그라운드 세션을 스크롤할 때 stale-fragment 가 렌더되던 문제 수정.
  • 호스트 슬립 또는 macOS App Nap 이후 백그라운드 에이전트의 worker-stall 오탐(false positive) 폭주 수정.
  • 백그라운드 세션이 warm spare 의 입력에 IDE 파일 참조를 조용히 캡처해, 다음 claude agents 디스패치 프롬프트 앞에 그 참조가 따라붙던 문제 수정.
  • git worktree remove가 실패할 때 worktree 정리가 rm -rf로 폴백해 gitignored 파일이나 진행 중 파일을 잃던 문제 — rm -rf 폴백을 제거.
  • Full Disk Access가 부여돼 있어도 macOS 백그라운드 잡 세션이 ~/Documents·~/Desktop·~/Downloads 아래 파일을 읽을 때 “Operation not permitted”를 받던 문제 수정.
  • ~/.local/bin/claude 런처가 없거나 실행 권한이 없을 때 백그라운드 데몬 spawn이 실패하던 문제 — 이제 현재 실행 중인 바이너리로 폴백.

claude agents UI·윈도우

  • 윈도우 터미널과 WSL에서 claude agents의 우클릭 붙여넣기가 동작하지 않던 문제 수정.
  • 윈도우에서 응답이 스트리밍되는 동안 claude agents에서 ←를 누르면 에이전트 목록이 모든 입력에 응답하지 않게 되던 문제 수정.

플러그인

  • --agent <name>이 plugin: 접두사 없이는 플러그인이 제공한 에이전트를 찾지 못하던 문제 수정.

세션·트랜스크립트·에러

  • 에이전트 뷰에서 세션을 삭제할 때 트랜스크립트 파일이 함께 제거되지 않던 문제 수정.
  • 5xx 에러 메시지가 구성된 게이트웨이나 클라우드 제공자 이름 대신 status.claude.com을 가리키던 문제 수정.

알아두면 좋은 점

  • 플러그인 의존성 강제 도입 — 의존성을 가진 플러그인을 비활성화할 때 거부 메시지에 함께 노출되는 disable 체인 힌트를 그대로 복사해 실행하면, 의존 그래프를 한 번에 안전하게 끌 수 있습니다. 반대로 의존 플러그인을 활성화하면 transitive 의존성이 자동 활성되므로, 의존성 누락으로 인한 조용한 깨짐이 줄어듭니다.
  • PowerShell 정책 우회 기본 — CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY — 호스트 실행 정책을 반드시 따라야 하는 환경(보안 정책상 정책을 우회하면 안 되는 경우 등)에서는 CLAUDE_CODE_POWERSHELL_RESPECT_EXECUTION_POLICY=1을 설정해 옵트아웃하세요. 윈도우 Bedrock·Vertex·Foundry 사용자 기본 활성을 끄려면 CLAUDE_CODE_USE_POWERSHELL_TOOL=0을 사용합니다.
  • worktree.bgIsolation: "none" 사용 시 주의 — 백그라운드 세션이 작업 사본을 직접 편집하므로, 사용자가 같은 파일을 편집 중이면 충돌이 발생할 수 있습니다. worktree 운용이 어렵지 않은 리포에서는 기본값(격리)을 그대로 두는 편이 안전합니다.
  • stop 훅 무한 루프 보호 한계 조정 — 8회가 기본이며, 더 엄격하거나 느슨한 한계가 필요하면 CLAUDE_CODE_STOP_HOOK_BLOCK_CAP으로 조정합니다. 0으로 설정해 보호를 끄는 것은 권장되지 않습니다.
  • macOS ~/Documents·~/Desktop·~/Downloads 접근 — Full Disk Access를 부여했음에도 백그라운드 잡이 거절당하던 회귀가 해소되었습니다. 이전에 워크어라운드로 파일을 다른 경로에 옮겨두던 워크플로가 있다면 이제 원위치로 되돌릴 수 있습니다.
  • worktree 정리 안전성 — git worktree remove 실패 시 더 이상 rm -rf로 폴백하지 않으므로, 정리 단계에서 gitignored·진행 중 파일을 잃을 가능성이 사라졌습니다. 정리가 실패하면 메시지에 따라 수동 처리가 필요합니다.
  • claude agents 디스패치 구성 정착 — v2.1.142에서 도입된 디스패치 플래그가 이번 릴리스에서 대시보드와 디스패치 세션에 일관되게 적용되고, /bg와 ←-detach가 보존하는 플래그 집합도 확장되었습니다. 자동화 스크립트에서 한 줄로 백그라운드 세션 구성을 잡아 두면 respawn·wake 후에도 그 구성을 그대로 유지할 수 있습니다.