Claude Code v2.1.289: 권한 규칙 우회 수정과 플러그인 안정화

v2.1.289는 기능 추가보다 권한 규칙이 새는 경로를 막는 수정이 많은 릴리스입니다. 여기에 플러그인 화면 표시와 검증 도구의 오류 수정, 에이전트 관련 API 확장이 더해졌습니다.

핵심 요약
  • Bash deny·ask 규칙이 `TZ="$HOME" rm -rf build`처럼 환경 변수 접두어나 단독 변수 할당 뒤의 명령을 놓치던 문제 2건을 수정했습니다.
  • `Read` deny 규칙이 심볼릭 링크를 거친 IDE의 @ 멘션·변경·선택 파일에도 적용됩니다.
  • `agent.spawn`이 teammate용으로 추가됐고, 플러그인 훅 이벤트 전반에서 에이전트 ID가 하나로 통일됐습니다.
  • 짧은 코드 블록의 `<script>` 태그나 중첩 `${` 치환 때문에 터미널이 멈추던 문제를 고쳤습니다.
목차
  1. 릴리스 노트 전체
  2. 새로 쓸 수 있게 된 기능
  3. 업데이트하고 버전 확인하기

릴리스 노트 전체

공식 릴리스 노트의 27개 항목을 원문 순서대로 한 줄씩 옮겼습니다. 더하거나 뺀 항목은 없습니다.

  1. 관리형 머신에서 복합 셸 명령의 중첩된 부분에 적용한 deny 또는 ask 규칙이 사용자가 설치한 mod의 승인보다 우선하지 않던 문제를 고쳤습니다
  2. 닫히지 않은 `<script>` 태그가 많거나 `${` 치환이 깊게 중첩된 짧은 코드 블록에서 터미널이 멈추던 문제를 고쳤습니다
  3. 심볼릭 링크를 통해 IDE에서 @ 멘션, 변경 또는 선택한 파일에 `Read` deny 규칙이 적용되지 않던 문제를 고쳤습니다
  4. [VSCode] 로그아웃이 더 자주 발생하게 했을 수 있는 `claude auth status`의 2.1.288 변경을 되돌렸습니다
  5. 강조 표시된 뷰를 최종 너비로 한 번만 배치하도록 하여 플러그인 코드 창에서 큰 파일이 열리는 속도를 개선했습니다
  6. `plugin list`, `plugin eval`, `plugin update`가 로컬 폴더 마켓플레이스에서 설치한 플러그인의 오래된 사본을 보여주던 문제와 심볼릭 링크된 `--plugin-dir`의 핫 리로드 문제를 고쳤습니다
  7. 업그레이드 후 첫 세션에서 설치된 mod가 로드되지 않던 문제를 고쳤습니다
  8. 전체 화면에서 Background tasks 대화상자가 열려 있는 동안 프롬프트 위의 플러그인 행에 오래된 행이 표시되던 문제를 고쳤습니다
  9. 링크가 localhost 주소, 경로의 `@`, 대문자 호스트 또는 `file:` 경로를 사용할 때 플러그인 창이 아무것도 그리지 않던 문제를 고쳤습니다
  10. 사용자가 설치한 플러그인이 조직 관리형 MCP 서버의 로그인 도구 설명을 다시 쓸 수 있던 문제를 고쳤습니다
  11. 플러그인이 터미널에서 알 수 없는 테두리 스타일로 Box를 그릴 때 시작 시 멈추거나 강제 종료되던 문제를 고쳤습니다
  12. 플러그인의 화면 표시 핸들러가 비동기적으로 예외를 던질 때 감독형 및 백그라운드 세션이 종료되던 문제를 고쳤습니다
  13. 높이가 없는 플러그인 영역이 계속 커질 때 세션이 인터페이스 오류로 종료되던 문제를 고쳤습니다
  14. 샌드박스가 명령을 자동 허용할 때, 확장된 값을 가진 환경 변수 접두사(예: `TZ="$HOME" rm -rf build`) 뒤의 명령을 Bash deny 및 ask 규칙이 놓치던 문제를 고쳤습니다
  15. 명령 앞에 단독 변수 할당이 있을 때 샌드박스 자동 허용에서 Bash deny 또는 ask 규칙이 건너뛰어지던 문제를 고쳤습니다
  16. 폴더에 마켓플레이스 매니페스트도 있을 때 `claude plugin validate`가 플러그인을 건너뛰던 문제를 고쳤습니다
  17. 팀원용 `agent.spawn`, 플러그인 훅 이벤트 전반에서 통일된 하나의 에이전트 ID, `$.agent.list()`의 유휴 및 대기 상태를 추가했습니다
  18. mod의 `ui.render` 훅이 쓴 값 때문에 행을 그리는 중 예외가 발생하면 세션이 "unrecoverable interface error"로 종료되던 문제를 고쳤습니다. 이제 엔진이 대신 자체 행을 그립니다
  19. 탭, 불필요한 이스케이프, C1 제어 문자가 있는 텍스트나 탭과 CRLF 줄바꿈이 있는 짧은 텍스트가 아래 행 위에 겹쳐 그려지던 문제를 고쳤습니다
  20. mod의 창이나 밴드에서 오른쪽 정렬된 내용이 닫기 표시 또는 `[-]` 아래에 그려지던 문제를 고쳤습니다. 이제 이들도 터미널 가장자리에서 한 칸 안쪽에 위치합니다
  21. 그려지는 도중 실패한 mod의 `Client`가 mod가 주변에 그린 모든 것을 함께 무너뜨리던 문제를 고쳤습니다. 이제 해당 `Client`만 실패하고 `ui.fault`를 발생시킵니다
  22. `claude plugin validate`가 Anthropic 마켓플레이스 자체의 플러그인을 실패 처리하고 `--json`에서 정상적인 `plugin.json`을 오류로 나열하던 문제를 고쳤습니다
  23. 그리기에 실패한 mod의 밴드가 그 아래 카드들에게 잠시 비켜 달라고 알리던 문제를 고쳤습니다
  24. 실패한 플러그인 구성 요소에 메시지가 없을 때 사유로 `Error`만 표시되거나 아무것도 표시되지 않던 문제를 고쳤습니다
  25. mod의 밴드나 창이 그리기에 실패했을 때 mod 작성자가 보는 줄을 개선했습니다. 이제 mod 이름을 밝히고 아무것도 그려지지 않았다고 알려줍니다
  26. 닫히지 않은 `<script>` 태그가 많은 짧은 코드 블록에서 게시된 아티팩트 페이지가 독자의 브라우저 탭을 멈추거나 충돌시키던 문제를 고쳤습니다
  27. 터미널이 그리는 중 예외를 던진 후 mod의 Client 영역이 세션 내내 실패 상태로 남던 문제를 고쳤습니다

