> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Code Review 설정

> Claude 조직에서 Code Review를 켭니다. GitHub를 연결하고, Claude GitHub App을 설치하고, 저장소를 선택하고, 리뷰 실행 시점을 설정합니다

Claude 조직의 Owner는 claude.ai의 [**관리자 설정 > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review)에서 Code Review를 켭니다. 리뷰는 Anthropic 인프라에서 실행되므로 저장소에 워크플로 파일을 추가할 필요가 없습니다.

설정 후에는 각 저장소에서 리뷰의 철저함 수준과 실행 시점을 선택합니다. 리뷰 수준이 높을수록, 그리고 리뷰가 더 자주 실행될수록 비용이 더 많이 듭니다. [Code Review 비용](/docs/ko/code-review-costs#pricing)을 참조하세요.

<h2 id="what-you-need-to-turn-on-code-review">
  Code Review를 켜는 데 필요한 사항
</h2>

먼저 조직이 [Code Review 사용 자격을 갖추었는지](/docs/ko/code-review#availability) 확인합니다. 그런 다음 아래 접근 권한이 있는지, 또는 해당 권한을 가진 사람이 있는지 확인합니다.

| 접근 권한 | 필요한 작업 |
| :- | :- |
| Claude 조직의 [Owner 역할](/docs/ko/server-managed-settings#access-control) | 관리자 페이지의 모든 단계 |
| GitHub 조직의 owner | Claude GitHub App 설치 및 [Claude 조직에 연결](/docs/ko/admin-setup#connected-github-accounts). owner가 아닌 경우, 시작하기 전에 owner에게 앱 설치와 연결을 요청하세요 |
| Claude에 연결하는 GitHub 계정에서 추가하려는 각 저장소에 대한 쓰기 권한 | 저장소 추가 |

<h2 id="turn-on-code-review">
  Code Review 켜기
</h2>

<Steps>
  <Step title="Allow code review 스위치 클릭">
    [**관리자 설정 > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review)의 **Code review** 섹션으로 이동하여 **Allow code review** 스위치를 클릭합니다.

    대화 상자 없이 Code Review가 바로 켜진다면, 조직에 이미 Claude GitHub App이 연결되어 있거나 저장소가 추가되어 있는 것입니다. [저장소 더 추가하기](#add-more-repositories)로 이동한 후 마지막 단계를 위해 다시 돌아오세요.
  </Step>

  <Step title="GitHub 계정 연결">
    **Connect GitHub** 대화 상자가 열리면 **Connect**를 클릭합니다. 조직에서 GitHub Enterprise Server를 사용하는 경우, 먼저 대화 상자에서 인스턴스를 선택합니다. GitHub에서 Claude 인증을 요청한 후, **Add a repository** 대화 상자가 열린 상태로 관리자 페이지로 돌아옵니다.

    **Add a repository**가 바로 열렸다면 계정이 이미 연결된 것이므로 다음 단계로 넘어갑니다.
  </Step>

  <Step title="Claude GitHub App 설치">
    원하는 저장소가 **Add a repository** 대화 상자에 표시되거나 검색으로 찾을 수 있다면 다음 단계로 넘어갑니다. 대화 상자에는 Claude GitHub App이 접근할 수 있는 저장소만 표시되므로, 저장소가 없다면 앱을 설치합니다.

    * **Install GitHub App**을 클릭합니다. 표시되는 저장소가 없으면 대화 상자에 버튼으로 나타납니다. 그렇지 않으면 대화 상자의 GitHub 조직 필터 메뉴 하단에 있습니다. GitHub 설치 페이지가 새 탭에서 열립니다.
    * 저장소를 소유한 GitHub 조직을 선택합니다.
    * 앱이 접근할 수 있는 저장소를 선택합니다.
    * 요청된 권한을 승인합니다. 이 권한 세트는 리뷰에 사용되는 범위보다 넓으며 [GitHub Actions](/docs/ko/github-actions) 같은 다른 Claude 기능과 공유됩니다. [리뷰가 접근할 수 있는 항목](/docs/ko/code-review#what-a-review-can-access)과 [전체 권한 목록](/docs/ko/github-actions#github-app-permissions)을 참조하세요.
    * 설치가 완료되면 탭이 Claude로 돌아옵니다. **Finish connecting GitHub** 버튼이 표시되면 클릭하여 설치를 Claude 조직에 연결합니다.
    * 관리자 페이지 탭으로 돌아가면 대화 상자의 목록이 새로 고쳐집니다.
  </Step>

  <Step title="저장소 선택">
    리뷰할 저장소를 선택한 후 **Continue**를 클릭합니다. 저장소를 추가하려면 연결한 GitHub 계정에 해당 저장소에 대한 쓰기 권한이 있어야 합니다. 나중에 [저장소를 더 추가](#add-more-repositories)할 수 있습니다.
  </Step>

  <Step title="Finish 클릭">
    이어서 **Code review is set up** 대화 상자가 나타납니다. **Finish**를 클릭하여 Code Review를 켭니다. 다른 방법으로 대화 상자를 닫으면 저장소는 추가된 상태로 유지되지만 **Allow code review**는 꺼진 상태로 남으며, 스위치에서 직접 켜야 합니다.

    각 저장소는 처음에 푸시할 때마다 리뷰하도록 설정되며, 이 설정에서 리뷰가 가장 많이 실행됩니다. 리뷰 횟수를 줄이려면 [리뷰 실행 시점을 설정](#set-when-reviews-run)하세요.
  </Step>

  <Step title="테스트 풀 리퀘스트로 확인">
    추가한 저장소 중 하나에서 테스트 풀 리퀘스트를 열고, 드래프트로 표시하지 않습니다. 몇 분 내에 **Claude Code Review**라는 이름의 check run이 나타납니다. 저장소를 이미 \*\*Manual (@claude review)\*\*로 설정했다면, 풀 리퀘스트에 `@claude review`라는 댓글을 달아 첫 리뷰를 시작합니다.

    check run이 나타나지 않으면 [테스트 풀 리퀘스트에 check run이 나타나지 않음](/docs/ko/code-review-troubleshooting#no-check-run-appears-on-the-test-pull-request)을 참조하세요.

    리뷰가 도착하면 개발자들에게 [풀 리퀘스트에서 리뷰 읽기 및 요청하기](/docs/ko/code-review-pull-requests)를 공유하세요. 이 문서에서는 심각도 수준, 댓글 명령, 발견 사항에 대응하는 방법을 다룹니다.
  </Step>
</Steps>

<h2 id="set-defaults-for-your-organization">
  조직 기본값 설정
</h2>

Owner는 리뷰의 철저함 수준과 실행 빈도를 결정합니다. 두 설정 모두 [**관리자 설정 > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review)의 **Code review** 섹션에 있습니다.

<h3 id="set-the-default-review-level">
  기본 리뷰 수준 설정
</h3>

리뷰 수준은 각 리뷰의 철저함을 결정하며, 더 철저한 리뷰일수록 비용이 더 많이 듭니다. 조직에 하나의 기본값을 설정하고 개별 저장소에서 이를 재정의할 수 있습니다.

| 수준 | 절충 사항 |
| :- | :- |
| Quick | 가벼운 검토. 가장 빠르고 비용이 가장 낮은 수준입니다 |
| Standard | 깊이, 속도, 비용의 균형. 기본 수준입니다 |
| Deep | 가장 철저한 검토. 시간이 가장 오래 걸리고 비용이 가장 많이 듭니다 |

* **조직 기본값**: **Review level**에서 수준을 선택하고 **Change level**로 확정합니다. 저장소에 별도 수준을 지정하지 않는 한 모든 저장소가 이 값을 사용합니다.
* **개별 저장소**: 저장소 행에서 **Edit**를 클릭한 후 **Review level**을 선택합니다. 첫 번째 옵션인 **Default**는 조직 설정을 따릅니다. 수준은 선택하는 즉시 저장됩니다.

새 수준은 변경 후 시작되는 리뷰에 적용됩니다. 각 리뷰의 비용에 영향을 주는 다른 요인은 [Code Review 비용 및 사용량](/docs/ko/code-review-costs)을 참조하세요.

<h3 id="set-when-reviews-run">
  리뷰 실행 시점 설정
</h3>

각 저장소에는 자체 **Review runs** 설정이 있으며, 이 설정이 풀 리퀘스트가 리뷰되는 시점을 결정합니다.

* **Once after PR creation**: 풀 리퀘스트가 열리거나, 다시 열리거나, 리뷰 준비 완료로 표시될 때 리뷰가 실행됩니다
* **After every push**: 풀 리퀘스트 브랜치에 푸시할 때 리뷰가 실행되어, 풀 리퀘스트가 발전함에 따라 새로운 문제를 포착하고 플래그된 문제를 수정하면 스레드를 자동으로 해결합니다
* **Manual (@claude review)**: 풀 리퀘스트를 열거나 푸시해도 리뷰가 시작되지 않습니다. 리뷰를 요청하려면 [`@claude review`](/docs/ko/code-review-pull-requests#comment-commands) 댓글을 달고, 이후 푸시에도 리뷰를 받도록 풀 리퀘스트를 구독하려면 `@claude review always` 댓글을 답니다.

Manual은 특정 풀 리퀘스트만 선택적으로 리뷰하려는 트래픽이 많은 저장소나, 풀 리퀘스트가 준비된 후에만 리뷰를 시작하려는 경우에 유용합니다. 각 옵션이 비용에 미치는 영향을 비교하려면 [리뷰 실행 빈도](/docs/ko/code-review-costs#how-often-reviews-run)를 참조하세요.

설정을 변경하려면 **Repositories** 표에서 저장소 행의 **Edit**를 클릭하고 **Review runs** 옵션을 선택합니다. 선택은 즉시 저장되며, 표의 **Review runs** 열에는 Once per PR, Every push, Manual로 축약되어 표시됩니다.

* **드래프트 및 포크에서 온 풀 리퀘스트**: 어떤 옵션을 선택하든 [자동 리뷰는 둘 다 건너뜁니다](/docs/ko/code-review-pull-requests#review-drafts-and-pull-requests-from-forks)
* **새 저장소**: **Add a repository** 대화 상자에서 추가한 저장소는 **After every push**로 시작합니다. 해당 GitHub 조직이 [전체적으로 적용](#cover-a-whole-github-organization)된 경우에는 대신 해당 조직 행의 설정을 따릅니다.

<h3 id="turn-tip-comments-on-or-off">
  팁 댓글 켜기 또는 끄기
</h3>

팁 댓글은 리뷰가 시작되지 않을 때 Claude가 풀 리퀘스트에 게시하는 짧은 댓글로, 그 이유와 다음에 할 일을 알려 줍니다. **Show tips on pull requests**는 기본적으로 켜져 있습니다. 이 설정이 켜져 있으면 Claude는 다음 각 경우에 팁을 게시하여 설명합니다.

* **저장소가 Manual로 설정된 경우**: 댓글로 리뷰를 요청하는 방법
* **풀 리퀘스트가 포크에서 온 경우**: 메인테이너가 리뷰를 요청할 수 있다는 점
* **봇 또는 쓰기 권한이 없는 사람이 `@claude review` 댓글을 단 경우**: 리뷰가 시작되지 않았다는 점과 리뷰를 요청할 수 있는 사람
* **GitHub 조직이 Claude 조직에 연결되지 않은 경우**: 리뷰가 일시 중지되었다는 점과 연결하는 방법

이러한 댓글을 중지하려면 설정을 끕니다.

<h3 id="what-developers-can-change">
  개발자가 변경할 수 있는 항목
</h3>

리뷰 수준, **Review runs** 설정, 리뷰 대상 저장소를 변경하려면 개발자가 Owner에게 요청해야 합니다. Owner 역할이 없어도 개발자는 GitHub에서 다음 작업을 할 수 있습니다.

* **리뷰 요청**: 풀 리퀘스트에 [`@claude review`](/docs/ko/code-review-pull-requests#comment-commands) 댓글을 답니다. 이 작업에는 저장소에 대한 쓰기 권한이 필요하며, 자동 리뷰가 건너뛰는 [드래프트 및 포크에서 온 풀 리퀘스트](/docs/ko/code-review-pull-requests#review-drafts-and-pull-requests-from-forks)에서도 작동합니다.
* **푸시할 때마다 리뷰를 받도록 풀 리퀘스트 구독**: Manual로 설정된 저장소 등에서 [드래프트가 아니거나 포크에서 오지 않은](/docs/ko/code-review-pull-requests#review-drafts-and-pull-requests-from-forks) 풀 리퀘스트에 `@claude review always` 댓글을 답니다
* **리뷰가 플래그하는 항목 변경**: 예를 들어 검사를 추가하기 위해 저장소에 [`REVIEW.md` 및 `CLAUDE.md` 파일](/docs/ko/code-review-customize)을 커밋합니다

개발자가 요청한 리뷰는 [조직에 청구됩니다](/docs/ko/code-review-costs#pricing). Code Review의 월간 지출을 제한하려면 [지출 제한](/docs/ko/code-review-costs#limit-your-spend)을 참조하세요.

<h2 id="manage-repositories">
  저장소 관리
</h2>

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

<h3 id="add-more-repositories">
  저장소 더 추가하기
</h3>

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

* **저장소가 목록에 없는 경우**: [Add a repository에 저장소가 표시되지 않음](/docs/ko/code-review-troubleshooting#a-repository-isn’t-listed-in-add-a-repository)을 참조하세요.
* **GitHub 조직의 모든 저장소를 원하는 경우**: 저장소를 하나씩 선택하는 대신 [조직 전체를 적용](#cover-a-whole-github-organization)합니다

<h3 id="cover-a-whole-github-organization">
  GitHub 조직 전체 적용
</h3>

GitHub 조직의 모든 저장소에서 Code Review를 켜려면 **Repositories** 표에서 해당 조직 행의 **Review runs**를 설정합니다. 이렇게 하면 나중에 추가되는 저장소를 포함하여 Claude GitHub App이 접근할 수 있는 해당 조직의 모든 저장소가 적용 대상이 됩니다. 이로 인해 지출이 크게 늘어날 수 있습니다. 다음 조건을 모두 충족해야 합니다.

* Claude에 연결한 GitHub 계정이 해당 GitHub 조직의 owner여야 합니다.
* 조직이 github.com에 있어야 합니다. GitHub Enterprise Server 인스턴스와 개인 GitHub 계정은 해당되지 않습니다.
* Claude 조직 또는 Code Review에 대한 [월간 지출 한도](/docs/ko/code-review-costs#limit-your-spend)가 설정되어 있어야 합니다.

조직 전체를 적용하려면 해당 행의 **Edit**를 클릭하고 **Review runs** 옵션을 선택한 후 확정합니다. 옵션은 [리뷰 실행 시점 설정](#set-when-reviews-run)의 세 가지 옵션에 **Off**가 추가된 것입니다.

확정하면 다음 변경 사항이 적용됩니다.

* **적용 범위**: 각 저장소는 다음 풀 리퀘스트부터 적용됩니다. Claude GitHub App이 모든 저장소가 아닌 선택한 저장소에만 설치된 경우 Claude는 해당 저장소만 리뷰합니다. 나머지 저장소도 적용하려면 GitHub에서 앱의 저장소 접근 권한을 변경하세요.
* **기존 설정**: 개별적으로 설정한 저장소를 포함하여 해당 GitHub 조직의 모든 저장소가 선택한 옵션을 따릅니다. 행을 다시 설정해도 마찬가지입니다. 각 저장소 행에서 끈 저장소는 꺼진 상태로 유지됩니다.
* **이후 개별 변경**: 나중에 조직과 다르게 설정한 저장소는 표에 **Custom**으로 표시됩니다.
* **리뷰 수준**: 조직 행에는 자체 리뷰 수준이 없습니다.

<h3 id="turn-off-code-review-or-remove-a-repository">
  Code Review 끄기 또는 저장소 제거
</h3>

[**관리자 설정 > Claude Code**](https://claude.ai/admin-settings/claude-code#code-review)의 **Code review** 섹션에서 중지하려는 대상에 맞는 컨트롤을 선택합니다.

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

<h2 id="related-resources">
  관련 리소스
</h2>

* [Code Review 비용 및 사용량](/docs/ko/code-review-costs): 리뷰 수준과 리뷰 실행 시점이 지출에 미치는 영향, 지출 한도 설정 방법, 사용량 확인 위치
* [풀 리퀘스트에서 리뷰 읽기 및 요청하기](/docs/ko/code-review-pull-requests): 개발자가 풀 리퀘스트에서 보는 내용과 댓글 명령
* [Code Review 사용자 지정](/docs/ko/code-review-customize): `REVIEW.md` 및 `CLAUDE.md`로 Claude가 플래그하는 항목 조정
* [GitHub Enterprise Server](/docs/ko/github-enterprise-server): 설정 전에 자체 호스팅 GitHub 인스턴스 연결