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