Claude Code Review 정식 제공: 리뷰 수준·실행 빈도·비용 설정하기

Claude Code Review는 GitHub PR의 변경과 주변 코드를 읽고, 버그 후보를 확인한 뒤 댓글을 남기는 관리형 AI 리뷰 서비스입니다. 코딩 에이전트가 만든 PR이 늘어 사람이 읽기 전에 결함을 걸러야 하는 팀에서 사용할 수 있습니다.

Anthropic은 Code Review의 정식 제공 ↗을 발표했습니다. 대상은 Claude Team·Enterprise 조직입니다. 이번 글에서는 달라진 점을 살펴보고, 첫 저장소를 연결할 때 함께 정할 리뷰 수준·실행 빈도·지출 한도를 정리합니다.

Anthropic 내부 코드 리뷰 운영 사례가 사람 승인과 복구 조건을 다뤘다면, 여기서는 공개 제품을 실제로 도입하는 설정에 집중합니다.

기준: 2026-10-21 확인 · 정식 제공(GA). 발표 페이지의 구조화 데이터상 게시일은 2026-10-15입니다. 지원 조건과 과금은 아래 공식 문서를 기준으로 합니다.

정식 제공에서는 속도·지적 형식·리뷰 수준이 달라졌습니다

발표문 ↗은 프리뷰 사용자들이 빠르고 조용하며 변경에 맞는 리뷰를 원했다고 설명합니다. 여기서 조용한 리뷰란 댓글 수가 적다는 뜻만이 아닙니다. 사람이 확인할 가치가 있는 문제를 구체적인 근거와 함께 전달해야 합니다.

• 속도: 대부분의 리뷰가 프리뷰의 약 20분에서 6~10분으로 줄었다고 설명합니다. 원문은 이를 약 3배 빠르다고 표현합니다.
• 지적 형식: 문제, 발생 조건, 수정 방법을 몇 문장으로 전달하도록 개선했다고 밝힙니다.
• 리뷰 수준: 관리자가 저장소마다 Quick·Standard·Deep을 선택할 수 있습니다. Standard가 기본값입니다.

시간 수치는 Anthropic의 제품 발표값입니다. 수준별 고정 처리 시간이나 응답 시간 보장으로 읽으면 안 됩니다. 지적 품질 개선에도 공개된 동일 조건의 정량 비교가 없으므로, 정확도 상승률을 붙일 수는 없습니다.

리뷰는 코드를 읽지만 테스트를 실행하지 않습니다

제품 문서 ↗는 리뷰를 네 단계로 나눕니다.

출처: Code Review 공식 문서 ↗. 가운데의 분석은 Anthropic 인프라에서 수행하며, 결과는 GitHub PR에 남깁니다.

1. 여러 에이전트가 diff와 주변 코드를 병렬로 읽습니다.
2. 후보 지적을 코드와 대조해 오탐을 걸러냅니다.
3. 중복을 제거하고 심각도에 따라 정렬합니다.
4. 인라인 댓글, 요약, check run을 게시합니다.

여기서 검증은 빌드나 테스트 실행이 아닙니다. 서비스는 코드를 읽어 검토하며, 저장소에 커밋을 push하지 않습니다. 따라서 CI의 타입 검사·통합 테스트·접근성 검사는 그대로 유지해야 합니다.

또한 리뷰는 PR을 승인하거나 차단하지 않습니다. Claude Code Review라는 check run도 실패 상태로 끝나지 않습니다. 지적이 없다는 결과를 테스트 통과나 병합 승인과 동일하게 취급하지 않습니다. 병합 조건은 팀의 브랜치 보호와 승인 정책으로 정합니다.

리뷰 수준과 실행 빈도를 따로 정합니다

Quick·Standard·Deep은 검토의 깊이를 바꿉니다. 실행 빈도는 같은 PR에 리뷰를 몇 번 돌릴지 바꿉니다. 비용을 검토할 때는 두 설정을 함께 봐야 합니다. (설정 문서 ↗)

리뷰 수준: 저장소가 감당할 깊이와 대기 시간

• Quick: 가벼운 검토입니다. 세 수준 중 가장 빠르고 비용이 낮습니다.
• Standard: 깊이·속도·비용의 균형을 잡는 기본 수준입니다.
• Deep: 가장 철저하게 검토하며, 시간과 비용도 가장 많이 듭니다.

조직 기본값을 정하고 저장소별로 덮어쓸 수 있습니다. 리뷰에 쓸 모델을 직접 고르는 설정은 제공하지 않습니다.

