Skip to main content
Claude 조직의 Owner는 claude.ai의 관리자 설정 > Claude Code에서 Code Review를 켭니다. 리뷰는 Anthropic 인프라에서 실행되므로 저장소에 워크플로 파일을 추가할 필요가 없습니다. 설정 후에는 각 저장소에서 리뷰의 철저함 수준과 실행 시점을 선택합니다. 리뷰 수준이 높을수록, 그리고 리뷰가 더 자주 실행될수록 비용이 더 많이 듭니다. Code Review 비용을 참조하세요.

​
Code Review를 켜는 데 필요한 사항

먼저 조직이 Code Review 사용 자격을 갖추었는지 확인합니다. 그런 다음 아래 접근 권한이 있는지, 또는 해당 권한을 가진 사람이 있는지 확인합니다.

​
Code Review 켜기

1

Allow code review 스위치 클릭

관리자 설정 > Claude Code의 Code review 섹션으로 이동하여 Allow code review 스위치를 클릭합니다.대화 상자 없이 Code Review가 바로 켜진다면, 조직에 이미 Claude GitHub App이 연결되어 있거나 저장소가 추가되어 있는 것입니다. 저장소 더 추가하기로 이동한 후 마지막 단계를 위해 다시 돌아오세요.
2

GitHub 계정 연결

Connect GitHub 대화 상자가 열리면 Connect를 클릭합니다. 조직에서 GitHub Enterprise Server를 사용하는 경우, 먼저 대화 상자에서 인스턴스를 선택합니다. GitHub에서 Claude 인증을 요청한 후, Add a repository 대화 상자가 열린 상태로 관리자 페이지로 돌아옵니다.Add a repository가 바로 열렸다면 계정이 이미 연결된 것이므로 다음 단계로 넘어갑니다.
3

Claude GitHub App 설치

원하는 저장소가 Add a repository 대화 상자에 표시되거나 검색으로 찾을 수 있다면 다음 단계로 넘어갑니다. 대화 상자에는 Claude GitHub App이 접근할 수 있는 저장소만 표시되므로, 저장소가 없다면 앱을 설치합니다.
  • Install GitHub App을 클릭합니다. 표시되는 저장소가 없으면 대화 상자에 버튼으로 나타납니다. 그렇지 않으면 대화 상자의 GitHub 조직 필터 메뉴 하단에 있습니다. GitHub 설치 페이지가 새 탭에서 열립니다.
  • 저장소를 소유한 GitHub 조직을 선택합니다.
  • 앱이 접근할 수 있는 저장소를 선택합니다.
  • 요청된 권한을 승인합니다. 이 권한 세트는 리뷰에 사용되는 범위보다 넓으며 GitHub Actions 같은 다른 Claude 기능과 공유됩니다. 리뷰가 접근할 수 있는 항목과 전체 권한 목록을 참조하세요.
  • 설치가 완료되면 탭이 Claude로 돌아옵니다. Finish connecting GitHub 버튼이 표시되면 클릭하여 설치를 Claude 조직에 연결합니다.
  • 관리자 페이지 탭으로 돌아가면 대화 상자의 목록이 새로 고쳐집니다.
4

저장소 선택

리뷰할 저장소를 선택한 후 Continue를 클릭합니다. 저장소를 추가하려면 연결한 GitHub 계정에 해당 저장소에 대한 쓰기 권한이 있어야 합니다. 나중에 저장소를 더 추가할 수 있습니다.
5

Finish 클릭

이어서 Code review is set up 대화 상자가 나타납니다. Finish를 클릭하여 Code Review를 켭니다. 다른 방법으로 대화 상자를 닫으면 저장소는 추가된 상태로 유지되지만 Allow code review는 꺼진 상태로 남으며, 스위치에서 직접 켜야 합니다.각 저장소는 처음에 푸시할 때마다 리뷰하도록 설정되며, 이 설정에서 리뷰가 가장 많이 실행됩니다. 리뷰 횟수를 줄이려면 리뷰 실행 시점을 설정하세요.
6

테스트 풀 리퀘스트로 확인

