GitHub Copilot 자동 코드 리뷰 설정

풀 요청을 검토하도록 Copilot을 설정합니다.
소개
Copilot 코드 리뷰를 구성해 풀 요청을 자동으로 검토할 수 있으며, Copilot 리뷰 강도도 설정할 수 있습니다. 개요는 GitHub Copilot 코드 리뷰 정보 를 참고하세요.
본인 풀 요청에 대한 자동 코드 리뷰 구성
Copilot 코드 리뷰를 사용할 수 있는 어떤 저장소에서든, 본인이 생성한 풀 요청을 Copilot 코드 리뷰가 검토하도록 설정할 수 있습니다.
참고
자동 코드 리뷰 구성은 Copilot Pro, Copilot Pro+, Copilot Max 요금제와 Copilot Business 또는 Copilot Enterprise 라이선스에서 사용할 수 있습니다. 관리형 사용자 계정에서는 사용할 수 없습니다.
- GitHub의 어떤 페이지에서든 오른쪽 상단 모서리에서 프로필 사진을 클릭한 다음 Copilot 설정 을 클릭합니다.
- 사이드바에서 Copilot 아래의 코드 리뷰 를 클릭합니다.
- Copilot 자동 코드 리뷰 를 사용 설정합니다.
- 선택 사항: Copilot이 이미 검토 중인 풀 요청에 대해 새 푸시가 있을 때마다 검토하려면 새 푸시 검토 를 사용 설정합니다.
- 선택 사항: 풀 요청이 아직 초안 상태일 때 검토하려면 초안 풀 요청 검토 를 사용 설정합니다.
풀 요청은 사용자 설정, 저장소 규칙 집합, 조직 규칙 집합 등 여러 독립적인 소스에서 자동 검토 대상이 될 수 있습니다. 이러한 소스는 각각 별도로 평가됩니다. 둘 이상이 적용되더라도 Copilot은 검토를 한 번만 게시합니다. 사용자 설정으로는 규칙 집합에서 사용 설정한 푸시 또는 초안 검토를 끌 수 없습니다. 자세한 내용은 GitHub Copilot 코드 리뷰 정보 를 참고하세요.
Copilot 리뷰 강도 구성
요청한 리뷰에 Copilot 코드 리뷰가 사용할 Copilot 리뷰 강도를 선택할 수 있습니다. 선택한 값은 자동 리뷰와 수동으로 요청하는 리뷰 모두에 적용됩니다. 수준과 Copilot이 어떤 수준을 사용할지 결정하는 방식에 대한 개요는 GitHub Copilot 코드 리뷰 정보 를 참고하세요.
- GitHub의 어떤 페이지에서든 오른쪽 상단 모서리에서 프로필 사진을 클릭한 다음 Copilot 설정 을 클릭합니다.
- 사이드바에서 Copilot 아래의 코드 리뷰 를 클릭합니다.
- "리뷰 강도 수준" 옆에서 요청한 리뷰에 사용할 Copilot 리뷰 강도를 선택합니다. Lite : 표준 리뷰.
- Balanced : 복잡한 로직, 보안에 민감한 코드, 서비스 간 변경에 대한 더 깊은 분석.
- Max : 가장 철저한 리뷰. 이 옵션은 곧 제공 예정 레이블과 함께 표시되며 아직 사용할 수 없습니다.
기본 내장값으로 돌아가려면 메뉴 맨 위의 Default 옵션을 선택합니다. 특정 수준을 선택하기 전까지는 컨트롤에 내장 기본값인 Default (Balanced) 가 표시됩니다.
Copilot 리뷰 강도는 Copilot 자동 코드 리뷰 와는 별개입니다. 자동 리뷰를 끄더라도 Copilot 리뷰 강도는 지워지지 않으며, 사용자가 수동으로 요청한 리뷰에 계속 적용됩니다.
저장소에 대한 자동 코드 리뷰 구성
저장소에 대해 자동 코드 리뷰를 사용 설정하고 코드 리뷰가 수행되는 방식을 사용자 지정할 수 있습니다.
자동 리뷰 사용 설정
- GitHub에서 저장소의 메인 페이지로 이동합니다.
- 왼쪽 사이드바의 "Code, planning, and automation" 아래에서 Rulesets 를 클릭한 다음 Rulesets 를 클릭합니다.
- New ruleset 을 클릭합니다.
- New branch ruleset 을 클릭합니다.
- "Ruleset name" 아래에 규칙 집합 이름을 입력합니다.
- 규칙 집합을 활성화하려면 "Enforcement Status" 아래에서 Active 를 선택합니다.
- "Target branches" 아래에서 Add target 을 클릭하고 예를 들어 Include default branch 또는 Include all branches 와 같은 옵션 중 하나를 선택합니다.
- "Target branches" 아래에서 Add target 을 클릭하고 대상 옵션 중 하나를 선택합니다.
- "Branch rules" 아래에서 Automatically request Copilot code review 를 선택합니다.
- 선택 사항: Copilot이 풀 요청에 대한 모든 새 푸시를 검토하게 하려면 Review new pushes 를 선택합니다. 이 옵션을 선택하지 않으면 Copilot은 풀 요청을 한 번만 검토합니다.
- 선택 사항으로, Copilot이 풀 요청이 아직 초안 상태일 때도 검토하도록 하려면 Review draft pull requests 를 선택합니다. 이는 사람에게 검토를 요청하기 전에 오류를 조기에 잡아내는 데 유용할 수 있습니다.
- 페이지 하단에서 Create 를 클릭합니다.
Copilot 코드 리뷰 사용자 지정
리포지토리에서 Copilot 코드 리뷰가 코드 리뷰를 완료하는 방식을 구성할 수 있습니다.
- GitHub에서 리포지토리의 메인 페이지로 이동합니다.
- 사이드바의 "Code, planning, and automation" 아래에서 Copilot 을 클릭한 다음 Code review 를 클릭합니다.
- Copilot 코드 리뷰의 깊이를 선택하려면 "Review effort level" 옆에서 이 리포지토리의 자동 리뷰에 사용할 effort level을 선택합니다. Lite : 표준 리뷰.
- Balanced : 복잡한 로직, 보안에 민감한 코드, 그리고 서비스 간 변경 사항에 대한 더 깊은 분석.
Balanced 리뷰는 더 많은 AI 크레딧을 사용하며, GitHub Actions 분을 약간 더 사용할 수 있습니다. About GitHub Copilot code review 를 참조하세요.
- Copilot이 리포지토리에서 풀 요청을 승인할 수 있는지 선택하려면 "Auto-approval" 아래에서 설정합니다. Allow Copilot to approve pull requests : Copilot이 승인 검토를 제출할 수 있도록 토글을 켭니다.
- Allow Copilot approvals to count toward merge requirements : Copilot 승인으로 풀 요청 승인 요구 사항을 충족할 수 있도록 토글을 켭니다.
- File paths : 선택 사항으로, 어떤 풀 요청이 merge requirements에 포함될지 제한합니다. 모든 변경된 파일이 글롭 중 하나와 일치하는 풀 요청만 승인이 집계되도록, 줄마다 하나의 파일 글롭을 입력합니다. 모든 파일에 대한 승인을 집계하려면 비워 둡니다. 최대 15개의 글롭을 지원합니다.
참고
Copilot 승인은 공개 프리뷰 상태이며 변경될 수 있습니다.
조직의 리포지토리에 대한 자동 코드 리뷰 구성
조직의 리포지토리에서 자동 코드 리뷰를 활성화하고 코드 리뷰 수행 방식을 사용자 지정할 수 있습니다.
자동 리뷰 활성화
- GitHub 오른쪽 상단에서 프로필 사진을 클릭한 다음 Organizations 를 클릭합니다.
- 조직을 클릭하여 선택합니다.
- 사이드바의 "Code, planning, and automation" 아래에서 Repository 를 클릭한 다음 Rulesets 를 클릭합니다.
- New ruleset 을 클릭합니다.
- New branch ruleset 을 클릭합니다.
- "Ruleset name" 아래에 ruleset 이름을 입력합니다.
- ruleset을 활성화하려면 "Enforcement Status" 아래에서 Active 를 선택합니다.
- "Target repositories" 아래에서 Add target 을 클릭하고 Include by pattern 또는 Exclude by pattern 중 하나를 선택합니다.
- 대상이 될 리포지토리 이름과 일치하는 패턴을 입력합니다. 예를 들어 이름이
feature로 끝나는 모든 리포지토리를 일치시키려면*feature를 사용합니다. 패턴 일치 구문은 Creating rulesets for repositories in your organization 를 참조하세요.
- Add inclusion pattern 또는 Add exclusion pattern 을 클릭합니다.
- 추가 패턴이 있으면 반복합니다. 참고 동일한 ruleset에 여러 대상 지정 기준을 추가할 수 있습니다. 제외 패턴은 포함 패턴 다음에 적용됩니다. 예를 들어
*cat*패턴과 일치하는 리포지토리를 포함한 다음,not-a-cat패턴과 일치하는 리포지토리는 명시적으로 제외할 수 있습니다.
- "Target branches" 아래에서 Add target 을 클릭하고 대상 옵션 중 하나를 선택합니다.
- "Branch rules" 아래에서 Automatically request Copilot code review 를 선택합니다.
- 선택 사항으로, Copilot이 풀 요청에 대한 모든 새 푸시를 검토하도록 하려면 Review new pushes 를 선택합니다. 이 옵션을 선택하지 않으면 Copilot은 풀 요청을 한 번만 검토합니다.
- 선택 사항으로, Copilot이 풀 요청이 아직 초안 상태일 때도 검토하도록 하려면 Review draft pull requests 를 선택합니다. 이는 사람의 검토를 요청하기 전에 오류를 조기에 발견하는 데 유용할 수 있습니다.
- 페이지 하단에서 Create 를 클릭합니다.
Copilot 코드 검토 사용자 지정
조직의 저장소에서 Copilot code review가 코드 검토를 완료하는 방식을 구성할 수 있습니다.
- GitHub 오른쪽 위 모서리에서 프로필 사진을 클릭한 다음 Organizations 를 클릭합니다.
- 조직을 클릭하여 선택합니다.
- 사이드바에서 "Code, planning, and automation" 아래의 Copilot 을 클릭한 다음 Code review 를 클릭합니다.
- Copilot code review의 검토 깊이를 선택하려면 "Review effort level" 옆에서 조직의 저장소에 대한 자동 검토 기본 노력 수준을 선택합니다. Lite : 표준 검토.
- Balanced : 복잡한 로직, 보안에 민감한 코드, 서비스 간 변경 사항에 대한 더 깊은 분석.
Balanced 검토는 더 많은 AI 크레딧을 사용하며, GitHub Actions 분을 약간 더 소모할 수 있습니다. About GitHub Copilot code review 를 참조하세요.
- Copilot이 저장소의 풀 요청을 승인할 수 있게 할지 선택하려면 "Approvals" 아래에서 "Count Copilot approvals toward merge requirements" 옆의 옵션을 선택합니다. Enabled everywhere : Copilot 승인은 조직의 모든 저장소에서 병합 요구 사항에 반영될 수 있습니다.
- Let repositories decide : 저장소 관리자가 저장소 설정에서 이 항목을 결정할 수 있습니다.
- Enable for selected repositories : Copilot 승인은 선택한 저장소에서만 병합 요구 사항에 반영될 수 있습니다. 이 옵션을 선택한 경우, 활성화할 저장소도 지정하세요.
- Disabled everywhere : 조직의 어떤 저장소에서도 Copilot 승인은 병합 요구 사항에 반영될 수 없습니다.
참고
Copilot 승인은 공개 미리 보기이며 변경될 수 있습니다.
엔터프라이즈에서 자동 코드 검토 구성
엔터프라이즈에서 자동 코드 검토를 사용하도록 설정하고, 코드 검토가 수행되는 방식을 사용자 지정할 수 있습니다.
자동 검토 사용 설정
- 엔터프라이즈 수준 브랜치 규칙 집합을 만듭니다. 규칙 집합으로 엔터프라이즈에서 코드 거버넌스 강제 적용 을 참조하세요.
- Copilot code review가 자동으로 실행되어야 하는 조직과 저장소를 대상으로 지정합니다.
- Automatically request Copilot code review 정책을 사용 설정합니다.
- 선택 사항으로, 초안 풀 요청과 각 푸시 후의 자동 검토를 사용 설정합니다.
- Create 를 클릭합니다.
Copilot 코드 검토 사용자 지정
엔터프라이즈의 Copilot code review가 코드 검토를 완료하는 방식을 구성할 수 있습니다.
- GitHub에서 엔터프라이즈로 이동합니다. 예를 들어 GitHub.com의 Enterprises 페이지에서 이동할 수 있습니다.
- 페이지 상단에서 AI controls 를 클릭합니다.
- "Available Agents"까지 아래로 스크롤한 다음 Copilot code review 를 클릭합니다.
- "Copilot code review" 옆에서 정책을 선택합니다.
- 그런 다음 엔터프라이즈에서 사용하도록 설정할 Copilot code review 기능을 선택합니다.
- 조직에서 Copilot이 풀 요청을 승인할 수 있게 할지 선택하려면 "Allow Copilot to approve pull requests" 옆에서 정책을 선택합니다. Let organizations decide : 조직 소유자가 Copilot 승인을 사용하도록 설정할지 여부를 선택할 수 있습니다.
- Enable for selected organizations : 선택한 조직에서만 Copilot 승인이 사용 설정됩니다.
- Disabled everywhere : 조직은 Copilot 승인을 사용 설정할 수 없습니다. 기본값입니다.
참고
Copilot 승인은 공개 미리 보기이며 변경될 수 있습니다.
출처
- 원문: https://docs.github.com/copilot/how-tos/copilot-on-github/set-up-copilot/configure-code-review (2026-10-07 · docs.github.com)

