서문
Copilot 코드 검토는 모든 언어로 작성된 코드를 검토하고 피드백을 제공합니다. 여러 각도에서 코드를 검토하여 문제를 식별하고 수정 사항을 제안합니다. 몇 번의 클릭으로 제안된 변경 내용을 적용할 수 있습니다.
본 문서에서는 Copilot 코드 검토의 개요를 제공합니다. Copilot에서 코드 검토를 요청하는 방법을 알아보려면 GitHub Copilot 코드 검토 사용을 참조하세요.
가용성
Copilot 코드 검토는 다음 환경에서 지원합니다.
- GitHub.com
- GitHub Mobile
- 변수 variables.product.prodname_vscode_shortname %}
- 자료 변수.product.prodname_vs %}
- Xcode
- JetBrains IDE
Copilot 코드 검토는 다음 플랜에서 사용할 수 있는 프리미엄 기능입니다.
-
Copilot Pro
-
보조 파일럿 Pro+
-
코파일럿 사업
-
Copilot Enterprise
[Copilot 플랜을 확인하세요](https://github.com/features/copilot/plans?ref_product=copilot&ref_type=purchase&ref_style=text).
조직에서 Copilot를 수신하는 경우, 조직은 Copilot 정책 설정 내에서 Copilot 코드 검토 옵션을 활성화해야 합니다. GitHub.com 또는 GitHub Mobile에 관한 검토에 적용됩니다. 조직에서 GitHub Copilot에 대한 정책 및 기능 관리을(를) 참조하세요.
Copilot 라이선스 미포함 Copilot 코드 검토
**Copilot 라이선스가 없는** 조직 구성원은 GitHub.com에 Copilot 코드 검토를 사용할 수 있습니다. 엔터프라이즈 관리자 또는 조직 소유자가 사용하도록 설정해야 합니다. 이 기능은 **코파일럿 사업** 및 **Copilot Enterprise** 플랜을 사용하는 조직에서 사용할 수 있습니다.
라이선스가 없는 사용자를 위한 코드 검토 활성화
Copilot 라이선스가 없는 조직 구성원이 Copilot 코드 검토를 사용하도록 허용하기 위해서는 다음 두 가지 정책을 활성화해야 합니다.
-
**프리미엄 요청의 유료 사용량**입니다. 먼저 이 정책을 사용하도록 설정합니다. 이를 통해 엔터프라이즈 또는 조직에서 Copilot 코드 검토 프리미엄 요청 사용량에 대한 요금이 부과됩니다. -
**Copilot 라이선스가 없는 구성원이 GitHub.com에서 Copilot 코드 검토를 사용하도록 허용합니다**. 이러한 하위정책은 라이선스가 없는 사용자를 위해 Copilot 코드 검토를 활성화합니다.
두 번째 정책에는 다음과 같은 특징이 있습니다.
- 기본적으로 사용하지 않도록 설정되어 있습니다.
- 이 정책이 엔터프라이즈 수준에서 설정되면 표시되지만 조직 수준에서는 편집할 수 없게 됩니다.
- 정책이 가장 제한적입니다. Copilot 코드 검토는 정책을 명시적으로 활성화한 리포지토리에서만 사용할 수 있습니다.
라이선스가 없는 사용자에 대해 작동하는 방식
두 정책을 모두 활성화하면 Copilot 라이선스가 없는 사용자는 조직 리포지토리의 풀 요청에 대해 Copilot 코드 검토로부터 검토를 요청할 수 있습니다.
자동 코드 검토를 사용하는 리포지토리에서 Copilot은(는) 모든 끌어오기 요청을 자동으로 검토합니다. 작성자에게 Copilot 라이선스가 있는지 여부에 관계없이 이 현상은 발생합니다.
라이선스가 없는 사용자는 Copilot 코드 검토을(를) IDE에서 사용할 수 없습니다.
제외된 파일
일부 파일 유형은 Copilot 코드 검토에서 제외됩니다.
- package.json 및 Gemfile.lock과 같은 종속성 관리 파일
- 로그 파일
- SVG 파일
이러한 파일 형식을 풀 요청에 포함하면 Copilot 코드 검토가 파일을 검토하지 않습니다.
자세한 내용은 GitHub Copilot 코드 검토에서 제외된 파일을(를) 참조하세요.
Copilot 코드 검토에 대한 에이전트 기능
참고
- Copilot 코드 검토에는 공개 미리 보기에 있으며 변경될 수 있는 기능이 있습니다. GitHub 시험판 사용 조건 미리 보기 기능 사용에 적용됩니다.
Copilot 코드 검토는 에이전트 기능을 활용하여 기능을 확장합니다.
-
**전체 프로젝트 컨텍스트 수집**. 이렇게 하면 보다 구체적이고 정확하며 상황에 맞는 인식 코드 검토를 제공합니다. 이 기능은 전체 리포지토리를 분석하여 코드 변경의 컨텍스트를 더 잘 이해합니다. 전체 프로젝트 컨텍스트 수집은 일반적으로 사용할 수 있습니다. -
**Copilot 코딩 도우미에 제안을 전달하는 기능**. 이렇게 하면 제안된 수정 사항이 적용된 분기에 대해 새 끌어오기 요청을 자동으로 만듭니다. Copilot 코딩 도우미에 제안을 전달하는 기능은 공개 프리뷰 상태이며 변경될 수 있습니다.
이러한 기능은 Copilot Pro 또는 보조 파일럿 Pro+ 플랜에 대해 자동으로 활성화됩니다.
GitHub Actions을 사용할 수 없거나 Copilot 코드 검토에서 사용하는 작업 워크플로우가 실패하더라도 여전히 검토가 생성됩니다. 그러나 에이전트 기능에서 제공하는 추가 기능은 포함되지 않습니다.
코드 검토에서 에이전트 기능에 대한 GitHub Actions 실행기 사용
Copilot 코드 검토는 GitHub Actions에서 무료 시간을 사용하여, 전체 프로젝트 컨텍스트 수집 및 공개 미리 보기의 모든 기능을 포함하는 자동 기능을 실행합니다. 기본 설정으로 Copilot 코드 검토는 GitHub에서 호스팅된 실행기를 사용합니다.
코드 검토에서 에이전트 기능을 사용하려면 조직이나 기업에서 GitHub Actions을(를) 사용하도록 설정할 필요가 없습니다.
조직에서 GitHub호스티드 실행기를 비활성화한 경우 실행기가 제공하는 에이전트 기능을 사용할 수 없습니다. 이 경우 코드 검토는 더 제한된 검토로 대체됩니다.
이 상황에서 조직은 자체 호스팅 실행기를 사용할 수 있습니다. 자세한 내용은 GitHub Copilot 코드 검토를 위해 자체 호스팅 러너 구성을(를) 참조하세요.
코드 검토 월별 할당량
Copilot가 풀 요청을 검토하거나 IDE에서 코드를 검토할 때마다 Copilot 프리미엄 요청의 월별 할당량이 1씩 감소합니다.
모든 새 끌어오기 요청에 대해 Copilot에서 코드 검토를 자동으로 요청하도록 리포지토리가 구성된 경우 프리미엄 요청 사용량이 끌어오기 요청 작성자의 할당량에 적용됩니다.
GitHub Actions 또는 봇이 풀 요청을 생성하는 경우, 사용 정책이 다음에 적용됩니다.
- 해당 사용자를 식별할 수 있는 경우 워크플로를 트리거한 사용자입니다.
- 지정된 청구서 소유자입니다.
할당량에 도달하면 어떻게 되나요?
월별 할당량에 도달하면 할당량이 재설정될 때까지 Copilot에서 코드 검토를 받을 수 없습니다. 할당량이 리셋되기 전에 계속 코드 검토를 사용하려면 Copilot 플랜을 업그레이드하거나 추가 프리미엄 요청을 활성화해야 합니다.
Copilot 라이선스가 없는 사용자에 대한 할당량
Copilot 라이선스가 없는 사용자는 월별 프리미엄 요청 할당량이 없습니다. 이러한 사용자에 대해 Copilot 코드 검토을(를) 사용하도록 설정하면 생성하는 프리미엄 요청은 유료 초과분 사용량으로 조직 또는 기업에 직접 청구됩니다. 이는 수동으로 요청된 검토 및 자동 코드 검토 모두에 적용됩니다.
라이선스가 없는 사용자가 생성한 프리미엄 요청은 Copilot 계획 할당량에 기인하지 않습니다. 청구 보고서 및 프리미엄 요청 분석에서 초과분 사용량으로 표시됩니다. Copilot 라이선스가 있는 사용자는 할당된 플랜 할당량에서 프리미엄 요청을 계속 사용합니다.
모델 사용
Copilot 코드 검토는 다양한 codebases에서 일관되고 고품질의 피드백을 제공하기 위해 신중하게 조정된 모델, 프롬프트, 시스템 동작을 조합하여 설계된 특수 목적의 제품입니다. 모델 전환은 지원되지 않습니다. 모델을 변경하면 신뢰성, 사용자 환경, 검토 메모의 품질이 저하될 수 있습니다.
데이터 재사용 가능.코파일럿.ccr-모델-설정 %}
Copilot 코드 검토 유효성 검사
Copilot은 풀 요청에서 모든 문제 또는 문제 항목을 발견하도록 보장되지 않습니다. 때로는 실수를 할 것입니다. 항상 Copilot의 피드백을 신중하게 유효성 검사하세요. 사용자 검토를 통해 Copilot의 피드백을 보완합니다.
자세한 내용은 GitHub Copilot 코드 리뷰의 책임 있는 사용을(를) 참조하세요.
Copilot의 리포지토리 지식 향상시키기
Copilot에서 리포지토리의 코드, 사용하는 도구 및 코딩 표준과 관행에 대해 많이 알수록 검토가 정확하고 유용해집니다. 리포지토리에 대한 Copilot의 지식을 향상시키는 방법은 두 가지가 있습니다.
사용자 지정 지침
이러한 문은 리포지토리에 하나 이상의 파일로 작성하고 저장하는 간단한 자연어 문입니다. GitHub에서 조직의 소유자인 경우 조직의 설정에서 사용자 지정 지침을 정의할 수도 있습니다. 자세한 내용은 GitHub Copilot 응답을 사용자 지정하는 방법에 대한 정보을(를) 참조하세요.
Copilot 메모리 (공개 미리 보기)
Copilot Pro 또는 보조 파일럿 Pro+ 플랜이 있다면, Copilot 메모리를 사용하도록 설정할 수 있습니다. 이 기능을 통해 Copilot가 리포지토리에 대해 학습한 유용한 세부 정보를 저장할 수 있습니다. Copilot는 해당 리포지토리에서 풀 요청을 검토 시 이 정보를 사용할 수 있습니다. 자세한 내용은 GitHub Copilot의 주체적 기억에 관한 정보을(를) 참조하세요.
자동 풀 요청 검토에 대한 정보
기본적으로 풀 요청에 할당하는 경우에만 Copilot는 풀 요청을 검토합니다. 그러나 자동 검토를 구성할 수 있습니다.
-
Copilot Pro 또는 보조 파일럿 Pro+ 플랜을 사용 중인 **개인 사용자**는 그들이 생성한 모든 풀 요청을 자동으로 검토하도록 Copilot를 구성할 수 있습니다. -
**리포지토리 소유자**는 Copilot에 액세스를 가진 사용자가 리포지토리에 생성한 모든 풀 요청을 자동으로 검토하도록 Copilot를 구성할 수 있습니다. -
**조직 소유자는** Copilot 사용자가 풀 요청을 생성한 조직 내 모든 리포지토리에서 모든 풀 요청을 자동으로 검토하도록 Copilot를 구성할 수 있습니다.
자동 풀 요청 검토 트리거하기
자동 코드 검토를 위한 트리거는 구성 설정에 따라 달라집니다.
- 기본 설정:
- 풀 요청을 "Open" 풀 요청으로 생성할 때.
- "초안" 끌어오기 요청을 처음으로 "열기"로 전환합니다.
- 새로 푸시된 내용을 검토합니다.
- 끌어오기 요청에 새 커밋을 푸시할 때마다
- 초안 끌어오기 요청 검토:
- 끌어오기 요청은 아직 초안 상태일 때 자동으로 검토되며, "Open" 상태로 전환하기 전에 이루어집니다.
전체 지침은 GitHub Copilot에서 자동 코드 검토 구성을 참조하세요.
참고
Copilot이(가) 끌어오기 요청에 대한 각 푸시를 검토하도록 구성되지 않은 경우 끌어오기 요청은 한 번만 검토합니다. 풀 요청이 자동으로 검토되고 풀 요청을 변경하고, Copilot에서 그것을 재검토하도록 원하는 경우, 수동으로 요청할 수 있습니다. 검토자 메뉴의 Copilot 이름 옆에 버튼을 클릭합니다.
전체 리포지토리에 대한 자세한 코드 품질 피드백 가져오기
GitHub Copilot 코드 검토 끌어오기 요청에서 코드를 검토하고 피드백을 제공합니다. 전체 리포지토리의 안정성 및 유지 관리에 대한 실행 가능한 피드백을 원하는 경우 GitHub Code Quality를 사용하도록 설정합니다. GitHub 코드 품질 정보을(를) 참조하세요.
추가 참고 자료
-
[AUTOTITLE](/copilot/how-tos/agents/copilot-code-review/using-copilot-code-review)