플러그인 자동 로드와 에이전트 워크트리 개선

클로드 코드 · 2.1.157 · 기능추가 · 2026.05.29

플러그인 자동 로드, 에이전트 워크트리 처리, 여러 터미널·세션 관련 오류를 함께 개선했다.

교안에 영향

`workflow`가 동적 워크플로를 트리거하던 기본 동작과 관련 안내는 `/config`의 "Workflow keyword trigger" 설정을 반영해야 한다.

요약

- `.claude/skills`의 플러그인이 마켓플레이스 없이 자동으로 로드되고, `claude plugin init <name>`와 `/plugin` 자동완성이 추가됐다. - `claude agents`가 `settings.json`의 `agent` 필드를 따르며, `EnterWorktree`와 `--worktree` 동작이 개선됐다. - 이미지 붙여넣기, 샌드박스 네트워크 권한 프롬프트, 복원·종료·스크롤백·터미널 UI 관련 여러 오류를 수정했다. - `/terminal-setup`, `/config`, `/model`, 백그라운드 세션, WSL, VS Code·Cursor·Windsurf 통합 터미널 관련 동작이 조정됐다.

바뀐 것

새 기능 3

`.claude/skills` 디렉터리의 플러그인이 이제 마켓플레이스 없이 자동으로 로드된다.
`claude plugin init <name>`로 `.claude/skills`에 새 플러그인 골격을 만들 수 있다.
`/plugin` 인자 자동완성에 하위 명령, 설치된 플러그인 이름, 알려진 마켓플레이스의 플러그인이 추가됐다.

개선 5

`claude agents`에서 `settings.json`의 `agent` 필드가 디스패치된 세션에 반영되며, `--agent <name>`으로 이를 덮어쓸 수 있다.
`EnterWorktree`가 세션 중 Claude가 관리하는 워크트리 사이를 전환할 수 있게 됐다.
Claude가 관리하는 워크트리가 에이전트 종료 후 잠금 해제되어 `git worktree remove`와 `prune`으로 정리할 수 있게 됐다.
긴 대화와 재개된 대화의 성능을 불필요한 메시지 렌더링 재계산 제거로 개선했다.
`/terminal-setup`이 VS Code, Cursor, Windsurf 통합 터미널에서 GPU 가속을 끄도록 바뀌어 글자 깨짐을 방지한다.

기타 1

`OTEL_LOG_TOOL_DETAILS=1`일 때 `tool_decision` 텔레메트리 이벤트에 `tool_parameters`(bash 명령, MCP/skill 이름)가 포함된다.

수정 16

붙여넣기, MCP, 대화창으로 들어온 처리 불가 이미지(0바이트, 손상 파일)가 요청을 크래시시키지 않고 텍스트 자리표시자로 처리되도록 수정했다.
데스크톱 앱, IDE 확장, SDK에서 auto 및 bypass-permissions 모드일 때 샌드박스 네트워크 권한 프롬프트가 뜨는 문제를 수정했다.
`claude agents`에서 유휴 보조 에이전트가 대기 중이거나 백그라운드 셸을 남긴 경우 완료 세션이 회수되지 않던 문제를 수정했다.
`claude agents`에서 Esc를 눌러 느린 "opening…" 상태를 취소해도 목록이 응답하지 않던 문제를 수정했다.
`.claude/worktrees/` 아래의 백그라운드 에이전트 워크트리가 30일 보존 스윕 후 고아가 되던 문제를 수정했다.
절전 후 재연결된 백그라운드 세션에 모델이 올바른 날짜를 알리지 않던 문제를 수정했다.
`claude agents`에서 `set-clipboard on`이 있는 tmux 안에서 선택 복사 내용이 시스템 클립보드에 전달되지 않던 회귀를 수정했다.
이전 Claude Code 프로세스가 종료될 때 실행 중이던 백그라운드 보조 에이전트를 `--resume`이 보고하지 않던 문제를 수정했다.
전체 화면 모드에서 `--resume` 세션 선택기를 종료한 뒤 내용이 터미널에 남던 문제를 수정했다.
`--worktree`와 `--worktree --tmux`가 현재 연결된 워크트리가 아니라 표준 저장소 루트로 돌아가던 문제를 수정했다.
선택한 모델이 이미 같은 계열의 최신 버전일 때 `/model` 선택기가 잘못된 "Newer version available" 안내를 보여주던 문제를 수정하고, 고정 모델 행에는 원시 ID 대신 설명을 표시하도록 바꿨다.
전체 화면 모드의 진행 중 메시지 텍스트에 백틱과 별표 같은 원시 마크다운 표식이 그대로 보이던 문제를 수정했다.
시작 시 관리형 설정 보안 대화상자를 승인한 뒤 터미널이 멈추던 문제를 수정했다.
터미널 UI가 다시 그려질 때 드물게 스크롤백에 중복 줄이 생기던 문제를 수정했다.
VS Code, Cursor, Windsurf 통합 터미널에서 우클릭 붙여넣기가 클립보드를 두 번 입력하던 문제를 수정했다.
WSL에서 이미지 붙여넣기(`alt+v` 키 바인딩), Windows 11의 스크린샷 붙여넣기 문제를 수정하고, Windows Explorer에서 이미지를 끌어다 놓을 수 있게 지원했다.