Claude Code 상세 사용법 58: /code-review와 PR 리뷰 신호 다루기 | DAKER 커뮤니티

Claude Code 상세 사용법 58: /code-review와 PR 리뷰 신호 다루기

Claude Code의 코드 리뷰는 “AI가 approve한다”가 아니라 위험 신호를 더 빨리 찾는 보조 리뷰어로 봐야 합니다. 공식 Code Review 문서 기준으로 관리형 PR 리뷰는 Team/Enterprise research preview이며, GitHub PR diff와 주변 코드 맥락을 여러 agent가 병렬 분석하고 검증한 뒤 inline comment와 check run으로 남깁니다.

Mermaid 흐름으로 보는 리뷰 루프

아래 Mermaid source처럼 신호를 받고, 사람이 판단하고, 테스트로 닫습니다.

Mermaid source:
flowchart TD
  A[PR diff] --> B[Claude review agents]
  B --> C[Verified findings]
  C --> D{Severity}
  D --> E[Important: fix before merge]
  D --> F[Nit: batch if useful]
  E --> G[Push tests and rerun]

언제 무엇을 쓰나

GitHub App 기반 Code Review는 조직 관리자가 켜는 방식입니다. PR open, push, 수동 요청 정책에 따라 실행되고, 필요하면 PR 댓글로 요청합니다.

@claude review
@claude review once

로컬에서 먼저 보고 싶다면 Claude Code 세션 안에서 /code-review를 씁니다. GitHub App 설치 전, PR을 만들기 전, 민감한 변경을 push하기 전 점검에 맞습니다.

/code-review

더 깊은 cloud multi-agent 검토가 필요하면 공식 문서의 /code-review ultra 또는 ultrareview 흐름을 따릅니다. 단, research preview와 plan/조직 제한이 있을 수 있으니 팀 정책을 먼저 확인하세요.

REVIEW.md로 잡음을 줄인다

리뷰 품질은 저장소 지침에 크게 좌우됩니다. CLAUDE.md는 일반 작업 규칙, REVIEW.md는 리뷰 우선순위를 담는 용도로 나누면 좋습니다.

# REVIEW.md
- 인증 변경은 session fixation, logout race, token expiry를 우선 확인한다.
- DB migration은 rollback path와 data backfill 계획 없이는 Important로 본다.
- 스타일 nit는 공개 API나 접근성 영향이 있을 때만 남긴다.

이 파일은 “우리 팀이 정말 막고 싶은 결함”을 Claude에게 알려주는 장치입니다. 잡다한 취향보다 장애, 보안, 회귀, 테스트 누락을 적으세요.

결과를 읽는 법

문서 기준 finding은 Important, Nit, Pre-existing 같은 severity로 분류됩니다. Important는 병합 전 고쳐야 할 가능성이 높은 버그입니다. Nit는 한 번에 정리하거나 무시할 수 있습니다. Pre-existing은 이번 PR이 만든 문제는 아니지만 별도 이슈로 남길 가치가 있습니다.

git diff --check
npm test

AI 리뷰 댓글에 바로 반박하기보다 먼저 재현합니다. 실제 실패 테스트나 코드 경로가 확인되면 patch를 만들고, 불명확하면 “왜 false positive인지”를 PR 설명에 짧게 남깁니다.

실패 모드

첫째, Code Review를 CI 대체물로 착각합니다. 타입체크와 테스트는 계속 필요합니다. 둘째, 모든 nit를 즉시 반영해 PR 범위를 키웁니다. 셋째, REVIEW.md가 너무 길어져 리뷰 기준이 흐려집니다. 넷째, 댓글만 보고 check run summary를 읽지 않습니다.

시니어 엔지니어의 결론

Claude Code, 클로드 코드 기반 코드 리뷰는 개발 생산성 도구이지만 최종 책임자는 팀입니다. 리뷰 신호를 severity로 분류하고, Important는 테스트로 닫고, noise는 REVIEW.md로 줄이세요. 그러면 AI 코딩과 바이브코딩 흐름에서도 PR 품질을 운에 맡기지 않는 LLM 개발 워크플로우가 됩니다.

참고: Anthropic Claude Code Code Review, ultrareview, commands, llms.txt 문서를 2026-06-14 Asia/Seoul 기준으로 확인했습니다.

Redirecting to Claude Code 상세 사용법 58: /code-review와 PR 리뷰 신호 다루기 | DAKER 커뮤니티...