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

Claude Code 2.1.157

Claude Code 2.1.157은 `.claude/skills` 디렉터리의 플러그인을 마켓플레이스 없이 자동으로 로드하고, `claude plugin init <name>`으로 새 플러그인을 스캐폴드할 수 있게 합니다. `/plugin` 인자 자동완성, `claude agents`의 `settings.json` `agent` 필드 적용, `EnterWorktree`의 세션 중 워크트리 전환, 작업이 끝난 워크트리 자동 잠금 해제도 추가됐습니다. 그 밖에 백그라운드 세션, `--resume`, 워크트리, 모델 선택기, 터미널 렌더링, WSL 이미지 붙여넣기, VS Code/Cursor/Windsurf 통합 터미널 등 광범위한 버그가 수정됐습니다.

Claude Code
공식 발표 →

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

무엇이 바뀌었나?

Claude Code 2.1.157은 2026년 5월 29일 출시됐습니다. 이번 릴리스의 방향은 플러그인 개발과 관리 흐름을 가볍게 만드는 것입니다. .claude/skills 디렉터리에 둔 플러그인이 마켓플레이스 등록 없이 자동 로드되고, claude plugin init <name>으로 새 플러그인을 그 자리에서 스캐폴드할 수 있으며, /plugin 인자에 자동완성이 붙었습니다. claude agents 디스패치 세션이 settings.json의 agent 필드를 존중하도록 바뀌었고, EnterWorktree로 세션 중간에 다른 Claude 관리 워크트리로 전환할 수 있습니다. 그 밖에 백그라운드 세션, --resume, 모델 선택기, 터미널 렌더링, WSL 이미지 처리, IDE 통합 터미널 등 여러 영역의 버그가 수정됐습니다.

새 기능

  • .claude/skills 플러그인 자동 로드

    마켓플레이스를 등록해야 로컬 플러그인이 인식돼 빠른 시험이 번거로웠습니다. 이제 .claude/skills 디렉터리에 둔 플러그인이 자동으로 로드되므로 별도의 마켓플레이스 설정 없이 바로 활성화됩니다.

  • claude plugin init <name> 스캐폴딩

    플러그인을 새로 시작할 때 구조와 메타데이터 파일을 손으로 만들어야 했습니다. claude plugin init <name>으로 .claude/skills 안에 플러그인 골격을 한 번에 만들 수 있습니다.

  • /plugin 인자 자동완성

    서브커맨드와 설치된 플러그인 이름, 알려진 마켓플레이스의 플러그인 이름을 일일이 외워야 했습니다. /plugin 인자에 자동완성이 추가돼 서브커맨드, 설치된 플러그인, 알려진 마켓플레이스의 플러그인을 모두 제안합니다.

  • claude agents 디스패치 세션에서 agent 필드 존중

    settings.json의 agent 필드가 디스패치 세션에는 적용되지 않아 매번 수동으로 지정해야 했습니다. 이제 디스패치 세션에도 적용되며, --agent <name>으로 개별 호출에서 덮어쓸 수 있습니다.

  • EnterWorktree의 세션 중 워크트리 전환

    세션을 종료하지 않고 Claude 관리 워크트리 사이를 오갈 방법이 없었습니다. EnterWorktree로 세션 도중에 다른 Claude 관리 워크트리로 전환할 수 있습니다.

  • 워크트리 작업 종료 후 잠금 해제

    Claude이 사용한 워크트리가 잠긴 채로 남아 git worktree remove/prune으로 정리할 수 없었습니다. 에이전트가 작업을 마치면 워크트리가 잠금 해제 상태로 남아 일반적인 워크트리 정리 명령으로 처리됩니다.

  • tool_decision 텔레메트리에 tool_parameters 포함

    도구 호출 분석에 명령 인자가 빠져 디버깅에 정보가 부족했습니다. OTEL_LOG_TOOL_DETAILS=1을 설정하면 tool_decision 이벤트에 bash 명령, MCP/스킬 이름 등 tool_parameters가 포함됩니다.

  • 워크플로우 키워드 트리거 설정

    프롬프트에 “workflow”라는 단어만 들어가도 다이내믹 워크플로우가 의도와 무관하게 트리거되는 경우가 있었습니다. /config에 “Workflow keyword trigger” 설정이 추가돼 키워드 트리거 자체를 끌 수 있습니다.

