Claude Code v2.1.85, 조건부 훅과 MCP 개선

Claude Code v2.1.85가 릴리스되었습니다. 이번 업데이트는 훅 시스템과 MCP 통합 측면에서 꽤 의미 있는 개선들이 포함되었습니다.

한마디로 요약하면

조건부 훅으로 불필요한 프로세스 실행을 줄이고, MCP OAuth가 표준을 따르며, 딥링크가 5,000자까지 지원됩니다. 헤드리스 통합을 위한 PreToolUse 훅 개선도 눈여겨볼 만합니다.

핵심 변화

조건부 훅 (Conditional Hooks)

이제 훅에 if 필드를 사용해 실행 조건을 지정할 수 있습니다. 예를 들어 Bash(git *)처럼 작성하면 git 명령어를 실행할 때만 훅이 작동합니다. 불필요한 프로세스 실행을 줄여 성능이 개선되고, 훅 로직도 더 깔끔하게 관리할 수 있습니다.

MCP OAuth 표준 준수

MCP OAuth가 RFC 9728 Protected Resource Metadata Discovery를 따르도록 개선되었습니다. 이제 인증 서버를 자동으로 찾을 수 있어 연동 과정이 더 매끄러워졌습니다. 또한 CLAUDE_CODE_MCP_SERVER_NAME과 CLAUDE_CODE_MCP_SERVER_URL 환경 변수가 추가되어 하나의 헬퍼로 여러 MCP 서버를 운영할 수 있습니다.

딥링크 확장

claude-cli://open?q=… 딥링크가 최대 5,000자까지 지원합니다. 긴 프롬프트를 미리 채워서 전달할 수 있어, 복잡한 작업을 링크 하나로 시작하는 게 가능해졌습니다. 다만 긴 프롬프트에는 "스크롤해서 확인하라"는 경고가 표시됩니다.

실용 활용

헤드리스 통합

PreToolUse 훅이 이제 AskUserQuestion을 처리할 수 있습니다. updatedInput과 permissionDecision: "allow"를 함께 반환하면, 사용자 입력을 자체 UI에서 수집한 뒤 Claude Code에 전달하는 방식이 가능합니다. CI/CD 파이프라인이나 커스텀 인터페이스에서 Claude Code를 활용하기 좋아졌습니다.

엔터프라이즈 정책 관리

managed-settings.json으로 차단된 플러그인은 이제 설치나 활성화 자체가 불가능하며, 마켓플레이스에서도 숨겨집니다. 조직 차원의 보안 정책을 더 확실하게 적용할 수 있습니다.

마무리

버그 수정도 많지만, 조건부 훅과 PreToolUse 개선은 특히 자동화 파이워크플로우를 짜는 분들에게 반가운 소식입니다. MCP 서버를 여러 개 운영 중이라면 환경 변수 활용도 한번 살펴보세요.

태그: AI, Claude, Claude Code, 개발도구

출처: https://github.com/anthropics/claude-code/releases/tag/v2.1.85