Claude Code v2.1.290 — Mods에 거버넌스를 다는 릴리스: 관측·통제·감사가 한 세트로
287에서 연 Claude Mods의 문에 잠금장치가 달렸습니다. v2.1.290은 플러그인이 깊은 동작을 수정할 수 있게 된 만큼, 그를 관측·통제·감사하는 엔터프라이즈 장치를 한 세트로 정리한 후속 릴리스입니다.
한마디로 말하면, mod가 서버 측 tool 호출까지 볼 수 있게 하고(관측), 조직이 요구하는 승인 상한을 훅에 노출하며(통제), 게이팅 훅의 오류 처리를 검증하는(감사) — Mods 운영의 3축이 완성된 업데이트입니다.
Mods 거버넌스 — 보이게 하고, 누구 것인지 알려주고, 상한을 정한다
세 가지가 추가됐습니다. 첫째, mod의 turn.step 훅 결과에 **serverToolUses**가 담깁니다 — API가 자체적으로 실행한 tool 호출(어드바이저)을 id·이름·입력·시작·종료와 함께 보여줍니다. 둘째, 플러그인 훅의 tool.check 이벤트에 **agentId**가 실려 서브에이전트의 권한 검사와 메인 세션의 것을 구분합니다. 셋째, mod의 tool.check 훅이 읽는 질문·판정에 **ceiling**이 추가돼 조직이 요구하는 승인 상한을 명시합니다. 플러그인 validate는 게이팅 사이트에 등록된 각 훅이 .catch를 갖는지까지 나열합니다(--json의 gatingHooks). 287이 문을 열었다면 290은 누가 얼마나 열 수 있는지를 정의한 셈입니다.
Managed Agents 온보딩이 커맨드로
/claude-api managed-agents-onboard <url>과 <quickstart-name> 두 커맨드가 추가됐습니다. 전자는 "ant apply" 파일로 기술된 페이지에서 Managed Agents 패턴을 세팅하고, 후자는 deep-researcher 같은 Console 퀵스타트 템플릿을 ant CLI로 생성합니다. Managed Agents 패턴을 문서에서 손으로 따라하던 과정이 커맨드 두 줄로 줄었습니다.
관리 설정 투명성 3건 + 안정성
관리 설정 파일이 관리 폴더 밖 파일로의 링크일 때 경고가 추가됐고, 관리 설정이 사용자의 sandbox allowRead 경로나 allowed domains를 무시할 때 /status·doctor가 경고합니다. 게이트웨이 승인 페이지에는 Deny 버튼이 생겨 대기 중인 로그인을 즉시 끝낼 수 있고 — 대기 중인 터미널이 몇 초 안에 멈춥니다. claude attach <name>, claude logs <name>으로 세션 id 대신 이름 일부로 붙을 수도 있습니다.
안정성 쪽은 프록시·게이트웨이가 베타 헤더 하나를 400이 아닌 다른 상태로 거부하거나 두 번째 베타와 함께 거부할 때 요청이 실패하던 문제, 수백 장의 이미지를 담은 긴 세션이 "Request rejected as unprocessable"로 멈추던 문제, thinking 중 콘텐츠 필터가 응답을 멈출 때 즉시 종료되던 문제(1회 재시도)가 픽스됐습니다. 재개된 서브에이전트·팀메이트의 이전 thinking 유실 픽스도 이어집니다.
실전에서 어떻게 쓸까?
Mods를 배포하는 조직이라면 순서가 있습니다. ① plugin validate로 게이팅 훅의 .catch 유무를 점검, ② tool.check의 ceiling으로 조직 승인 상한 선언, ③ serverToolUses·agentId로 감사 로그 구축. Managed Agents 도입을 검토 중이라면 /claude-api managed-agents-onboard로 템플릿부터 생성해보세요. 프록시 뒤 사용자는 베타 헤더 거부 픽스를 확인할 필요가 있습니다.
마무리로 — 기능을 여는 릴리스(287) 다음에 통제를 닫는 릴리스(290)가 오는 것은 성숙의 신호입니다. Mods를 도입할지 말지 고민하는 팀이라면, 이제 도입과 통제가 같은 버전에서 가능하다는 점이 결정적 근거가 될 것입니다.
출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.290
태그: AI Claude Claude Code 개발도구