Claude Code 2.1.289

무엇이 바뀌었나?

Claude Code 2.1.289가 2026년 10월 3일 출시됐습니다. 수정의 중심은 두 가지입니다. 첫째, 거부(deny)나 확인(ask) 권한 규칙이 특정 명령 형태나 심볼릭 링크를 거치면 적용되지 않던 경로를 막았습니다. 둘째, 플러그인과 mod의 화면 요소 하나가 그리다 실패하면 세션 전체가 “unrecoverable interface error”로 끝나던 문제를 고쳐, 이제 실패한 요소만 따로 처리됩니다. VS Code 확장에서는 2.1.288의 claude auth status 변경이 되돌려졌습니다.

새 기능

에이전트 관련 API 추가

플러그인 훅 이벤트에서 같은 에이전트를 하나의 id로 따라가기 어려웠습니다. 이제 플러그인 훅 이벤트 전체에서 에이전트 id 하나를 공유하고, 팀원(teammate)을 실행하는 agent.spawn이 추가됐습니다. $.agent.list()는 에이전트의 유휴(idle), 대기(waiting) 상태도 함께 돌려줍니다.

주요 개선

플러그인 코드 창에서 큰 파일 열기 속도

플러그인 코드 창에서 큰 파일을 열면 표시되기까지 오래 걸렸습니다. 이제 구문 강조된 화면을 최종 너비 기준으로 한 번만 배치해 더 빨리 열립니다.
mod 작성자에게 보이는 그리기 실패 안내

mod의 band나 pane이 그리기에 실패했을 때 표시되는 줄만으로는 어느 mod가 문제인지 알기 어려웠습니다. 이제 해당 mod의 이름을 밝히고, 아무것도 그려지지 않았다고 알려 줍니다.

동작이 바뀐 항목

[VSCode] claude auth status 변경 되돌림 (변경)

2.1.288에서 바뀐 claude auth status 동작이 로그아웃을 더 자주 일으켰을 수 있어, 이전 동작으로 되돌렸습니다.

주요 버그 수정

권한과 보안

관리형 머신에서 사용자가 설치한 mod의 승인이, 복합 셸 명령 안쪽 일부에 걸린 거부나 확인 규칙보다 우선하던 문제 수정. 이제 중첩된 명령 부분의 규칙도 그대로 유지됩니다.
심볼릭 링크를 거쳐 @-멘션하거나, 변경하거나, IDE에서 선택한 파일에 Read 거부 규칙이 적용되지 않던 문제 수정.
샌드박스 자동 허용 상태에서, 값이 확장되는 환경 변수 접두사가 붙은 명령(예: TZ="$HOME" rm -rf build)을 Bash 거부, 확인 규칙이 놓치던 문제 수정.
샌드박스 자동 허용 상태에서, 명령 앞에 변수 대입만 있는 경우 Bash 거부, 확인 규칙을 건너뛰던 문제 수정.
사용자가 설치한 플러그인이 조직에서 관리하는 MCP 서버의 로그인 도구 설명을 바꿔 쓸 수 있던 문제 수정.

터미널 렌더링

닫히지 않은 <script> 태그가 많거나 ${ 치환이 깊게 중첩된 짧은 코드 블록에서 터미널이 멈추던 문제 수정.
같은 형태의 짧은 코드 블록 때문에, 게시된 아티팩트 페이지가 읽는 사람의 브라우저 탭을 멈추게 하거나 중단시키던 문제 수정.
탭, 짝 없는 이스케이프 문자, C1 제어 문자가 섞인 텍스트나, 탭과 CRLF 줄바꿈이 있는 짧은 텍스트가 아래 행을 덮어 그리던 문제 수정.

플러그인 설치와 관리

로컬 폴더 마켓플레이스에서 설치한 플러그인에 대해 plugin list, plugin eval, plugin update가 예전 사본을 보여 주던 문제 수정. 심볼릭 링크로 지정한 --plugin-dir의 핫 리로드(hot reload)도 고쳐졌습니다.
업그레이드 직후 첫 세션에서 설치한 mod가 불러와지지 않던 문제 수정.
폴더에 마켓플레이스 매니페스트가 함께 있으면 claude plugin validate가 플러그인 검사를 건너뛰던 문제 수정.
claude plugin validate가 Anthropic 마켓플레이스 자체 플러그인을 실패로 판정하고, --json 출력에 문제없는 plugin.json을 목록에 올리던 문제 수정.
실패한 플러그인 구성 요소에 메시지가 없으면 실패 이유가 Error로만 나오거나 아무것도 표시되지 않던 문제 수정.

플러그인과 mod 화면

mod의 ui.render 훅이 쓴 값 때문에 행을 그리다 예외가 나면 세션이 “unrecoverable interface error”로 끝나던 문제 수정. 이제 엔진이 그 행을 직접 그립니다.
mod의 Client가 그리는 도중 실패하면 그 mod가 주변에 그린 요소까지 모두 사라지던 문제 수정. 이제 해당 Client만 실패하고 ui.fault가 발생합니다.
터미널이 그리는 도중 예외를 내면 mod의 Client 영역이 세션 내내 실패 상태로 남던 문제 수정.
높이가 0인 플러그인 영역이 계속 커지면 세션이 인터페이스 오류로 끝나던 문제 수정.
플러그인의 화면 이벤트 처리기(handler)가 비동기로 예외를 던지면 감독(supervised) 세션과 백그라운드 세션이 끝나던 문제 수정.
플러그인이 터미널에서 지원하지 않는 테두리 스타일의 Box를 그리면 실행 시 멈추거나 강제 종료되던 문제 수정.
링크가 localhost 주소, 경로 안의 @, 대문자 호스트, file: 경로를 쓰면 플러그인 창에 아무것도 그려지지 않던 문제 수정.
전체 화면에서 백그라운드 작업(Background tasks) 창이 열려 있는 동안 프롬프트 위 플러그인 행이 예전 내용을 보여 주던 문제 수정.
mod의 pane이나 band에서 오른쪽 정렬된 내용이 닫기 표시나 [-] 아래에 겹쳐 그려지던 문제 수정. 이 표시들도 이제 터미널 가장자리에서 한 칸 안쪽에 놓입니다.
그리기에 실패한 mod의 band가 잠깐 동안 아래 카드들에 자리를 비키라는 신호를 보내던 문제 수정.

알아두면 좋은 점

관리형 머신에서 권한 규칙을 운영한다면 이번 버전으로 올리는 것이 좋습니다. 복합 셸 명령, 심볼릭 링크, 환경 변수 접두사, 변수 대입을 거쳐 거부, 확인 규칙이 적용되지 않던 경로가 이번에 막혔습니다.
VS Code에서 2.1.288 이후 로그아웃이 잦았다면 이번 버전에서 해당 claude auth status 변경이 되돌려졌습니다.
로컬 폴더 마켓플레이스나 --plugin-dir로 플러그인을 개발 중이라면 plugin list, plugin update가 이제 최신 사본을 보여 주고, 심볼릭 링크 경로에서도 핫 리로드가 동작합니다.
플러그인이나 mod 작성자라면 Client가 그리기에 실패할 때 발생하는 ui.fault와, 팀원용 agent.spawn, $.agent.list()의 새 상태 값을 확인해 두면 좋습니다.