프로젝트 소개

claude-code-review-gate는 개발 워크플로에 AI 코드 리뷰와 차단형 사전 푸시 게이트를 통합하는 Claude Code 플러그인입니다. 이 플러그인은 Claude Code 자체의 추론 기능을 활용하므로, 리뷰는 토큰 차용이나 타사 바이너리 없이 Claude 구독으로 실행됩니다. 리뷰 방법론은 open-code-review에서 적용되었으며, 네이티브 Claude Code 스킬과 서브에이전트로 재표현되었습니다. 주요 기능은 다음과 같습니다: - `/review-gate:review` 스킬을 통해 작업 중인 diff, 스테이징된 변경 사항 또는 전체 저장소 스캔을 주문형으로 리뷰합니다. - 푸시당 한 번 모든 미푸시 커밋을 리뷰하고, 확실한 높은 심각도 발견 사항을 차단하는 차단형 푸시 게이트입니다. 선택적 전역 git 훅을 통해 모든 푸시(터미널, IDE 또는 Claude Code)를 게이트하도록 구성할 수 있습니다. - 전체 변경 세트에 대한 단일 리뷰어 서브에이전트로, 파일 간 결함 탐지를 가능하게 합니다. 큰 diff(15개 파일 초과)는 디렉토리별로 분산 처리됩니다. - 직접적인 반증이 있는 경우에만 발견 사항을 삭제하는 독립적인 반증 패스로, 오탐지를 줄입니다. - 모델 재량이 아닌 감사 가능한 코드에 기반한 결정적 판정(차단/경고/통과)을 제공합니다. - 타임아웃, 크래시, 파싱 불가 출력, Python 3 누락 또는 리뷰어를 찾을 수 없는 경우 실패 시 차단하며, `OCR_FAIL_OPEN=1`을 비상 우회로 사용합니다. 설치는 Claude Code 마켓플레이스 또는 로컬 플러그인 디렉토리를 통해 간단합니다. 구성 옵션을 통해 차단 임계값, 리뷰 모델(haiku/sonnet/opus), 타임아웃 등을 조정할 수 있습니다. 플러그인은 모든 리뷰 발견 사항을 감사 가능성을 위해 `.git/review-gate-findings.jsonl`에 기록합니다. 비용 제어는 헤드리스 리뷰 세션을 대화형 환경과 격리하여 모델을 고정하고 사용자 설정과 MCP 서버를 비활성화하여 불필요한 토큰 사용을 방지합니다. 플러그인은 Apache 2.0 라이선스로 제공되며 Alibaba 또는 Anthropic과 제휴하지 않습니다.