추가한 저장소 중 하나에서 테스트 풀 리퀘스트를 열고, 드래프트로 표시하지 않습니다. 몇 분 내에 Claude Code Review라는 이름의 check run이 나타납니다. 저장소를 이미 **Manual (@claude review)**로 설정했다면, 풀 리퀘스트에 @claude review라는 댓글을 달아 첫 리뷰를 시작합니다.check run이 나타나지 않으면 테스트 풀 리퀘스트에 check run이 나타나지 않음을 참조하세요.리뷰가 도착하면 개발자들에게 풀 리퀘스트에서 리뷰 읽기 및 요청하기를 공유하세요. 이 문서에서는 심각도 수준, 댓글 명령, 발견 사항에 대응하는 방법을 다룹니다.

​
조직 기본값 설정

Owner는 리뷰의 철저함 수준과 실행 빈도를 결정합니다. 두 설정 모두 관리자 설정 > Claude Code의 Code review 섹션에 있습니다.

​
기본 리뷰 수준 설정

리뷰 수준은 각 리뷰의 철저함을 결정하며, 더 철저한 리뷰일수록 비용이 더 많이 듭니다. 조직에 하나의 기본값을 설정하고 개별 저장소에서 이를 재정의할 수 있습니다.
  • 조직 기본값: Review level에서 수준을 선택하고 Change level로 확정합니다. 저장소에 별도 수준을 지정하지 않는 한 모든 저장소가 이 값을 사용합니다.
  • 개별 저장소: 저장소 행에서 Edit를 클릭한 후 Review level을 선택합니다. 첫 번째 옵션인 Default는 조직 설정을 따릅니다. 수준은 선택하는 즉시 저장됩니다.
새 수준은 변경 후 시작되는 리뷰에 적용됩니다. 각 리뷰의 비용에 영향을 주는 다른 요인은 Code Review 비용 및 사용량을 참조하세요.

​
리뷰 실행 시점 설정

각 저장소에는 자체 Review runs 설정이 있으며, 이 설정이 풀 리퀘스트가 리뷰되는 시점을 결정합니다.
  • Once after PR creation: 풀 리퀘스트가 열리거나, 다시 열리거나, 리뷰 준비 완료로 표시될 때 리뷰가 실행됩니다
  • After every push: 풀 리퀘스트 브랜치에 푸시할 때 리뷰가 실행되어, 풀 리퀘스트가 발전함에 따라 새로운 문제를 포착하고 플래그된 문제를 수정하면 스레드를 자동으로 해결합니다
  • Manual (@claude review): 풀 리퀘스트를 열거나 푸시해도 리뷰가 시작되지 않습니다. 리뷰를 요청하려면 @claude review 댓글을 달고, 이후 푸시에도 리뷰를 받도록 풀 리퀘스트를 구독하려면 @claude review always 댓글을 답니다.
Manual은 특정 풀 리퀘스트만 선택적으로 리뷰하려는 트래픽이 많은 저장소나, 풀 리퀘스트가 준비된 후에만 리뷰를 시작하려는 경우에 유용합니다. 각 옵션이 비용에 미치는 영향을 비교하려면 리뷰 실행 빈도를 참조하세요. 설정을 변경하려면 Repositories 표에서 저장소 행의 Edit를 클릭하고 Review runs 옵션을 선택합니다. 선택은 즉시 저장되며, 표의 Review runs 열에는 Once per PR, Every push, Manual로 축약되어 표시됩니다.
  • 드래프트 및 포크에서 온 풀 리퀘스트: 어떤 옵션을 선택하든 자동 리뷰는 둘 다 건너뜁니다
  • 새 저장소: Add a repository 대화 상자에서 추가한 저장소는 After every push로 시작합니다. 해당 GitHub 조직이 전체적으로 적용된 경우에는 대신 해당 조직 행의 설정을 따릅니다.

​
팁 댓글 켜기 또는 끄기

팁 댓글은 리뷰가 시작되지 않을 때 Claude가 풀 리퀘스트에 게시하는 짧은 댓글로, 그 이유와 다음에 할 일을 알려 줍니다. Show tips on pull requests는 기본적으로 켜져 있습니다. 이 설정이 켜져 있으면 Claude는 다음 각 경우에 팁을 게시하여 설명합니다.
  • 저장소가 Manual로 설정된 경우: 댓글로 리뷰를 요청하는 방법
  • 풀 리퀘스트가 포크에서 온 경우: 메인테이너가 리뷰를 요청할 수 있다는 점
  • 봇 또는 쓰기 권한이 없는 사람이 @claude review 댓글을 단 경우: 리뷰가 시작되지 않았다는 점과 리뷰를 요청할 수 있는 사람
  • GitHub 조직이 Claude 조직에 연결되지 않은 경우: 리뷰가 일시 중지되었다는 점과 연결하는 방법