▲ 맨 위로

새로 쓸 수 있게 된 기능

이번 업데이트로 새로 쓸 수 있게 된 기능은 9가지입니다. 근거 항목은 위 릴리스 노트의 번호입니다.

기능달라진 점근거 항목
Bash 규칙 우회 2건 수정샌드박스 자동 허용 상태에서 `TZ="$HOME" rm -rf build`처럼 확장 값을 가진 환경 변수 접두어 뒤의 명령, 또는 단독 변수 할당 뒤의 명령이 deny·ask 규칙에서 빠지던 문제가 해결됐습니다.14번, 15번
복합 셸 명령의 규칙 유지관리형 머신에서 복합 명령의 일부에 걸린 deny·ask 규칙이, 사용자가 설치한 mod의 승인보다 우선하도록 고쳐졌습니다.1번
심볼릭 링크 경유 파일의 Read denyIDE에서 @ 멘션하거나 변경·선택한 파일이 심볼릭 링크를 통해 열려도 `Read` deny 규칙이 적용됩니다.3번
에이전트 API 확장teammate용 `agent.spawn`이 추가됐습니다. 플러그인 훅 이벤트 전체에서 에이전트 ID가 하나로 쓰이고, `$.agent.list()`에 idle과 waiting 상태가 표시됩니다.17번
플러그인 validate 정상화`claude plugin validate`가 마켓플레이스 매니페스트가 함께 있는 폴더의 플러그인을 건너뛰던 문제와, Anthropic 마켓플레이스 자체 플러그인을 실패 처리하고 `--json`에 정상 `plugin.json`을 오류로 나열하던 문제가 수정됐습니다.16번, 22번
로컬 플러그인 갱신 반영로컬 폴더 마켓플레이스에서 설치한 플러그인이 `plugin list`, `plugin eval`, `plugin update`에서 오래된 사본으로 보이던 문제와 심볼릭 링크된 `--plugin-dir`의 핫 리로드가 고쳐졌습니다.6번
조직 관리 MCP 서버 보호사용자가 설치한 플러그인이 조직 관리 MCP 서버의 로그인 도구 설명을 바꿀 수 있던 문제가 막혔습니다.10번
터미널 멈춤 수정닫히지 않은 `<script>` 태그가 많거나 `${` 치환이 깊게 중첩된 짧은 코드 블록에서 터미널이 멈추던 문제가 고쳐졌습니다. 게시된 아티팩트 페이지에서 브라우저 탭이 멈추거나 죽던 같은 증상도 수정됐습니다.2번, 26번
mod 화면 오류 격리mod의 `Client`가 그리는 중 실패해도 주변에 그린 내용이 함께 무너지지 않고 단독으로 실패하며 `ui.fault`를 냅니다. 실패 메시지도 mod 이름과 아무것도 그리지 못했다는 내용을 담도록 개선됐습니다.21번, 25번

▲ 맨 위로

업데이트하고 버전 확인하기

이 글의 변경을 모두 쓰려면 Claude Code 2.1.289 이상이 필요합니다. 터미널에서 claude update로 새 버전을 받고, claude --version으로 2.1.289 이상인지 확인합니다.

claude update
claude --version

▲ 맨 위로

글쓴이 MinoSui · 블로그 운영자·편집 책임

편집 방침. 오류 제보는 문의로 받습니다. 글쓴이·블로그 소개

#IT·AI#클로드AI#ClaudeCode

작성일 2026-10-05 00:17

소개 · 문의 · 개인정보처리방침 · 면책 안내 · 저작권 안내 · AI, IT 글 모음

© 2026 MinoSui. 이 글의 무단 전재·재배포를 금합니다. 원문: https://minoss0918.blogspot.com/

댓글

이 블로그의 인기 게시물

트럼프 AI 속도조절론 거부와 글로벌 빅테크 및 한국 IT의 파장

KT 모두의 AI 서비스 추진 일정과 일상 속 핵심 기능 총정리

스타크래프트 AI 플루토 김성현 대결 전략 분석 및 최신 AI 기술

아이티센클로잇 AI 에이전트, 폐쇄망 연동 필수 보안 기준과 활용법

난폭운전 보복운전 기준 차이와 스마트폰 영상 신고 정리

초보 귀농인을 위한 농작물 병해충 진단 앱 설치 및 스마트팜 활용 가이드

카카오 카나나 상담매니저 도입 및 고객 응대 효율화 방법

백화점 3사 정기 휴무일 확인법과 정기 세일 공략 팁

마인크래프트 코블몬 모드 전설 포켓몬 스폰 설정 및 소환 알아둘 점

그록 AI 반도체 설계 원리와 GPU 대비 성능 벤치마크