Claude Code v2.1.290: 플러그인 훅 튜닝, 관리형 에이전트 온보딩, 그리고 긴 세션 수정 목록

Claude Code v2.1.290이 출시되었으며, 주로 여러 플러그인 훅 API 추가와 긴 수정 목록이 포함된 유지 관리 릴리스입니다. 주요 항목은 mods와 플러그인 훅에 노출된 새로운 필드와 몇 가지 CLI 편의 기능입니다.

플러그인 및 mod 훅 변경 사항

• serverToolUses가 이제 mod의 turn.step 훅 결과에 포함됩니다. 이는 API가 자체적으로 실행한 도구 호출(어드바이저)을 나열하며, 각각 id, name, input, start, end를 포함합니다.
• 플러그인 훅의 tool.check 이벤트에 agentId가 추가되어, 훅이 서브에이전트의 권한 확인과 메인 세션의 권한 확인을 구분할 수 있습니다.
• mod의 tool.check 훅이 읽는 질문과 판정에 ceiling이 추가되어, 조직이 도구에 대해 요구하는 승인을 명시합니다.
• 플러그인 훅 타입에 ThemeKey 및 Color 타입이 추가되어, 편집기에서 mod의 드로잉이 지정할 수 있는 테마 색상을 자동 완성할 수 있습니다.

claude plugin validate가 이제 mod가 게이팅 사이트에 등록한 각 훅과 해당 훅에 .catch가 있는지 여부를 나열합니다(--json에서 gatingHooks로). 관련 수정으로, .catch가 있는 플러그인 훅이 계속 예외를 발생시킬 때 훅이 언로드되고 .catch가 건너뛰어지는 문제가 해결되었습니다.

CLI 및 온보딩 추가 사항

• claude attach <name> 및 claude logs <name>이 이제 전체 id 대신 세션 이름의 일부를 허용합니다.
• /claude-api managed-agents-onboard <url>은 페이지에서 ant apply 파일로 설명하는 Managed Agents 패턴을 설정합니다.
• /claude-api managed-agents-onboard <quickstart-name>은 ant CLI를 사용하여 Console 퀵스타트 템플릿(예: deep-researcher)을 빌드합니다.
• Claude 앱 게이트웨이의 로그인 승인 페이지에 거부 버튼이 추가되었습니다. 대기 중인 터미널이 몇 초 내에 중지됩니다.

두 가지 새로운 경고: 관리 설정 파일이 관리 설정 폴더 외부의 파일에 대한 심볼릭 링크인 경우, 그리고 관리 설정이 사용자가 구성한 샌드박스 allowRead 경로 또는 허용된 도메인을 무시하는 경우 /status 및 doctor에서 경고합니다.

주목할 만한 수정 사항

• 베타 헤더를 400이 아닌 상태로 거부하거나 두 번째 베타와 함께 거부하는 프록시 및 게이트웨이 뒤의 요청이 이제 성공합니다.
• 수백 개의 이미지가 포함된 긴 세션이 더 이상 "Request rejected as unprocessable by the model" 오류로 멈추지 않습니다.
• Claude가 아직 생각 중일 때 API의 출력 콘텐츠 필터가 응답을 중단하면, 오류가 표시되기 전에 요청이 한 번 재시도됩니다.
• 재개된 서브에이전트/팀원이 실행 중 메시지를 받은 후 이전 사고 및 프롬프트 캐시를 잃지 않습니다.
• WebFetch가 더 이상 100,000자를 초과하는 텍스트를 조용히 삭제하지 않습니다. 읽지 않은 양을 보고하고 offset을 허용합니다.
• 예약 작업(간격이 있는 /loop, 알림)이 이 버전부터 재개 시 압축 후에도 유지되며, 포그라운드 예약 작업이 ← 또는 /background 핸드오프 후에 실행됩니다.
• 헤드리스 --json-schema 실행이 구조화된 출력이 전달된 후 연결이 끊어져도 is_error: true와 함께 비정상 종료되지 않습니다.
• Plan 모드가 더 이상 서버 푸시 ask 정책으로 자동 모드 분류기가 읽기 전용이 아닌 커넥터 도구를 승인하도록 허용하지 않습니다.
• 작업 디렉터리 외부에 심볼릭 링크된 프로젝트 CLAUDE.md, 규칙 또는 AGENTS.md가 permissions.blockReadsOutsideWorkingDirectories 또는 Read 거부 규칙下에서 더 이상 로드되지 않습니다.
• Windows에서 /ultrareview가 git stash create 실패 시 경고 없이 커밋되지 않은 변경 사항을 삭제하지 않습니다.
• 백그라운드 데몬의 로그가 claude daemon run / claude daemon logs에서 터미널 제어 문자를 화면에 전달하지 않으며, \uXXXX 이스케이프로 표시됩니다.

CI 또는 회사 프록시 뒤에서 Claude Code를 실행하는 경우, 베타 헤더 수정과 관리 설정 경고가 가장 중요할 것입니다.