이러한 댓글을 중지하려면 설정을 끕니다.

​
개발자가 변경할 수 있는 항목

리뷰 수준, Review runs 설정, 리뷰 대상 저장소를 변경하려면 개발자가 Owner에게 요청해야 합니다. Owner 역할이 없어도 개발자는 GitHub에서 다음 작업을 할 수 있습니다. 개발자가 요청한 리뷰는 조직에 청구됩니다. Code Review의 월간 지출을 제한하려면 지출 제한을 참조하세요.

​
저장소 관리

저장소를 하나씩 추가하거나 GitHub 조직 전체를 한 번에 적용할 수 있으며, 원하지 않는 곳에서는 리뷰를 중지할 수 있습니다.

​
저장소 더 추가하기

설정 후 저장소를 추가하려면 Code review 섹션의 Repositories 표 위에 있는 Add를 클릭합니다. Add a repository 대화 상자가 열립니다. 저장소를 선택하고 Continue를 클릭합니다.

​
GitHub 조직 전체 적용

GitHub 조직의 모든 저장소에서 Code Review를 켜려면 Repositories 표에서 해당 조직 행의 Review runs를 설정합니다. 이렇게 하면 나중에 추가되는 저장소를 포함하여 Claude GitHub App이 접근할 수 있는 해당 조직의 모든 저장소가 적용 대상이 됩니다. 이로 인해 지출이 크게 늘어날 수 있습니다. 다음 조건을 모두 충족해야 합니다.
  • Claude에 연결한 GitHub 계정이 해당 GitHub 조직의 owner여야 합니다.
  • 조직이 github.com에 있어야 합니다. GitHub Enterprise Server 인스턴스와 개인 GitHub 계정은 해당되지 않습니다.
  • Claude 조직 또는 Code Review에 대한 월간 지출 한도가 설정되어 있어야 합니다.
조직 전체를 적용하려면 해당 행의 Edit를 클릭하고 Review runs 옵션을 선택한 후 확정합니다. 옵션은 리뷰 실행 시점 설정의 세 가지 옵션에 Off가 추가된 것입니다. 확정하면 다음 변경 사항이 적용됩니다.
  • 적용 범위: 각 저장소는 다음 풀 리퀘스트부터 적용됩니다. Claude GitHub App이 모든 저장소가 아닌 선택한 저장소에만 설치된 경우 Claude는 해당 저장소만 리뷰합니다. 나머지 저장소도 적용하려면 GitHub에서 앱의 저장소 접근 권한을 변경하세요.
  • 기존 설정: 개별적으로 설정한 저장소를 포함하여 해당 GitHub 조직의 모든 저장소가 선택한 옵션을 따릅니다. 행을 다시 설정해도 마찬가지입니다. 각 저장소 행에서 끈 저장소는 꺼진 상태로 유지됩니다.
  • 이후 개별 변경: 나중에 조직과 다르게 설정한 저장소는 표에 Custom으로 표시됩니다.
  • 리뷰 수준: 조직 행에는 자체 리뷰 수준이 없습니다.

​
Code Review 끄기 또는 저장소 제거

관리자 설정 > Claude Code의 Code review 섹션에서 중지하려는 대상에 맞는 컨트롤을 선택합니다.
  • 저장소 하나, 목록에는 유지: 해당 행의 Edit를 클릭하고 Code review를 끕니다. 표에 저장소가 Off로 표시됩니다.
  • 저장소 하나, 제거: 해당 행의 Edit를 클릭한 후 대화 상자 하단의 Remove repository를 클릭합니다. 해당 저장소의 리뷰가 중지되며, 이후 다른 Claude 조직이 해당 저장소를 설정할 수 있습니다. 저장소의 GitHub 조직이 전체적으로 적용된 동안에는 제거할 수 없으므로 대신 Code review 스위치를 끕니다.
  • GitHub 조직 전체: 조직 행의 Edit를 클릭하고 Off를 선택합니다. 이렇게 하면 해당 조직에서 하나씩 추가한 저장소도 꺼집니다.
  • 전체: Allow code review를 끕니다. 어떤 저장소에서도 새 리뷰가 시작되지 않으며, 저장소 목록은 유지되므로 나중에 다시 켤 수 있습니다.