code-review 플러그인은 열려 있는 PR을 전문 에이전트 여러 개가 병렬로 검토하고, 확신도가 낮은 지적은 걸러서 보여줍니다. gh 명령과 GitHub 저장소가 필요합니다. 내장 /code-review 명령과는 별개입니다.
동작 방식
플러그인 README에 따르면 먼저 닫힌 PR, 초안 PR, 사소하거나 자동 생성된 PR, 이미 리뷰한 PR은 건너뜁니다. 그다음 저장소의 CLAUDE.md 가이드 파일을 모으고 PR 변경을 요약합니다.
이어서 에이전트 4개를 병렬로 띄웁니다. 1번과 2번은 CLAUDE.md 준수 여부를 중복 확인하고, 3번은 변경분에서 명백한 버그를 찾고, 4번은 git blame과 이력으로 맥락상 문제를 찾습니다.
발견한 문제마다 0~100점 신뢰도를 매기고 80점 미만은 버립니다. 이전부터 있던 문제, 린터가 잡을 사소한 지적, 린트 무시 주석이 달린 코드는 오탐으로 걸러냅니다.
설치와 사용
요구 사항은 GitHub 원격이 있는 git 저장소와, 설치 및 로그인된 GitHub CLI(gh auth login)입니다. CLAUDE.md는 없어도 되지만 있으면 가이드 검사가 좋아집니다.
임계값 80과 검토 관점은 플러그인의 commands/code-review.md를 고쳐 바꿀 수 있습니다. 보안, 성능 같은 에이전트를 추가하는 방법도 README에 있습니다.
/plugin install code-review@claude-plugins-official /code-review # 결과를 터미널에 출력 /code-review --comment # 결과를 PR 댓글로 게시
내장 /code-review와 다른 점
Claude Code에는 내장 /code-review 명령(별칭 /review)도 있어 현재 diff나 PR 번호를 수준별로 리뷰합니다. 이 플러그인은 이름이 같은 별도 구성입니다. 두 방식을 같은 환경에서 섞어 쓸 때 어느 쪽이 실행되는지는 직접 확인하지 못했으니, 처음 쓸 때 출력 형식을 보고 구분하세요.
맞지 않는 경우
- 아직 PR이 없는 로컬 변경분 점검. 이 플러그인은 열린 PR이 대상입니다.
- 사람 리뷰를 대체하려는 목적. README도 결과를 사람 리뷰의 출발점으로 쓰라고 합니다.
- 아주 큰 PR. 오래 걸리니 PR을 쪼개라고 README가 권합니다.
- GitHub가 아닌 저장소(GitLab 등). 요구 사항이 GitHub 원격과 gh입니다.
실제 예시
내 PR을 올린 뒤 머지 전에 훑어볼 때
/code-review
현재 브랜치의 열린 PR을 에이전트들이 검토해 신뢰도 80점 이상인 문제만 터미널에 나열합니다. 각 항목에는 파일 위치 링크가 붙고, CLAUDE.md 규칙 위반이라면 어느 규칙인지 함께 적힙니다. 문제가 없으면 지적 없이 끝날 수 있습니다.
리뷰 결과를 팀이 보게 남기고 싶을 때
/code-review --comment
같은 검토를 하고 결과를 PR에 댓글로 올립니다. 댓글은 내 GitHub 계정으로 게시되므로, 먼저 터미널로 결과를 확인한 뒤 올리는 편이 안전합니다.
흔한 실수와 쓰지 말아야 할 때
- gh 로그인이 안 되어 있으면 PR 정보를 못 가져옵니다. gh auth status로 먼저 확인하세요.
- 초안 PR이나 이미 리뷰된 PR은 건너뜁니다. 지적이 아무것도 안 나오는 것과 건너뛴 것을 구분해서 보세요.
- 신뢰도 필터 때문에 사소하지만 진짜인 문제는 빠질 수 있습니다. 임계값을 낮추면 오탐이 늘어납니다.
- --comment는 PR에 실제로 글을 남깁니다. 잘못 올리면 되돌리려면 직접 지워야 합니다.
자주 묻는 질문
리뷰가 오래 걸립니다.
에이전트 여러 개가 돌기 때문에 큰 PR일수록 오래 걸립니다. README는 PR을 작게 나누라고 권합니다.
내 팀의 규칙으로 리뷰하게 할 수 있나요?
저장소의 CLAUDE.md에 규칙을 적으면 에이전트 1, 2번이 그 준수 여부를 확인합니다.
2026-10-30 공식 문서와 대조함. 출처: claude-plugins-official: code-review README, Claude Code 문서: Install and manage plugins. 작성 원칙