주요 개선

  • 긴 대화와 재개 세션 렌더링 성능 개선

    메시지 렌더링 재계산이 반복돼 길거나 재개된 대화에서 응답이 무거워졌습니다. 중복 재계산을 제거해 성능이 개선됐습니다.

  • VS Code 계열 통합 터미널 GPU 가속 비활성화

    VS Code, Cursor, Windsurf의 통합 터미널에서 GPU 가속으로 문자가 깨져 보이는 경우가 있었습니다. /terminal-setup이 이들 환경에서 GPU 가속을 끄도록 변경됐습니다.

  • claude agents 슬래시 명령 자동완성 부분 매칭

    디스패치 입력의 자동완성이 접두 매칭만 지원해 명령 일부만 기억나면 찾기 어려웠습니다. 부분 문자열(substring) 매칭으로 바뀌어 중간 키워드만으로도 찾아집니다.

  • Feature of the Week 크레딧 알림 위치 변경

    Feature of the Week 크레딧 청구 상태가 프롬프트 위 한 줄로 표시돼 시야를 차지했습니다. 상태 영역의 알림으로 옮겨졌습니다.

  • 시작 배너 정리

    “bash commands will be sandboxed” 배너와 “/ide for …” 시작 힌트 토스트를 제거했습니다. 샌드박스 상태는 /status와 명령이 차단될 때 계속 표시됩니다.

  • 워크플로우 트리거 후 backspace 동작 변경

    워크플로우 트리거 키워드 직후 backspace를 누르면 글자만 지워졌습니다. 이제 alt+w와 동일하게 워크플로우 요청을 닫습니다.

주요 버그 수정

권한 및 샌드박스

  • 데스크톱 앱, IDE 확장, SDK에서 auto와 bypass-permissions 모드인데도 샌드박스 네트워크 권한 프롬프트가 뜨던 문제 — 수정.
  • 시작 시 managed-settings 보안 다이얼로그를 승인한 뒤 터미널이 멈추던 문제 — 수정.
  • 붙여넣기, MCP, 다이얼로그로 첨부된 처리 불가 이미지(0바이트, 손상 등)가 요청을 크래시시키던 문제 — 텍스트 자리표시자로 변환되도록 수정.

claude agents

  • 유휴 서브에이전트가 park 상태이거나 백그라운드 셸을 누수했을 때 완료 세션이 정리되지 않던 문제 — 수정.
  • 느린 “opening…” 중에 Esc를 눌러도 취소되지 않아 목록이 응답하지 않던 문제 — 수정.
  • set-clipboard on 상태의 tmux에서 copy-on-select가 시스템 클립보드까지 닿지 않던 문제(2.1.153 리그레션) — 수정.

세션 재개 및 워크트리

  • --resume이 이전 Claude Code 프로세스 종료 시 실행 중이던 백그라운드 서브에이전트를 보고하지 않던 문제 — 수정.
  • --resume 세션 선택기가 풀스크린 모드 종료 후 내용을 터미널에 남기던 문제 — 수정.
  • --worktree / --worktree --tmux가 현재 연결된 워크트리가 아니라 표준 리포 루트로 돌아가던 문제 — 수정.
  • 30일 보관 정책으로 백그라운드 에이전트 작업이 정리될 때 .claude/worktrees/ 아래 워크트리가 고아로 남던 문제 — 수정.
  • 슬립/웨이크 후 다시 붙은 백그라운드 세션이 모델에 잘못된 날짜를 알리던 문제 — 수정.

모델 선택기 및 렌더링

  • 선택된 모델이 이미 해당 패밀리의 최신인데도 /model 선택기에 “Newer version available” 힌트가 표시되던 문제 — 수정. 고정된 모델 행은 원시 ID 대신 모델 설명을 표시.
  • 풀스크린 모드에서 진행 중 메시지 텍스트에 백틱과 별표 등 마크다운 마커 원문이 그대로 보이던 문제 — 수정.
  • 터미널 UI 재그리기 후 드물게 중복 줄이 스크롤백에 남던 문제 — 수정.

IDE 통합 터미널 및 WSL

  • VS Code, Cursor, Windsurf 통합 터미널에서 우클릭 붙여넣기가 클립보드를 두 번 복제하던 문제 — 수정.
  • [WSL] alt+v 이미지 붙여넣기와 Windows 11 스크린샷 붙여넣기 문제 수정, Windows 탐색기에서 이미지를 드래그하는 동작 지원 추가.
  • [IDE] 백그라운드 서브에이전트 실행 중에 Stop을 눌러도 실제로 중단되지 않던 문제 — 수정.
  • [VS Code] Opus 4.8에서 fast mode 인디케이터가 표시되지 않던 문제 — 수정.

알아두면 좋은 점

  • 건너뛴 버전 안내 — 2.1.155는 공개 릴리스가 없고, 2.1.156은 Opus 4.8에서 thinking 블록이 변형돼 API 오류가 나던 단일 핫픽스라 별도 콘텐츠로 등록하지 않습니다.
  • .claude/skills 자동 로드와 claude plugin init의 짝 — 이제 마켓플레이스 등록 없이도 .claude/skills 디렉터리만으로 로컬 플러그인을 운영할 수 있습니다. 새 플러그인은 claude plugin init <name>으로 즉시 시작하세요.
  • 워크플로우 키워드 트리거 끄기 — 프롬프트에 “workflow”가 들어가도 다이내믹 워크플로우가 트리거되지 않게 하려면 /config의 “Workflow keyword trigger” 설정을 끄세요.
  • OTEL_LOG_TOOL_DETAILS=1은 옵트인 — tool_decision 텔레메트리에 tool_parameters(bash 명령, MCP/스킬 이름 등)를 포함시키려면 환경 변수를 명시적으로 설정해야 합니다.