클로드 코드 리뷰를 GitHub PR에 켜고 저장소별 리뷰 깊이 정하는 법

클로드 코드(Claude Code)의 코드 리뷰(Code Review)가 10월 15일 연구 프리뷰를 마치고 정식 출시됐다. 여러 에이전트가 앤트로픽 서버에서 GitHub 풀 리퀘스트(PR)를 읽고, 검증을 통과한 지적만 해당 줄에 댓글로 단다. 저장소에 워크플로 파일을 따로 넣지 않는다.

1. 클로드 조직의 Owner가 claude.ai Admin settings > Claude Code의 Code review 항목에서 Allow code review 스위치를 켠다.

https://claude.ai/admin-settings/claude-code#code-review

1. Connect GitHub로 계정을 연결한다. 저장소가 목록에 안 보이면 Install GitHub App으로 클로드 GitHub 앱을 설치하는데, 이 설치는 GitHub 조직 Owner가 해야 한다.
2. 리뷰할 저장소를 고르고 Continue, 이어서 Finish를 누른다. Finish 없이 창을 닫으면 저장소만 추가되고 리뷰는 꺼진 채로 남는다.
3. 초안이 아닌 테스트 PR을 하나 연다. 몇 분 안에 Claude Code Review라는 체크가 붙으면 설정이 끝난 것이다.

리뷰 깊이는 Quick, Standard(기본), Deep 세 단계이고 깊을수록 오래 걸리고 비용도 더 든다. 조직 기본값은 Review level에서, 저장소별 값은 그 저장소 행의 Edit에서 바꾼다. 새로 추가한 저장소는 푸시마다 리뷰(After every push)로 시작하니, 비용을 줄이려면 Review runs를 Once after PR creation이나 Manual로 돌려 둔다.

Manual 저장소에서는 쓰기 권한이 있는 사람이 PR에 댓글을 달아 리뷰를 부른다.

@claude review

그 PR의 다음 푸시부터 계속 리뷰받으려면 @claude review always를 단다. 무엇을 지적하고 무엇을 건너뛸지는 저장소 루트의 REVIEW.md로 정한다. 이 파일은 PR 변경분이 아니라 기본 브랜치나 대상 브랜치에서 읽으므로 먼저 머지해 둔다.

Team·Enterprise 요금제의 GitHub 저장소만 쓸 수 있고, ZDR이나 HIPAA 설정을 켠 조직은 빠진다. 리뷰가 PR을 승인하거나 막지는 않는다. 요금제와 상관없이 내 컴퓨터에서 리뷰받고 싶으면 세션에서 /code-review를 친다.