Claude Code Review 설정: Quick Standard Deep 리뷰 레벨과 저장소별 적용법

Claude Code Review의 검토 깊이는 조직 기본값과 저장소별 리뷰 레벨로 조절합니다. Claude 조직 Owner가 Admin settings > Claude Code에서 설정하며, 개별 저장소에 Quick·Standard·Deep 중 다른 레벨을 지정할 수 있습니다.

이 글은 Team·Enterprise 조직용으로 제공되는 GitHub PR 관리형 Code Review를 다룹니다. 세션에서 실행하는 /code-review와는 별도 서비스이며, ZDR·HIPAA·CMEK 사용 조직에는 가용성 제한이 있습니다. 아래 절차는 Anthropic 공식 가이드에 따른 설명으로, 실제 계정에서 설정하거나 유료 리뷰를 실행한 후기는 아닙니다.

설정 전에 알아둘 용어

설정 화면에서 헷갈리기 쉬운 항목은 다음과 같습니다.

용어의미

PR	GitHub에서 코드 변경 사항을 검토하고 병합하도록 요청하는 단위
Review level	리뷰의 깊이·속도·비용을 조절하는 설정
조직 기본값	개별 레벨을 지정하지 않은 저장소가 따르는 리뷰 레벨
Default	저장소가 조직 기본값을 상속하도록 하는 선택지

Quick·Standard·Deep의 차이

Anthropic의 Code Review 문서는 세 레벨을 검토 깊이와 상대적인 속도·비용으로 구분합니다. Standard가 기본 레벨이며, 관리 화면에서 모델을 직접 선택하는 기능은 제공하지 않습니다.

레벨검토 깊이속도·비용

Quick	가벼운 검토	세 레벨 중 가장 빠르고 비용이 가장 낮음
Standard	깊이·속도·비용의 절충	기본 선택지
Deep	가장 철저한 검토	가장 오래 걸리고 비용이 가장 높음

표는 레벨 간 상대적인 비교입니다. 레벨만으로 정확한 청구 금액이나 완료 시간을 계산할 수는 없습니다.

1. GitHub 저장소 연결하기

처음 설정할 때는 Claude 조직과 GitHub 양쪽의 권한이 필요합니다. Claude 조직 Owner가 기능을 켜고, GitHub App 설치·연결에는 GitHub 조직 Owner 권한이 필요합니다. 저장소를 추가하려면 연결한 GitHub 계정에 해당 저장소의 쓰기 권한도 있어야 합니다.

1. claude.ai에서 Admin settings > Claude Code로 이동합니다.
2. Code review 영역의 Allow code review를 켭니다.
3. 필요한 경우 GitHub 계정을 연결하고 Claude GitHub App을 설치합니다.
4. App이 접근할 저장소를 선택하고 설치를 Claude 조직에 연결합니다.
5. 리뷰할 저장소를 선택한 뒤 Continue, Finish를 누릅니다.

공식 설정 가이드는 관리자 화면에서 저장소를 연결하는 절차를 안내합니다. 이 과정에서 저장소에 workflow 파일을 추가할 필요는 없습니다.

2. 조직 기본값과 저장소별 레벨 바꾸기

조직 전체에 적용할 레벨을 먼저 정한 뒤 필요한 저장소에 예외를 두면 관리하기 쉽습니다.

조직 기본값

관리자 화면의 Review level에서 원하는 레벨을 선택하고 Change level로 확정합니다. 저장소 설정이 Default라면 이 값을 따릅니다.

저장소별 예외

대상 저장소 행의 Edit을 열고 Review level을 선택합니다. 개별 저장소의 선택은 즉시 저장되며, 변경 후 시작하는 리뷰부터 적용됩니다.

Default와 Standard는 의미가 다릅니다. Default는 조직 설정을 따르고, Standard는 해당 저장소의 레벨을 Standard로 지정합니다. 조직 기본값을 Deep으로 바꾸면 Default인 저장소는 Deep을 따르지만, Standard를 직접 지정한 저장소는 그대로 유지됩니다.

예를 들어 조직 기본값을 Standard로 두고, 가벼운 검토가 필요한 저장소에는 Quick을, 더 철저히 검토할 저장소에는 Deep을 지정할 수 있습니다. 이는 설정 조합의 예시이며 저장소별 성능이나 비용을 측정한 추천은 아닙니다.

3. 실행 빈도를 정하고 테스트 PR 확인하기

리뷰 레벨은 검토 깊이를 정합니다. 실행 빈도는 별도 설정으로, PR 생성 때 한 번, 매 push, 요청 시 실행 중에서 정합니다. 초기 설정은 매 push 후 리뷰입니다.

연결 후에는 draft가 아닌 테스트 PR을 만들고 Claude Code Review check run을 확인합니다. 실행 방식을 Manual로 정했다면 쓰기 권한이 있는 사용자가 PR에 @claude review 댓글을 달아 시작할 수 있습니다.

리뷰 비용을 관리하려면 레벨과 실행 빈도를 함께 살펴야 합니다. Quick을 선택했더라도 push마다 리뷰하도록 설정하면 리뷰가 반복 실행됩니다.

리뷰 결과를 병합 승인으로 받아들이지 않기

관리형 Code Review는 코드를 빌드하거나 실행하지 않으며, PR을 승인하거나 병합을 차단하지도 않습니다. 지적이 없다는 결과가 오류나 취약점이 없다는 보장은 아닙니다. 기존 테스트와 사람의 검토를 함께 유지해야 합니다.

먼저 저장소 한 곳을 연결해 조직 기본값을 상속할지, 별도 레벨을 지정할지 정하세요. 이어 테스트 PR에서 리뷰 실행을 확인하면 같은 방식으로 다른 저장소에도 설정을 적용할 수 있습니다.

참고 링크

• Anthropic — Code Review
• Anthropic — Set up Code Review