# GitHub Code Quality 사용
Code Quality을 켜서 풀 리퀘스트와 기본 브랜치에서 코드 품질 문제를 자동으로 감지, 수정 및 보고하여 팀 전체에 일관된 품질 기준을 제공하세요.
단일 리포지토리 또는 조직의 모든 리포지토리에 대해 한 번에 사용하도록 설정할 Code Quality 수 있습니다. 조직 수준에서 활성화하면 한 번의 변경만으로 모든 팀에 일관된 품질 기준을 적용할 수 있고, 리포지토리별로 활성화하면 특정 프로젝트를 대상으로 하거나 점진적으로 적용할 수 있습니다.
## 필수 조건
* 엔터프라이즈 소유자가 귀하의 엔터프라이즈에서 Code Quality를 허용해 두어야 합니다.
[엔터프라이즈에서 GitHub Code Quality 사용 허용](/ko/code-security/how-tos/secure-at-scale/configure-enterprise-security/configure-specific-tools/allow-github-code-quality-in-enterprise)을(를) 참조하세요.
* GitHub Actions에서 작업을 사용해 각 Code Quality 분석을 실행하므로 CodeQL를 사용하도록 설정해야 합니다.
* 이 기능을 최대한 활용하려면 리포지토리에 품질 분석을 CodeQL지원하는 언어 중 하나가 포함되어야 합니다.
[지원되는 언어를 참조하세요](/ko/code-security/concepts/code-quality/code-quality#supported-languages).
## 리포지토리에서 Code Quality 활성화하기
1. GitHub에서 리포지토리의 기본 페이지로 이동합니다.
2. 리포지토리 이름 아래에서 ** Settings**를 클릭합니다. "설정" 탭이 표시되지 않으면 **** 드롭다운 메뉴를 선택한 다음 **설정**을 클릭합니다.
3. 사이드바의 "보안" 아래에서 " 코드 품질" 페이지를 표시하려면 \*\*\*\* 을 클릭합니다.
4. **코드 품질 사용을** 클릭합니다.
5. 코드 품질 페이지에서 정보를 검토합니다.
* **언어들:** 모든 언어에 대한 분석을 사용하지 않도록 설정 CodeQL 하려면 연결된 확인란의 선택을 취소합니다.
* **실행기 유형:** 다른 실행기를 사용하려면 **레이블이 지정된 실행** 기를 선택하고 **Runner 레이블**을 정의합니다.
[GitHub 호스팅 러너 사용](/ko/actions/how-tos/manage-runners/github-hosted-runners/use-github-hosted-runners) 및 [자체 호스팅 실행기로 레이블 사용](/ko/actions/how-tos/manage-runners/self-hosted-runners/apply-labels)을(를) 참조하세요.
6. **변경 내용 저장**을 클릭하여 구성을 저장합니다Code Quality.
조직에서 프라이빗 레지스트리의 캐싱을 구성한 경우 종속성을 해결하는 데 사용할 코드 품질 분석에 사용할 수 있습니다.
[프라이빗 레지스트리에 대한 보안 기능 액세스 부여](/ko/code-security/how-tos/secure-at-scale/configure-organization-security/manage-usage-and-access/giving-org-access-private-registries#code-quality-access-to-private-registries)을(를) 참조하세요.
## Code Quality을(를) 귀사 조직에 활성화합니다.
조직 수준에서 단일 Code Quality 설정을 사용하여 제어 \*\*\*\* 합니다. 이렇게 하면 모든 리포지토리에 적용하는 것부터 특정 목록이나 동적 필터만 대상으로 지정하는 것까지 세밀하게 제어할 수 있으므로, Code Quality를 의도적으로 시범 운영하고 원하는 속도에 맞춰 점진적으로 확대 적용할 수 있습니다. 선택 영역 내의 리포지토리가 활성화되고 선택 영역 외부의 리포지토리가 비활성화됩니다.
사용 가능한 액세스 옵션 및 필터링 및 적용이 작동하는 방법은 [조직 및 기업 전반의 코드 품질 활성화](/ko/code-security/concepts/code-quality/enablement-at-scale#organization-level-repository-access)을 참조하세요.
1. GitHub에서 조직의 기본 페이지로 이동합니다.
2. 조직 이름에서 ** 설정**을 클릭합니다. "설정" 탭이 표시되지 않으면 **** 드롭다운 메뉴를 선택한 다음 **설정**을 클릭합니다.
3. 사이드바의 "보안"에서 을 클릭합니다 ** 코드 품질**.
4. "리포지토리 액세스"의 드롭다운 메뉴에서 옵션을 선택합니다.
* **선택한 리포지토리를** 선택한 경우 사용하도록 설정할 리포지토리를 선택합니다.
* **필터 일치를 선택한 경우 필터를** 정의합니다.
5. 필요에 따라 리포지토리 관리자가 이러한 설정을 변경하지 못하도록 하려면 **액세스 적용**을 사용하도록 설정합니다.
6. 리포지토리에서 변경 내용을 사용하거나 사용하지 않도록 설정하면 사용 및 비활성화 Code Quality 된 리포지토리의 총 수와 관련 비용을 보여 주는 "사용 권한 및 청구 변경 내용 검토" 대화 상자가 나타납니다. 세부 정보를 검토한 다음 **확인을** 클릭합니다.
변경 내용이 자동으로 저장되고 즉시 전파되기 시작합니다. 대규모 조직에서는 변경 내용이 모든 리포지토리에 적용되는 데 몇 분 정도 걸릴 수 있습니다.
여러 팀에서 기능을 배포하는 경우 모든 곳에서 사용하도록 설정하기 전에 소규모 그룹을 파일럿하고 품질 임계값을 조정하는 것이 좋습니다.
[대규모 GitHub Code Quality 롤아웃](/ko/code-security/how-tos/maintain-quality-code/roll-out-at-scale)을(를) 참조하세요.
## 다음 단계
* **코드 검사 추가:** 테스트 도구 모음에서 보고된 코드 검사를 업로드하여 끌어오기 요청에 대한 검사 결과를 직접 확인합니다.
[리포지토리에 대한 코드 검사 설정](/ko/code-security/how-tos/maintain-quality-code/set-up-code-coverage)을(를) 참조하세요.
* **조직의 경우:** 리포지토리의 코드 상태를 한눈에 이해합니다.
[조직에서 GitHub 코드 품질 결과 살펴보기](/ko/code-security/how-tos/maintain-quality-code/explore-code-quality)을(를) 참조하세요.