Code Review 설정 (조직 Owner용)
기준일: 2026-10-23
공식 기준: Set up Code Review
개요
Claude 조직의 Owner가 claude.ai의 Admin settings > Claude Code에서 Code Review를 켭니다. 리뷰는 Anthropic 인프라에서 실행되므로 저장소에 workflow 파일을 추가하지 않습니다. 설정 후 저장소마다 리뷰의 철저함과 실행 시점을 고릅니다. 수준이 높을수록, 실행이 잦을수록 비용이 늘어납니다(Code Review costs). 서비스 자체는 Code Review를 참고하세요.
핵심 개념
| 필요한 접근 | 용도 |
|---|---|
| Claude 조직의 Owner 역할 | 관리 페이지의 모든 단계 |
| GitHub 조직의 owner | Claude GitHub App 설치와 Claude 조직에 연결. owner가 아니면 시작 전에 owner가 설치·연결하게 함 |
| 추가할 각 저장소에 대한, Claude에 연결한 GitHub 계정의 write 권한 | 저장소 추가 |
| 리뷰 수준 | 트레이드오프 |
|---|---|
| Quick | 가벼운 패스. 가장 빠르고 가장 저렴 |
| Standard | 깊이·속도·비용의 균형. 기본 수준 |
| Deep | 가장 철저. 가장 오래 걸리고 가장 비쌈 |
| Review runs | 동작 |
|---|---|
| Once after PR creation | PR이 열리거나, 다시 열리거나, ready for review로 표시될 때 리뷰 |
| After every push | PR 브랜치 push마다 리뷰하고 지적한 문제를 고치면 스레드를 자동 resolve |
| Manual (@claude review) | PR을 열거나 push해도 리뷰하지 않음. @claude review 코멘트로 요청하고 @claude review always는 이후 push 리뷰까지 구독 |
(2.1.304에서 리뷰 수준 Quick/Standard/Deep과 GitHub 조직 전체 저장소 리뷰 옵션 추가)
상세
Code Review 켜기
먼저 조직이 Code Review 자격을 갖췄는지 확인합니다.
- Allow code review 스위치 클릭: Admin settings > Claude Code의 Code review 섹션에서 Allow code review를 클릭합니다. 대화상자 없이 바로 켜지면 이미 Claude GitHub App이 연결되었거나 저장소가 추가된 것이므로 저장소 추가로 가서 마지막 단계로 돌아오세요.
- GitHub 계정 연결: Connect GitHub 대화상자가 열리면 Connect를 클릭합니다. GitHub Enterprise Server를 쓰면 먼저 인스턴스를 선택합니다. GitHub가 Claude 승인을 요청한 뒤 Add a repository 대화상자가 열린 관리 페이지로 돌아옵니다. Add a repository가 바로 열렸다면 이미 연결된 것입니다.
- Claude GitHub App 설치: Add a repository 대화상자에 원하는 저장소가 나열되거나 검색되면 다음 단계로 갑니다. 대화상자는 Claude GitHub App이 접근할 수 있는 저장소만 보여주므로 없으면 앱을 설치합니다.
- Install GitHub App 클릭(저장소가 없으면 대화상자의 버튼, 아니면 GitHub 조직 필터 메뉴 하단). GitHub 설치 페이지가 새 탭에서 열림
- 저장소를 소유한 GitHub 조직 선택
- 앱이 접근할 저장소 선택
- 요청 권한 승인(리뷰가 쓰는 것보다 넓고 GitHub Actions 같은 다른 Claude 기능과 공유되는 집합)
- 설치가 끝나 탭이 Claude로 돌아오면 Finish connecting GitHub 버튼이 있을 때 클릭해 설치를 Claude 조직에 연결
- 관리 페이지 탭으로 돌아가면 대화상자 목록이 새로고침됨
- 저장소 선택: 리뷰할 저장소를 선택하고 Continue. 저장소 추가에는 연결한 GitHub 계정의 write 권한이 필요하며 나중에 더 추가할 수 있습니다.
- Finish 클릭: Code review is set up 대화상자에서 Finish를 클릭해 Code Review를 켭니다. 다른 방법으로 닫으면 저장소는 추가된 채 Allow code review가 꺼져 있으므로 스위치로 켭니다. 각 저장소는 모든 push 후 리뷰로 시작해 리뷰가 가장 많이 실행됩니다. 줄이려면 실행 시점을 설정하세요.
- 테스트 PR로 확인: 추가한 저장소에 draft가 아닌 테스트 PR을 엽니다. 몇 분 안에 Claude Code Review라는 check run이 나타납니다. 이미 저장소를 **Manual (@claude review)**로 설정했다면 PR에
@claude review를 코멘트해 첫 리뷰를 시작합니다. check run이 없으면 Troubleshoot Code Review의 "No check run appears on the test pull request"를 보세요. 리뷰가 도착하면 개발자에게 PR에서 리뷰 읽고 요청하기(심각도, 코멘트 명령, findings 응답 방법)를 안내합니다.
조직 기본값 설정
리뷰 수준 기본값: 철저할수록 비용이 큽니다. 조직 기본 하나를 정하고 저장소별로 override할 수 있습니다. 조직 기본은 Review level 아래에서 수준을 고르고 Change level로 확인하며, 저장소가 자기 수준을 갖지 않는 한 모든 저장소가 사용합니다. 저장소 하나는 그 행의 Edit를 클릭하고 Review level을 고릅니다(첫 옵션 Default는 조직을 따름, 선택 즉시 저장). 새 수준은 변경 이후 시작하는 리뷰에 적용됩니다.
리뷰 실행 시점: 저장소마다 Review runs 설정이 PR이 언제 리뷰되는지 정합니다(위 표). Manual은 특정 PR만 리뷰에 포함하고 싶은 트래픽 많은 저장소나 준비된 PR만 리뷰하려는 경우에 유용합니다. 비용 비교는 How often reviews run. 변경하려면 Repositories 표에서 저장소 행의 Edit를 클릭해 Review runs 옵션을 선택합니다(선택 즉시 저장, 표의 Review runs 열에 Once per PR, Every push, Manual로 줄여 표시).
- Draft와 fork의 PR: 어느 옵션이든 자동 리뷰는 둘 다 건너뜀
- 새 저장소: Add a repository 대화상자에서 추가한 저장소는 After every push로 시작. GitHub 조직이 전체로 적용되어 있으면 그 조직 행의 설정을 따름
팁 코멘트 켜기/끄기: 팁 코멘트는 리뷰가 시작되지 않을 때 Claude가 PR에 게시하는 짧은 코멘트로 이유와 다음 단계를 알립니다. Show tips on pull requests는 기본 켜짐이며 켜져 있으면 다음 경우에 게시합니다. 저장소가 Manual(코멘트로 리뷰 요청하는 방법), PR이 fork에서 옴(유지관리자가 리뷰를 요청할 수 있음), 봇 또는 PR 작성자가 아닌 write 권한 없는 사람이 @claude review를 코멘트(리뷰가 시작되지 않았고 누가 요청할 수 있는지), GitHub 조직이 Claude 조직에 연결되지 않음(리뷰가 일시정지되었고 연결 방법). 이 코멘트를 막으려면 설정을 끕니다.
개발자가 바꿀 수 있는 것: 리뷰 수준, Review runs, 리뷰 대상 저장소는 Owner에게 요청합니다. Owner 역할 없이 GitHub에서 할 수 있는 것:
- 리뷰 요청: PR에
@claude review코멘트(저장소 write 권한 필요, 자동 리뷰가 건너뛰는 draft와 fork PR에서도 동작) - 한 PR을 push마다 리뷰하도록 구독: draft나 fork가 아닌 PR(예: Manual 저장소)에
@claude review always코멘트. 2.1.307에서@claude review stop(off,pause동의어)이 추가되어 새 리뷰를 시작하지 않고@claude review always구독을 종료 - 리뷰가 지적하는 것 변경: 저장소에
REVIEW.md와CLAUDE.md를 커밋(예: 검사 추가)
개발자가 요청한 리뷰는 조직에 과금됩니다. 월 지출을 제한하려면 Limit your spend를 보세요.
저장소 관리
저장소 추가
설정 후 저장소를 추가하려면 Code review 섹션의 Repositories 표 위 Add를 클릭해 Add a repository 대화상자에서 저장소를 선택하고 Continue합니다. 저장소가 나열되지 않으면 Troubleshoot Code Review의 "A repository isn't listed in Add a repository"를 보고, GitHub 조직의 모든 저장소를 원하면 하나씩 고르는 대신 조직 전체를 적용합니다.
GitHub 조직 전체 적용
Repositories 표의 조직 행에서 Review runs를 설정하면 Claude GitHub App이 접근할 수 있는 그 조직의 모든 저장소(나중에 추가되는 것 포함)에 Code Review가 켜집니다. 지출이 크게 늘 수 있습니다. 다음이 모두 필요합니다.
- Claude에 연결한 GitHub 계정이 그 GitHub 조직의 owner
- 조직이 github.com에 있음(GitHub Enterprise Server 인스턴스와 개인 GitHub 계정은 해당 없음)
- Claude 조직 또는 Code Review에 월 지출 한도 설정
조직 행의 Edit를 클릭해 Review runs 옵션(위 세 가지 + Off)을 선택하고 확인합니다. 확인 후 적용되는 것:
- 적용 범위: 각 저장소는 다음 PR부터 적용. Claude GitHub App이 모든 저장소가 아니라 선택한 저장소에만 설치되었다면 그 저장소들을 리뷰하며, 나머지는 GitHub에서 앱의 저장소 접근을 바꿔 적용
- 기존 설정: 개별로 설정했던 저장소를 포함해 그 GitHub 조직의 모든 저장소가 선택한 옵션을 따름. 행을 다시 설정해도 같음. 자기 행에서 끈 저장소는 계속 꺼진 상태
- 이후 개별 변경: 조직과 다르게 설정한 저장소는 표에서 Custom으로 표시
- 리뷰 수준: 조직 행에는 자체 리뷰 수준이 없음
Code Review 끄기 / 저장소 제거
- 저장소 하나, 목록에 유지: 행의 Edit -> Code review 끄기. 표에 Off로 표시
- 저장소 하나, 제거: 행의 Edit -> 대화상자 하단 Remove repository. 그곳에서 리뷰가 멈추고 다른 Claude 조직이 그 저장소를 설정할 수 있게 됨. 저장소의 GitHub 조직이 전체로 적용된 동안에는 제거할 수 없으므로 Code review 스위치를 끔
- GitHub 조직 전체: 조직 행의 Edit -> Off. 하나씩 추가한 그 조직의 저장소도 꺼짐
- 전부: Allow code review를 끔. 어느 저장소에서도 새 리뷰가 시작되지 않고 저장소 목록은 유지되어 나중에 다시 켤 수 있음