9월 17일 하루에 v2.1.274 와 v2.1.275 가 잇달아 나왔는데, 2.1.275 는 npm 소스 플러그인을 npm install 대신 npm pack --ignore-scripts 로 받아 무결성을 검증하도록 바꿔 패키지 자체의 preinstall·postinstall 이 더는 실행되지 않아요. 공식 플러그인 참조 문서는 아직 「npm 소스 플러그인을 가져올 때는 라이프사이클 스크립트를 켠 채 npm install 을 돌린다」고 적혀 있어 문서가 한 판 뒤처져 있고, 같은 판에서 /update-config 가 파일 권한 검사에 걸리지 않는 Write(path) 규칙을 써 넣던 문제를 Edit(path) 로 고쳤으며, claude.ai 계정에서 켠 스킬·플러그인이 터미널 세션으로 동기화되는 것은 syncClaudeAiSkills·syncClaudeAiPlugins 를 false 로 끌 수 있다고 적혔어요(공식 문서는 이 동기화가 2.1.273 부터라고 적고 있어 도입 시점이 서로 달라요). 앞선 2.1.274 는 특수 셸 변수를 반복·대입하는 명령이 권한을 묻지 않던 구멍과 워크트리 격리 세션이 중첩 셸 확장을 받아 주던 구멍을 막았고, .mcp.json·설정·플러그인의 "type": "sdk" MCP 항목은 경고와 함께 건너뛰며, 베드록·버텍스·파운드리 설치도 v2 MCP 클라이언트와 2026-07-28 프로토콜 협상을 기본으로 쓰게 됐어요(MCP_SDK_GENERATION=v1 로 되돌릴 수 있어요).
- npm
- 자바스크립트 패키지를 설치·배포하는 관리 도구
- preinstall·postinstall
- npm 패키지를 설치하기 전후에 자동으로 실행되는 스크립트
- MCP
- 에이전트가 외부 도구·데이터에 연결되는 표준 프로토콜(Model Context Protocol)
- 워크트리
- git 저장소 하나를 여러 작업 폴더로 나눠 체크아웃한 것
npm 소스로 사내 플러그인을 배포하던 팀은 지금까지 플러그인 패키지의 설치 스크립트가 사용자 기계에서 그대로 실행됐다는 뜻이니, 네이티브 빌드나 설정 생성을 postinstall 에 기대던 플러그인은 2.1.275 이후 훅에서 직접 처리하도록 옮기고, 베드록·버텍스 환경에서 직접 HTTP MCP 서버를 쓰는 조직은 업데이트 뒤 연결이 깨지면 MCP_SDK_GENERATION=v1 로 되돌려 원인을 확인하세요.
- 앞선 판 2.1.274 같은 날 먼저 나온 2.1.274 는 특수 셸 변수 반복·대입 명령의 권한 확인 누락과 워크트리 격리 세션의 중첩 셸 확장 허용을 막고, "type": "sdk" MCP 항목을 건너뛰며, 베드록·버텍스·파운드리를 v2 MCP 클라이언트 기본으로 바꿨어요. GitHub
- 공식 문서 미반영 플러그인 참조 문서는 의존성 설치는 --ignore-scripts 로 돌리지만 「npm 소스 플러그인 자체를 가져올 때는 라이프사이클 스크립트를 켠 채 npm install 을 돌린다」고 아직 적혀 있어요. Claude Code Docs
- 동기화 도입 시점 어긋남 스킬 문서는 claude.ai 계정 스킬의 터미널 동기화가 2.1.273 부터라고 적고, ~/.claude/skills/synced/ 로 내려받아 10분마다 확인하며 syncClaudeAiSkills: false 로 끄면 이미 받은 것은 .trash 로 옮긴다고 설명해요. Claude Code Docs