다음은 팀에 적용할 때의 선택 예시입니다. 공식 제품의 자동 위험 분류 규칙은 아닙니다. 일반 웹앱은 Standard로 관찰을 시작하고, 인증·결제처럼 실패 비용이 큰 저장소에서는 Deep을 검토합니다. 일상적인 낮은 위험의 저장소에서는 Quick의 지적 품질과 비용을 확인합니다. 한 저장소에 여러 위험 영역이 섞여 있다면, 수준 설정만으로 경로별 사람 승인을 대체하지 않습니다.

실행 빈도: push마다 비용이 다시 발생할 수 있습니다

관리 화면에서 추가한 저장소는 After every push로 시작합니다. 발표문의 “새 PR에서 자동 실행”만 읽고 한 번만 과금된다고 가정하면 안 됩니다.

• Once after PR creation: PR 생성·다시 열기·리뷰 준비 상태 전환 때 실행합니다. PR 수명 전체에 영구히 한 번만 실행한다는 뜻은 아닙니다.
• After every push: PR 브랜치에 push할 때마다 실행합니다.
• Manual (@claude review): PR 생성이나 push만으로는 실행하지 않습니다. 댓글로 요청합니다.

문서상 자동 리뷰는 draft PR과 fork에서 온 PR을 건너뜁니다. 수동 요청과 예외는 PR 사용 문서 ↗를 확인합니다.

처음에는 대표 저장소 몇 개를 Manual 또는 Once after PR creation으로 운영하면, 수정 커밋이 잦은 팀의 사용량을 파악하기 쉽습니다. 매 push 검토는 누락을 줄일 필요와 추가 비용을 비교한 뒤 선택합니다.

첫 저장소는 한도 설정과 테스트 PR까지 연결합니다

설정 문서 ↗에 따른 준비 조건은 다음과 같습니다.

• Claude Team 또는 Enterprise 조직과 Claude 조직 Owner 권한
• Claude GitHub App을 설치하고 연결할 GitHub 조직 Owner의 협조
• 연결한 GitHub 계정의 대상 저장소 쓰기 권한
• 코드가 Anthropic 인프라에서 처리되는 방식에 대한 조직의 보안 검토

ZDR(Zero Data Retention), HIPAA 구성, 고객 관리 암호화 키(CMEK)를 쓰는 조직에는 제공 제한이 있습니다. GitHub Enterprise Server와 데이터 레지던시 구성은 별도 연결 절차를 확인합니다. (지원 조건 ↗)

도입은 다음 순서로 진행할 수 있습니다.

1. 지출 한도를 먼저 정합니다. Usage 설정 ↗에서 조직 한도와 Code Review 서비스의 월 한도를 확인합니다.
2. 관리자가 서비스를 켭니다. Admin settings > Claude Code ↗의 Code review에서 Allow code review를 켭니다.
3. GitHub를 연결합니다. Claude GitHub App을 설치하고 대상 저장소만 선택합니다. 리뷰 자체의 읽기 전용 동작과 앱이 요청하는 전체 권한은 다르므로 설치 권한도 검토합니다.
4. 설정을 마칩니다. 저장소 선택 뒤 Finish로 완료합니다. 리뷰 수준과 실행 빈도를 확인하고, 필요한 경우 Manual로 바꿉니다. 이 관리형 서비스용 workflow 파일을 저장소에 추가할 필요는 없습니다.
5. draft가 아닌 테스트 PR로 확인합니다. Manual이라면 저장소 쓰기 권한이 있는 사람이 다음 댓글을 남깁니다.

PR 댓글 입력:

@claude review

문서상 성공 확인 지점은 PR에 나타나는 Claude Code Review check run과 리뷰 요약·인라인 지적입니다. “지적 없음”도 정상 결과일 수 있습니다. check run 자체가 없다면 연동·실행 모드·예산에 따른 건너뛰기를 구분해 조사합니다.

반복 검토가 필요할 때는 다음 댓글로 해당 PR을 이후 push 리뷰에 등록할 수 있습니다.

@claude review always

이 명령은 Manual·Once 모드에서도 이후 push에 따른 추가 리뷰 비용을 발생시킬 수 있습니다. 한 번만 요청할 때는 앞의 단일 명령을 사용합니다. (과금과 실행 횟수 ↗)

구독 포함 사용량과 별도로 과금됩니다

비용 문서 ↗는 고정된 PR당 가격이 없다고 명시합니다. 토큰 사용량을 usage credits로 과금하며, 요금제에 포함된 사용량과 별도입니다. 비용은 PR을 연 개발자 개인이 아니라 조직에 청구됩니다.

