리뷰는 하는데 왜 놓칠까요 — Claude Code로 PR 자동 리뷰 붙이기
코드 리뷰가 없는 팀은 드물어요. 문제는 바쁠 때 형식적으로 변한다는 겁니다. 1,000줄짜리 PR은 끝까지 읽기 어렵고, 급하면 승인만 누르게 되죠.
그래서 AI 리뷰를 1차 방어선으로 붙입니다. 사람 리뷰를 없애는 게 아니라, 지칠 때도 빠지지 않는 검사를 하나 두는 거예요.
리뷰가 얕아지는 지점은 정해져 있어요
PR이 커질수록 지적이 줄어요. 오래 인용되는 스마트베어 연구에서는 400줄을 넘으면 리뷰 효과가 70% 아래로 떨어진다고 봅니다. AI 리뷰는 양이 늘어도 밀도가 안 떨어지고요.
붙이는 방법
① 로컬에서 돌리기 — 어느 플랜이든 됩니다. 지금 브랜치의 변경분과 커밋 안 한 것까지 봐요.
# 세션을 열지 않고 변경분 리뷰만 바로 돌려요
claude -p "/code-review"
# 확신 높은 것만 받고 싶으면 강도를 낮춰요
claude -p "/code-review low"
# 찾은 걸 그 자리에서 고치게 해요
claude -p "/code-review --fix"
# 특정 PR을 지목해서 리뷰시켜요
claude -p "/code-review 123"강도를 낮추면(low) 확신 높은 것만 나와 소음이 줄고, 올리면 넓게 훑는 대신 애매한 것도 섞여요.
② PR에 자동으로 붙이기 — 관리형 Code Review를 켜면 워크플로 파일 없이 PR마다 리뷰가 붙어요. 다만 연구 프리뷰라 Team·Enterprise 구독에서만 됩니다.
머지를 막지는 않아요
제일 걱정되는 게 "머지를 막으면 어쩌지"인데, 그렇게 동작하지 않아요. 🔴 Important(머지 전에 고칠 버그) · 🟡 Nit(사소한 것) · 🟣 Pre-existing(원래 있던 문제) 세 등급으로 표시만 합니다. 체크 결과가 늘 중립으로 끝나 브랜치 보호 규칙에도 안 걸려요.
언제 돌릴지가 곧 비용이에요
트리거는 세 가지예요. PR 만들 때 1회 / 푸시할 때마다 / 수동. 리뷰 한 건이 평균 $15–25(약 2만 1천–3만 5천 원)라 트리거 선택이 그대로 청구서가 됩니다.
처음이라면 PR 만들 때 1회로 시작하세요. PR이 많으면 수동으로 두고 중요한 것만 부르면 됩니다.
20달러 플랜이면 이렇게 하세요
관리형 Code Review는 Team·Enterprise 전용이라 개발자마다 Pro를 쓰는 팀은 못 켜요. 대신 GitHub Actions에 리뷰를 붙이면 같은 효과가 나요. 인증은 API 키를 쓰세요. 구독 토큰도 되지만 토큰 만든 한 사람의 한도를 팀 전체가 태웁니다.
이 사이트에 돌려봤어요
코드 커밋 3개(8개 파일, 29줄)에 5분 걸렸고 지적이 4개 나왔어요.
당장 고칠 건 하나였는데, 하필 어드민 헤더가 320px 화면에서 가로로 넘쳐 '로그아웃' 버튼이 잘린다는 지적이었습니다. 재보니 문서 폭이 351px. 2주 전 제가 "고쳤다"고 올린 코드가 원인이었어요. 나머지 셋은 맞지만 급하지 않거나, 중복 개수를 틀린 것이었고요.
소음이 쏟아지는 수준은 아니라 30분이면 판별할 양이었습니다.
소음은 REVIEW.md로 잡아요
붙이고 나면 진짜 문제는 지적이 쏟아지는 거예요. 루트에 REVIEW.md를 두면 리뷰 에이전트에 최우선으로 들어갑니다.
- 심각도 기준 다시 정하기 — 우리 저장소에서 뭐가 진짜 심각한지
- Nit 개수 제한 — "사소한 지적은 다섯 개까지"
- 건너뛸 곳 — 자동 생성 파일, CI가 이미 잡는 것
정리하면
사람 리뷰를 AI가 대신하는 게 아니라 놓치는 구간을 메우는 쪽이에요.
지적이 왔을 때 어떤 입력에서 깨지는지 되묻는 습관을 같이 쓰면 진짜만 골라낼 수 있어요. Claude Code 2.1.238 기준입니다.
AI 리뷰 붙여보신 분 계세요? 카톡 오픈채팅 ⚡ AI랑 코딩하는 사람들에 후기 들려주세요.