코드 리뷰
AI 에이전트의 코드 작성 속도에 맞춰 버그 발견
Claude가 PR을 자동으로 검토하고, 발견된 문제를 검증한 다음, 심각도 순으로 정렬된 코멘트를 게시하므로 버그가 프로덕션 환경에 반영되기 전에 찾아낼 수 있습니다.
GitHub에 리포지토리가 있는 Claude Team 및 Enterprise Plan에서 사용할 수 있습니다. 플랜 비교하기.
코딩 에이전트 덕분에 팀은 리뷰어가 꼼꼼하게 검토할 수 있는 양보다 더 많은 코드를 작성하게 되었습니다. 풀 리퀘스트가 계속 쌓이면 간단한 검토만으로는 경쟁 상태나 보안 취약점 등의 문제를 놓칠 수 있습니다. Code Review는 변경된 코드를 먼저 꼼꼼히 검토하여, 병합되기 전에 이러한 문제를 발견하도록 돕습니다.
변경된 코드 외부의 버그까지 발견
Code Review는 변경된 부분과 그 주변 코드를 함께 검토하여, 풀 리퀘스트가 직접 유발하지는 않았지만 그로 인해 드러난 버그까지 발견하도록 돕습니다.
발견된 문제를 게시하기 전에 검증
Claude는 발견한 버그를 게시하기 전에 실제 코드를 바탕으로 검증하여, 리뷰어가 시간을 투자할 만한 문제를 확인할 수 있도록 합니다.
사소한 지적보다 버그를 우선 처리
발견된 문제는 심각도에 따라 우선순위가 정해지고, Important, Nit, Pre-existing 태그로 구분됩니다. 따라서 심각한 문제부터 확인하고 조치할 수 있습니다.
발견된 문제를 인라인 댓글로 게시
발견된 문제는 요약과 함께 인라인 댓글로 공유됩니다. 푸시할 때마다 리뷰가 실행되며, 문제를 수정하면 해당 댓글이 해결됨으로 표시됩니다.
프로덕션 환경에 영향을 미치는 버그에 집중
기본적으로 리뷰는 프로덕션 환경에 장애를 일으킬 수 있는 버그를 탐지합니다. 팀에서 REVIEW.md를 통해 어떤 문제를 표시할지 변경할 수 있습니다.
코드 변경 후 기억이 생생할 때 검토 결과 확인
대부분의 리뷰는 6~10분 안에 완료되므로, 리뷰어가 풀 리퀘스트를 열 때쯤이면 이미 검토 결과가 준비되어 있습니다.
터미널에서 리뷰 실행
관리자가 아니거나 아직 Team 또는 Enterprise Plan을 사용하지 않더라도, 직접 리뷰를 실행할 수 있습니다. Ultrareview는 Claude Code에서 /code-review ultra 명령어를 사용해 실행하는 심층 리뷰 기능으로, 브랜치나 github.com 풀 리퀘스트를 검토할 수 있습니다. 리뷰어 에이전트는 사용자가 코딩을 이어가는 동안 클라우드 샌드박스에서 버그를 찾으며, 발견된 문제는 검증한 후 사용자에게 보여 줍니다. Ultrareview는 현재 리서치 프리뷰 단계이며, 유료 실행을 위해서는 사용량 크레딧을 활성화해야 합니다.
팀에서 리뷰 규칙을 직접 설정하며, 코드 병합 여부도 결정합니다.
리뷰 실행 시점 설정
풀 리퀘스트 생성 시, 코드를 푸시할 때마다, 또는 요청이 있을 때만 리뷰가 실행되도록 설정할 수 있습니다. 새 리포지토리는 기본적으로 코드를 푸시할 때마다 리뷰를 실행합니다.
리포지토리와 리뷰 수준 선택
리뷰할 리포지토리를 선택합니다. 모든 리포지토리는 Standard 수준으로 시작하지만, 필요에 따라 리뷰 수준을 설정할 수도 있습니다. 일반적인 코드에는 Quick을, 중요한 코드에는 Deep을 선택하세요.
댓글로 리뷰 요청
쓰기 권한이 있는 사용자라면 누구나 풀 리퀘스트에 @claude review를 댓글로 남겨 리뷰를 시작할 수 있습니다. 초안과 포크도 지원합니다.
Anthropic은 Claude의 코드 작성 속도에 맞춰 코드 리뷰를 실행할 수 있도록 Code Review를 개발했습니다. 수개월 동안 매일 사용하면서 Code Review는 이제 더 많은 코드를 폭넓게 검토하면서 품질까지 개선하는 데 활용하는 도구 중 하나가 되었습니다. 각 코드 변경 사항에 대한 1차 검토는 Code Review에 맡기고, 리뷰어는 위험도가 가장 높은 코드에 집중하도록 하는 것을 권장합니다. 다음은 2026년 Anthropic의 자체 리포지토리에서 수집한 수치입니다.
하루 30,000건 이상의 코드 변경 사항 병합
9월 기준으로, Anthropic 개발자들이 Claude를 활용해 작성하는 코드가 늘어나면서, 하루 병합 건수가 5월의 약 2,500건에서 증가했습니다.
54%의 풀 리퀘스트에 실질적인 검토 의견 제공
Code Review 도입 전에는 전체 풀 리퀘스트의 16%에 불과했지만, 리서치 프리뷰 기준으로 그 비율이 3배 이상 높아졌습니다.
Claude Code의 변경 사항 되돌리기 비율 40% 감소
6월부터 9월까지 병합된 풀 리퀘스트는 두 배 이상 증가한 반면, 되돌려야 했던 풀 리퀘스트의 비율은 감소했습니다.
Code Review는 GitHub의 풀 리퀘스트를 하나씩 검토하고 발견한 버그를 리뷰어에게 댓글로 알려 주는 AI 코드 리뷰 도구입니다. 이를 통해 Code Review의 기반이 되는 AI 기술인 Claude가 코드에 대한 1차 검토를 수행할 수 있습니다. Code Review는 AI를 사용하므로 버그, 보안 취약점 또는 기타 문제를 놓칠 수도 있습니다.
Code Review는 GitHub의 리포지토리에서 작동하며, GitHub Enterprise Server와 데이터 레지던시가 적용된 GitHub Enterprise Cloud에서 사용할 수 있습니다. GitLab, 사용자별 액세스 제어, 자체 호스팅 환경은 지원하지 않습니다. 데이터 보존 기간을 0으로 설정했거나, HIPAA 구성 또는 고객 관리형 암호화 키를 사용하는 조직에서는 Code Review를 이용할 수 없습니다.
아니요. Code Review는 GitHub 풀 리퀘스트에서 실행되므로 Claude Code를 사용할 필요가 없습니다.
예, 플랜에 관계없이 Claude Code 세션에서 /code-review를 실행하여 자신의 브랜치를 리뷰할 수 있습니다. 단, 모든 풀 리퀘스트를 리뷰하려면 Team 또는 Enterprise Plan을 사용해야 합니다.
네, Claude Team 또는 Enterprise 조직에 속해 있다면 Code Review를 사용할 수 있습니다. 리뷰는 Anthropic 인프라에서 실행되며, 요금도 Anthropic에서 청구합니다.
리뷰 중에는 리포지토리에 읽기 전용으로만 액세스할 수 있으며, 어떤 변경 사항도 푸시되지 않습니다. 단, 사용자가 설치하는 Claude GitHub 앱에는 다른 Claude 기능과 공유되는 더 광범위한 권한이 부여됩니다. 리뷰는 코드를 빌드하거나 실행하지 않은 상태에서 diff와 주변 코드를 검토하고, 풀 리퀘스트에 댓글과 검사 실행 결과를 게시합니다. 이후 푸시된 코드에서 앞서 발견된 문제가 수정되면, 리뷰가 해당 문제에 대해 작성한 댓글을 '해결됨'으로 표시합니다.
설정은 Claude와 GitHub에서 각각 한 단계씩, 총 두 단계로 진행됩니다. 먼저 Claude에서는 조직 소유자가 관리자 설정을 통해 Code Review를 활성화해야 합니다. GitHub에서는 조직 소유자가 Claude GitHub 앱을 설치해야 합니다. 이후, Code Review로 리뷰할 리포지토리를 선택합니다. 어느 쪽에서도 소유자 권한이 없다면, 담당자에게 설정 가이드를 전달하세요.
아니요. Code Review가 모델을 선택합니다. 리뷰를 더 꼼꼼하게 수행하거나 간단하게 진행하려면 리뷰 수준을 변경하세요.
Code Review는 플랜의 기본 제공 사용량과 별도로, 토큰 사용량에 따라 요금이 부과되며 사용량 크레딧을 통해 청구됩니다. 관리자는 월별 지출 한도를 설정하고 리포지토리별 리뷰당 평균 비용을 확인할 수 있습니다.
리포지토리 하나에서 먼저 사용해 보고, 이후 다른 리포지토리를 추가하세요.