리뷰 하나의 비용에는 수준, 변경 크기, 주변 코드 복잡도, 검증할 후보 문제 수가 영향을 줍니다. 같은 PR이라도 여러 번 검토하면 실행 횟수만큼 누적됩니다.

파일럿의 월 비용은 다음과 같이 추정할 수 있습니다. 아래 수치는 제품 가격이 아닌 계산 예시입니다.

월 리뷰 비용 추정 = 관찰한 평균 리뷰 비용 × 예상 리뷰 실행 횟수

가정: 평균 리뷰 비용 2달러, 월 PR 100개
1회씩 실행: 2 × 100 = 200달러
PR당 평균 4회 실행: 2 × 100 × 4 = 800달러

실제 평균값은 관리 화면의 저장소별 Average cost에서 확인합니다. 예제의 2달러를 예산 단가로 그대로 쓰지 않습니다. 다시 열기·추가 요청·재리뷰도 예상 횟수에 반영합니다.

일반 과금에서는 Code Review 서비스 한도, 조직 한도, usage credits 잔액 중 하나가 부족해도 리뷰를 건너뛸 수 있습니다. 남은 예산이 한 번의 예상 비용보다 작아도 실행되지 않을 수 있습니다. 이때 PR의 예산 안내를 보고, 사람이 검토하거나 필요한 범위에서 실행 계획을 조정합니다.

Enterprise 프로모션은 무료 사용 종료 시점을 함께 확인합니다

발표문은 적격 Enterprise 조직에 최소 1만 달러의 Code Review 크레딧을 안내합니다. 프로모션 약관 안내 ↗에 따르면 관리자가 직접 신청해야 하며, 신청 기한은 2027-01-15 23:59 UTC입니다. 크레딧은 신청 순간부터 30일 또는 소진 시점까지 적용됩니다.

Team 전체에 주는 혜택은 아닙니다. 이전 무료 제공 신청 여부 등 자격 조건도 확인해야 합니다. 크레딧이 끝나도 서비스는 자동으로 멈추지 않고 일반 과금으로 이어집니다. 프로모션 잔액이 있는 동안에는 일반 지출 한도에 도달해도 리뷰가 실행될 수 있으므로, 지출 한도 0만으로 모든 리뷰를 중지했다고 생각하지 않습니다. 중지가 필요하면 서비스 자체를 끕니다.

파일럿의 성공은 댓글 수보다 사람 검토 부담으로 판단합니다

다음은 도입 평가를 위한 작성자 제안입니다. 제품이 자동으로 계산하는 종합 점수는 아닙니다.

• 실제 수정으로 이어진 결함과 잘못된 지적을 구분합니다.
• 리뷰 완료 대기 시간과 사람이 지적을 확인한 시간을 함께 봅니다.
• PR 수가 아니라 리뷰 실행 횟수와 저장소별 평균 비용을 기록합니다.
• 배포 뒤 놓친 결함을 확인하고, CI·사람 승인에서 어느 조건을 보완할지 정합니다.

분석 화면 ↗은 리뷰 활동과 비용, 해결된 댓글 등을 제공합니다. 다만 analytics의 비용과 청구서는 다를 수 있습니다. 저장소별 추정 비용은 정가 기준이며 할인·크레딧을 반영하지 않으므로, 실제 청구액은 청구서에서 확인합니다.

개인 브랜치를 수동으로 검토하려는 경우에는 관리형 서비스 대신 로컬 /code-review ↗를 검토할 수 있습니다. GitLab이나 직접 통제하는 실행 환경이 필요하면 자체 CI 연동 ↗과 지원 조건을 비교합니다. 모든 코드 리뷰 경로가 이번 GA 서비스의 과금·실행 방식과 같은 것은 아닙니다.

정식 제공을 도입하는 첫 결정은 가장 깊은 수준을 고르는 일이 아닙니다. 어떤 저장소에서, 언제 리뷰를 실행하고, 어떤 비용과 사람 검토 시간을 줄였는지 확인할 범위를 정하는 일입니다.

참고 자료

• Code Review is now generally available ↗ — 정식 제공과 프리뷰 대비 변경점
• Code Review ↗ — 검토 방식·지원 범위·승인 경계
• Set up Code Review ↗ — 관리자 권한·GitHub 연결·수준·실행 설정
• Code Review costs and usage ↗ — 과금·한도·분석 지표
• Enterprise promotional credits ↗ — 크레딧의 신청·만료·과금 전환 조건