8 8
9Code Review를 사용하면 Claude가 GitHub 저장소의 풀 리퀘스트를 리뷰합니다. 여러 에이전트가 각 변경 사항을 주변 코드와 함께 읽으며 논리 오류, 보안 취약점, 손상된 엣지 케이스와 같은 문제를 찾습니다. 검증 단계에서는 결과를 보고하기 전에 코드와 대조하여 확인합니다.9Code Review를 사용하면 Claude가 GitHub 저장소의 풀 리퀘스트를 리뷰합니다. 여러 에이전트가 각 변경 사항을 주변 코드와 함께 읽으며 논리 오류, 보안 취약점, 손상된 엣지 케이스와 같은 문제를 찾습니다. 검증 단계에서는 결과를 보고하기 전에 코드와 대조하여 확인합니다.
10 10
11결과는 [심각도](/docs/ko/code-review-pull-requests.md#severity-levels)별로 순위가 매겨져 해당 라인에 인라인 댓글로 게시되며, 풀 리퀘스트에는 요약과 확인 실행(check run)이 함께 표시됩니다. 리뷰는 풀 리퀘스트를 승인하거나 차단하지 않으므로 병합 결정은 팀에 그대로 남습니다.11결과는 [심각도](https://code.claude.com/docs/ko/code-review-pull-requests.md#severity-levels)별로 순위가 매겨져 해당 라인에 인라인 댓글로 게시되며, 풀 리퀘스트에는 요약과 확인 실행(check run)이 함께 표시됩니다. 리뷰는 풀 리퀘스트를 승인하거나 차단하지 않으므로 병합 결정은 팀에 그대로 남습니다.
12 12
1313
14 14
16>16>
17> Code Review는 AI를 사용하여 코드를 리뷰하므로 버그, 보안 취약점 또는 기타 문제를 놓칠 수 있습니다. 결과가 없는 리뷰가 코드에 오류가 없거나 안전하다는 것을 의미하지는 않습니다.17> Code Review는 AI를 사용하여 코드를 리뷰하므로 버그, 보안 취약점 또는 기타 문제를 놓칠 수 있습니다. 결과가 없는 리뷰가 코드에 오류가 없거나 안전하다는 것을 의미하지는 않습니다.
18 18
19Code Review를 켜려면 Claude 조직의 Owner가 [Code Review 설정](/docs/ko/code-review-setup.md)을 따릅니다. Claude는 이 서비스 없이도 코드를 리뷰할 수 있습니다. 모든 플랜에서 Claude Code 세션에서 [`/code-review`](/docs/ko/code-review-local)를 실행하거나, [모든 옵션을 비교](#compare-ways-to-get-a-review)해 보십시오.19Code Review를 켜려면 Claude 조직의 Owner가 [Code Review 설정](https://code.claude.com/docs/ko/code-review-setup.md)을 따릅니다. Claude는 이 서비스 없이도 코드를 리뷰할 수 있습니다. 모든 플랜에서 Claude Code 세션에서 [`/code-review`](https://code.claude.com/docs/ko/code-review-local)를 실행하거나, [모든 옵션을 비교](#compare-ways-to-get-a-review)해 보십시오.
20 20
21## 사용 가능 여부21## 사용 가능 여부
22 22
23Code Review를 설정하기 전에 조직이 자격 요건을 충족하는지 확인하십시오:23Code Review를 설정하기 전에 조직이 자격 요건을 충족하는지 확인하십시오:
24 24
25* **플랜**: [Team 및 Enterprise](/docs/ko/feature-availability.md)25* **플랜**: [Team 및 Enterprise](https://code.claude.com/docs/ko/feature-availability.md)
26* **코드 호스트**: [GitHub Enterprise Server](/docs/ko/github-enterprise-server.md) 및 데이터 레지던시가 적용된 GitHub Enterprise Cloud를 포함하여 GitHub에 호스팅된 저장소. 데이터 레지던시의 경우 Owner가 [GitHub Enterprise Server 관리자 설정](/docs/ko/github-enterprise-server.md#admin-setup)을 따르고 엔터프라이즈의 `ghe.com` 호스트 이름을 입력해야 합니다.26* **코드 호스트**: [GitHub Enterprise Server](https://code.claude.com/docs/ko/github-enterprise-server.md) 및 데이터 레지던시가 적용된 GitHub Enterprise Cloud를 포함하여 GitHub에 호스팅된 저장소. 데이터 레지던시의 경우 Owner가 [GitHub Enterprise Server 관리자 설정](https://code.claude.com/docs/ko/github-enterprise-server.md#admin-setup)을 따르고 엔터프라이즈의 `ghe.com` 호스트 이름을 입력해야 합니다.
27* **데이터 보존**: Code Review는 [Zero Data Retention](/docs/ko/zero-data-retention.md)이 활성화되었거나 [HIPAA 구성](/docs/ko/hipaa-setup.md)이 적용된 조직에서는 사용할 수 없으며, Anthropic의 Business Associate Agreement(BAA) 적용 대상이 아닙니다.27* **데이터 보존**: Code Review는 [Zero Data Retention](https://code.claude.com/docs/ko/zero-data-retention.md)이 활성화되었거나 [HIPAA 구성](https://code.claude.com/docs/ko/hipaa-setup.md)이 적용된 조직에서는 사용할 수 없으며, Anthropic의 Business Associate Agreement(BAA) 적용 대상이 아닙니다.
28* **암호화 키**: Code Review는 아직 고객 관리형 암호화 키(CMEK)를 사용하는 조직에서 사용할 수 없습니다.28* **암호화 키**: Code Review는 아직 고객 관리형 암호화 키(CMEK)를 사용하는 조직에서 사용할 수 없습니다.
29* **클라우드 제공업체**: 개발자가 Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry를 통해 Claude Code를 사용하더라도 이러한 플랜 중 하나의 Claude 조직이 필요합니다29* **클라우드 제공업체**: 개발자가 Amazon Bedrock, Google Cloud의 Agent Platform 또는 Microsoft Foundry를 통해 Claude Code를 사용하더라도 이러한 플랜 중 하나의 Claude 조직이 필요합니다
30 30
32 32
33필요한 작업에 맞는 페이지를 선택하십시오:33필요한 작업에 맞는 페이지를 선택하십시오:
34 34
35> **[Code Review 설정](/docs/ko/code-review-setup.md)**35> **[Code Review 설정](https://code.claude.com/docs/ko/code-review-setup.md)**
36>36>
37> 요구 사항을 확인하고, Claude GitHub App을 설치하고, 저장소, 리뷰 수준 및 리뷰 실행 시기를 선택합니다37> 요구 사항을 확인하고, Claude GitHub App을 설치하고, 저장소, 리뷰 수준 및 리뷰 실행 시기를 선택합니다
38 38
39> **[Code Review 사용자 정의](/docs/ko/code-review-customize.md)**39> **[Code Review 사용자 정의](https://code.claude.com/docs/ko/code-review-customize.md)**
40>40>
41> 저장소의 `REVIEW.md` 및 `CLAUDE.md` 파일로 플래그되는 항목을 조정합니다41> 저장소의 `REVIEW.md` 및 `CLAUDE.md` 파일로 플래그되는 항목을 조정합니다
42 42
43> **[풀 리퀘스트에서 리뷰 읽기 및 요청](/docs/ko/code-review-pull-requests.md)**43> **[풀 리퀘스트에서 리뷰 읽기 및 요청](https://code.claude.com/docs/ko/code-review-pull-requests.md)**
44>44>
45> 결과와 심각도를 읽고, 댓글로 다른 리뷰를 요청합니다45> 결과와 심각도를 읽고, 댓글로 다른 리뷰를 요청합니다
46 46
47> **[Code Review 문제 해결](/docs/ko/code-review-troubleshooting.md)**47> **[Code Review 문제 해결](https://code.claude.com/docs/ko/code-review-troubleshooting.md)**
48>48>
49> 시작되지 않았거나, 실패했거나, 예산 때문에 건너뛴 리뷰를 해결합니다49> 시작되지 않았거나, 실패했거나, 예산 때문에 건너뛴 리뷰를 해결합니다
50 50
51> **[Code Review 비용 및 사용량](/docs/ko/code-review-costs.md)**51> **[Code Review 비용 및 사용량](https://code.claude.com/docs/ko/code-review-costs.md)**
52>52>
53> 리뷰 청구 방식을 확인하고, 지출을 추정하고, 월간 지출 한도를 설정하고, 리뷰 활동을 추적합니다53> 리뷰 청구 방식을 확인하고, 지출을 추정하고, 월간 지출 한도를 설정하고, 리뷰 활동을 추적합니다
54 54
55## 리뷰 작동 방식55## 리뷰 작동 방식
56 56
57기본적으로 Code Review는 정확성에 중점을 둡니다. 형식 선호나 누락된 테스트 범위가 아니라 프로덕션을 중단시킬 버그입니다. 플래그되는 항목을 변경하려면 저장소에 [지침 파일을 추가](/docs/ko/code-review-customize.md)하십시오.57기본적으로 Code Review는 정확성에 중점을 둡니다. 형식 선호나 누락된 테스트 범위가 아니라 프로덕션을 중단시킬 버그입니다. 플래그되는 항목을 변경하려면 저장소에 [지침 파일을 추가](https://code.claude.com/docs/ko/code-review-customize.md)하십시오.
58 58
59리뷰는 Anthropic 인프라에서 네 단계로 실행됩니다:59리뷰는 Anthropic 인프라에서 네 단계로 실행됩니다:
60 60
66각 리뷰는 풀 리퀘스트에 다음을 남깁니다:66각 리뷰는 풀 리퀘스트에 다음을 남깁니다:
67 67
68* **결과**: 해당 라인의 인라인 댓글과 리뷰 본문의 요약68* **결과**: 해당 라인의 인라인 댓글과 리뷰 본문의 요약
69* **확인 실행**: 이름은 **Claude Code Review**이며, 결과가 [세부 정보](/docs/ko/code-review-pull-requests.md#check-run-output)에 나열됩니다. 확인 실행은 실패로 종료되지 않습니다.69* **확인 실행**: 이름은 **Claude Code Review**이며, 결과가 [세부 정보](https://code.claude.com/docs/ko/code-review-pull-requests.md#check-run-output)에 나열됩니다. 확인 실행은 실패로 종료되지 않습니다.
70* **아무것도 찾지 못한 경우**: 확인 실행의 제목이 **Code review found no issues**로 표시되며, Claude가 풀 리퀘스트에 같은 내용의 짧은 메모를 게시합니다70* **아무것도 찾지 못한 경우**: 확인 실행의 제목이 **Code review found no issues**로 표시되며, Claude가 풀 리퀘스트에 같은 내용의 짧은 메모를 게시합니다
71 71
72Code Review는 리뷰가 실행될 Claude 모델을 선택하며, 관리자 설정에서는 모델 선택을 제공하지 않습니다. 리뷰를 더 철저하게 또는 덜 철저하게 하려면 [리뷰 수준](#review-levels)을 변경하십시오.72Code Review는 리뷰가 실행될 Claude 모델을 선택하며, 관리자 설정에서는 모델 선택을 제공하지 않습니다. 리뷰를 더 철저하게 또는 덜 철저하게 하려면 [리뷰 수준](#review-levels)을 변경하십시오.
73 73
74Owner가 Code Review를 켜면 각 저장소에는 [리뷰 실행 시기](/docs/ko/code-review-setup.md#set-when-reviews-run)에 대한 설정이 있습니다. 풀 리퀘스트가 열릴 때 한 번, 모든 푸시 후, 또는 요청 시에만 실행됩니다. 어떤 설정이든 저장소에 대한 쓰기 권한이 있는 사용자는 풀 리퀘스트에 `@claude review`를 댓글로 작성하여 [리뷰를 시작](/docs/ko/code-review-pull-requests.md#comment-commands)할 수 있습니다.74Owner가 Code Review를 켜면 각 저장소에는 [리뷰 실행 시기](https://code.claude.com/docs/ko/code-review-setup.md#set-when-reviews-run)에 대한 설정이 있습니다. 풀 리퀘스트가 열릴 때 한 번, 모든 푸시 후, 또는 요청 시에만 실행됩니다. 어떤 설정이든 저장소에 대한 쓰기 권한이 있는 사용자는 풀 리퀘스트에 `@claude review`를 댓글로 작성하여 [리뷰를 시작](https://code.claude.com/docs/ko/code-review-pull-requests.md#comment-commands)할 수 있습니다.
75 75
76### 리뷰 수준76### 리뷰 수준
77 77
81* **Standard**: 깊이, 속도, 비용의 균형을 맞춥니다. 기본 수준입니다.81* **Standard**: 깊이, 속도, 비용의 균형을 맞춥니다. 기본 수준입니다.
82* **Deep**: 가장 철저한 검토입니다. 시간이 가장 오래 걸리고 비용이 가장 많이 듭니다.82* **Deep**: 가장 철저한 검토입니다. 시간이 가장 오래 걸리고 비용이 가장 많이 듭니다.
83 83
84Owner는 [조직에 대해 하나의 수준을 선택](/docs/ko/code-review-setup.md#set-the-default-review-level)하고, 일상적인 코드베이스에는 Quick, 중요한 코드베이스에는 Deep처럼 개별 저장소에 별도의 수준을 지정할 수 있습니다. 각 리뷰의 비용에 영향을 주는 다른 요인은 [Code Review 비용 및 사용량](/docs/ko/code-review-costs.md)을 참조하십시오.84Owner는 [조직에 대해 하나의 수준을 선택](https://code.claude.com/docs/ko/code-review-setup.md#set-the-default-review-level)하고, 일상적인 코드베이스에는 Quick, 중요한 코드베이스에는 Deep처럼 개별 저장소에 별도의 수준을 지정할 수 있습니다. 각 리뷰의 비용에 영향을 주는 다른 요인은 [Code Review 비용 및 사용량](https://code.claude.com/docs/ko/code-review-costs.md)을 참조하십시오.
85 85
86### 리뷰가 액세스할 수 있는 항목86### 리뷰가 액세스할 수 있는 항목
87 87
88리뷰는 Owner가 [설정 중에 설치](/docs/ko/code-review-setup.md#turn-on-code-review)한 Claude GitHub App을 통해 저장소에 접근합니다:88리뷰는 Owner가 [설정 중에 설치](https://code.claude.com/docs/ko/code-review-setup.md#turn-on-code-review)한 Claude GitHub App을 통해 저장소에 접근합니다:
89 89
90* **실행 위치**: Anthropic 인프라의 관리형 환경에서 실행됩니다. 리뷰는 [자체 호스팅 환경](/docs/ko/self-hosted-environments)에서 실행되지 않습니다.90* **실행 위치**: Anthropic 인프라의 관리형 환경에서 실행됩니다. 리뷰는 [자체 호스팅 환경](https://code.claude.com/docs/ko/self-hosted-environments)에서 실행되지 않습니다.
91* **읽고 쓰는 항목**: 리뷰 내에서 저장소에 대한 액세스는 읽기 전용이며, 리뷰는 커밋을 푸시하지 않습니다. 풀 리퀘스트에서는 댓글과 [확인 실행](/docs/ko/code-review-pull-requests.md#check-run-output)을 게시하고, 자신의 이전 댓글 스레드를 해결하며, 댓글 명령에 👀로 반응할 수 있습니다. 앱 자체는 다른 Claude 기능과 공유하는 [더 광범위한 권한 집합](/docs/ko/github-actions.md#github-app-permissions)을 보유합니다.91* **읽고 쓰는 항목**: 리뷰 내에서 저장소에 대한 액세스는 읽기 전용이며, 리뷰는 커밋을 푸시하지 않습니다. 풀 리퀘스트에서는 댓글과 [확인 실행](https://code.claude.com/docs/ko/code-review-pull-requests.md#check-run-output)을 게시하고, 자신의 이전 댓글 스레드를 해결하며, 댓글 명령에 👀로 반응할 수 있습니다. 앱 자체는 다른 Claude 기능과 공유하는 [더 광범위한 권한 집합](https://code.claude.com/docs/ko/github-actions.md#github-app-permissions)을 보유합니다.
92* **코드 검사 방식**: 리뷰는 코드를 빌드하거나 실행하지 않고 diff와 주변 코드를 읽는 방식으로 작동합니다.92* **코드 검사 방식**: 리뷰는 코드를 빌드하거나 실행하지 않고 diff와 주변 코드를 읽는 방식으로 작동합니다.
93 93
94### 리뷰를 제어하는 주체94### 리뷰를 제어하는 주체
95 95
96* **시작할 수 있는 사람**: 리뷰가 자동으로 실행되는 경우, 풀 리퀘스트를 열거나 푸시하면 리뷰가 시작됩니다. 단, [초안과 포크는 예외](/docs/ko/code-review-pull-requests.md#review-drafts-and-pull-requests-from-forks)입니다. 일부 푸시 후에는 Code Review가 리뷰를 시작하는 대신 [이전 결과를 유지](/docs/ko/code-review-pull-requests.md#when-a-push-keeps-the-earlier-result)합니다. [댓글 명령](/docs/ko/code-review-pull-requests.md#comment-commands)은 저장소에 대한 쓰기 권한이 있는 사람이 작성한 경우에만 리뷰를 시작합니다.96* **시작할 수 있는 사람**: 리뷰가 자동으로 실행되는 경우, 풀 리퀘스트를 열거나 푸시하면 리뷰가 시작됩니다. 단, [초안과 포크는 예외](https://code.claude.com/docs/ko/code-review-pull-requests.md#review-drafts-and-pull-requests-from-forks)입니다. 일부 푸시 후에는 Code Review가 리뷰를 시작하는 대신 [이전 결과를 유지](https://code.claude.com/docs/ko/code-review-pull-requests.md#when-a-push-keeps-the-earlier-result)합니다. [댓글 명령](https://code.claude.com/docs/ko/code-review-pull-requests.md#comment-commands)은 저장소에 대한 쓰기 권한이 있는 사람이 작성한 경우에만 리뷰를 시작합니다.
97* **따르는 지침**: base 또는 기본 브랜치의 `REVIEW.md`를 따르며, [풀 리퀘스트 자체의 변경 사항에서는 절대 읽지 않습니다](/docs/ko/code-review-customize.md#which-branch-review-md-is-read-from).97* **따르는 지침**: base 또는 기본 브랜치의 `REVIEW.md`를 따르며, [풀 리퀘스트 자체의 변경 사항에서는 절대 읽지 않습니다](https://code.claude.com/docs/ko/code-review-customize.md#which-branch-review-md-is-read-from).
98 98
99## 리뷰를 받는 방법 비교99## 리뷰를 받는 방법 비교
100 100
103| 옵션 | 리뷰를 시작하는 방법 | 실행 위치 | 사용 가능 대상 |103| 옵션 | 리뷰를 시작하는 방법 | 실행 위치 | 사용 가능 대상 |
104| :- | :- | :- | :- |104| :- | :- | :- | :- |
105| [Code Review](#how-reviews-work) | 각 저장소 설정에 따른 풀 리퀘스트 활동 또는 `@claude review` 댓글 | Anthropic 인프라 | Owner가 켠 후, GitHub 저장소를 보유한 Team 또는 Enterprise 플랜의 조직 |105| [Code Review](#how-reviews-work) | 각 저장소 설정에 따른 풀 리퀘스트 활동 또는 `@claude review` 댓글 | Anthropic 인프라 | Owner가 켠 후, GitHub 저장소를 보유한 Team 또는 Enterprise 플랜의 조직 |
106| [`/code-review`](/docs/ko/code-review-local) | 브랜치에서 명령을 실행 | Claude Code 세션 | 모든 플랜의 모든 사용자 |106| [`/code-review`](https://code.claude.com/docs/ko/code-review-local) | 브랜치에서 명령을 실행 | Claude Code 세션 | 모든 플랜의 모든 사용자 |
107| [Ultrareview](/docs/ko/ultrareview.md) | Claude Code에서 시작 | 클라우드 샌드박스 | claude.ai 계정으로 로그인해야 합니다. 사용할 수 없는 환경은 [Ultrareview](/docs/ko/ultrareview.md)를 참조하십시오 |107| [Ultrareview](https://code.claude.com/docs/ko/ultrareview.md) | Claude Code에서 시작 | 클라우드 샌드박스 | claude.ai 계정으로 로그인해야 합니다. 사용할 수 없는 환경은 [Ultrareview](https://code.claude.com/docs/ko/ultrareview.md)를 참조하십시오 |
108| [GitHub Actions](/docs/ko/github-actions.md) 또는 [GitLab CI/CD](/docs/ko/gitlab-ci-cd.md)를 사용한 자체 CI의 Claude | 모든 풀 리퀘스트 또는 merge request와 같은 파이프라인 이벤트 | 자체 CI 러너 | GitHub 또는 GitLab에서 Claude API 키 또는 클라우드 제공업체 자격 증명이 있는 모든 사용자 |108| [GitHub Actions](https://code.claude.com/docs/ko/github-actions.md) 또는 [GitLab CI/CD](https://code.claude.com/docs/ko/gitlab-ci-cd.md)를 사용한 자체 CI의 Claude | 모든 풀 리퀘스트 또는 merge request와 같은 파이프라인 이벤트 | 자체 CI 러너 | GitHub 또는 GitLab에서 Claude API 키 또는 클라우드 제공업체 자격 증명이 있는 모든 사용자 |
109| [서브에이전트](/docs/ko/sub-agents.md) 또는 [스킬](/docs/ko/skills.md)로 만든 자체 리뷰어 | 세션 중에 사용자 또는 Claude가 호출 | Claude Code를 실행하는 모든 위치 | 직접 작성하는 모든 사용자 |109| [서브에이전트](https://code.claude.com/docs/ko/sub-agents.md) 또는 [스킬](https://code.claude.com/docs/ko/skills.md)로 만든 자체 리뷰어 | 세션 중에 사용자 또는 Claude가 호출 | Claude Code를 실행하는 모든 위치 | 직접 작성하는 모든 사용자 |
110 110
111## 관련 리소스111## 관련 리소스
112 112
113* [GitHub Enterprise Server](/docs/ko/github-enterprise-server.md): 자체 호스팅 GitHub 인스턴스에서 Code Review를 사용합니다113* [GitHub Enterprise Server](https://code.claude.com/docs/ko/github-enterprise-server.md): 자체 호스팅 GitHub 인스턴스에서 Code Review를 사용합니다
114* [GitHub App 권한](/docs/ko/github-actions.md#github-app-permissions): Claude GitHub App이 요청하는 전체 권한 집합114* [GitHub App 권한](https://code.claude.com/docs/ko/github-actions.md#github-app-permissions): Claude GitHub App이 요청하는 전체 권한 집합
115* [How Anthropic secures its AI-native software development lifecycle](https://claude.com/blog/how-anthropic-secures-its-ai-native-software-development-lifecycle): 자동화된 리뷰가 Anthropic의 안전한 개발 프로세스의 한 계층으로 어떻게 적합한지에 대한 설명115* [How Anthropic secures its AI-native software development lifecycle](https://claude.com/blog/how-anthropic-secures-its-ai-native-software-development-lifecycle): 자동화된 리뷰가 Anthropic의 안전한 개발 프로세스의 한 계층으로 어떻게 적합한지에 대한 설명
