# GitHub Code Quality 비용 보기 및 관리

Code Quality 요금이 정확히 어디에서 오는지 확인하고 비용을 낮추는 레버를 사용하여 지출을 예측할 수 있습니다.

Code Quality에 어떤 비용이 드는지와 활용할 수 있는 조정 수단이 무엇인지 알면 배포하기 전에 지출을 정당화할 수 있고, 이후에도 비용을 예측 가능하게 유지할 수 있습니다. 이 문서에서는 요금이 발생한 위치, 사용량을 감시하는 위치 및 비용을 절감하는 방법을 설명합니다.

## 요금이 청구되는 방식 Code Quality

Code Quality 사용량은 조직 전체의 세 가지 비용 유형에서 추가됩니다.

* **라이선스 사용량**: Code Quality이 활성화된 리포지토리의 고유한 활성 커미터 수 기준
* **GitHub Actions분**, 스캔이 실행될 때마다 차감됩니다(자체 호스팅 실행기를 사용하지 않는 한).
* **GitHub AI Credits**, Code Quality의 AI 기능에서 사용됨: 탐지 결과에 대해 생성하는 수정 사항 및 해당 페이지를 켜면 실행되는 AI 탐지 검사.

각 비용을 정확히 측정하는 방법은 [GitHub Code Quality 청구](/ko/billing/concepts/product-billing/github-code-quality?utm_campaign=code-quality-ga-july-2026\&utm_medium=docs\&utm_source=docs-view-manage-cost-billing)을 참조하세요.

확장하기 전에 GitHub Code Quality가 AI credits를 어떻게 사용하는지 이해하는 것이 중요합니다.

* Code Quality는 회원님의 **공유 AI credits 풀**에서 가져오며, 이는 모든 AI 제품(예: Copilot)이 사용하는 것과 동일한 풀입니다. 그것은 별도의 Code Quality 수당이 아닙니다.
* 이 풀은 **청구 주체** 수준에서 공유됩니다. 조직의 요금이 엔터프라이즈를 통해 청구되는 경우, Code Quality는 조직 전용 풀이 아니라 엔터프라이즈 전체 풀을 사용합니다.
* 공유 풀이 소진되면 추가 사용을 위해 정책을 구성한 방법에 따라 다음 작업이 수행됩니다. 예상치 못한 요금이 발생하지 않도록 지출이 자동으로 중단되는 엄격한 한도로 예산을 설정하세요.
* 커미터당 라이선스 요금은 별도이며 AI credits 사용의 영향을 받지 않습니다.

## 사용량을 볼 수 있는 위치

Code Quality사용량은 별도의 \*\*\*\* 미터가 아닌 Code Quality에 표시됩니다. 어디를 봐야 하는지는 필요한 분석 세분화 수준에 따라 달라집니다:

* **리포지토리별 또는 조직별 분석 내역은 "청구 및 라이선스" 탭에서 청구 사용량 보고서를 다운로드**하여 확인할 수 있습니다. 이곳은 Code Quality 지출(분 단위의 GitHub Actions 사용량 포함)을 특정 리포지토리 또는 조직에 귀속시킬 수 있는 유일한 곳입니다. UI에는 동등한 보기가 없습니다.
  [요금제 제품 및 라이선스 사용량 확인하기](/ko/billing/how-tos/products/view-productlicense-use)을(를) 참조하세요.
* **시간에 따른 사용량의 Code Quality 경우 AI creditsAI 사용량 페이지를 사용하고** 오른쪽 위에 있는 드롭다운을 사용하여 **제품**별로 그룹화합니다. 이렇게 하면 Copilot와 같은 다른 AI 제품과 Code Quality을 분리하여 풀에서 차지하는 비중을 추적할 수 있습니다. 풀 전체를 모니터링하려면 [조직 및 기업에 대한 사용량 기반 청구](/ko/copilot/concepts/billing/usage-based-billing-for-organizations-and-enterprises)을 참조하세요.

## 지출 모니터링

실행되면 Code Quality 시간이 지남에 따라 실제 사용량을 감시하여 비용을 예측할 수 있도록 합니다. 다음 두 가지를 추적합니다.

* 스캔을 실행하는 리포지토리 수에 따라 증가하는 회원님의 **GitHub Actions 분**
* **공유 AI credits 풀**로, Code Quality 다른 AI 제품과 함께 소진됩니다. 초과 사용을 방지하려면 풀 전체를 모니터링하고, Code Quality의 비중을 구체적으로 확인하려는 경우 AI 사용량 페이지를 **제품**별로 그룹화합니다.

## 비용 제어

지출을 통제할 수 있는 몇 가지 수단이 있습니다. 대략적인 영향 순서:

* **선택적으로 사용하도록 설정합니다.** 모든 리포지토리에 한 번에 적용하기보다 가치가 있는 곳에서 Code Quality를 켜세요.
  [GitHub Code Quality 사용](/ko/code-security/how-tos/maintain-quality-code/enable-code-quality)을(를) 참조하세요.
* **낮은 값 리포지토리를 사용하지 않도록 설정합니다.** 리포지토리에서 Code Quality를 비활성화하면 해당 리포지토리에만 고유한 커밋터의 라이선스가 해제되고, 스캔 및 AI 사용이 중지됩니다.
  [비활성화 GitHub Code Quality](/ko/code-security/how-tos/maintain-quality-code/disable-code-quality)을(를) 참조하세요.
* **예산을 설정합니다.**
  Code Quality에 대한 예산은 하드 스톱이 필수이기 때문에 Code Quality의 한도에 도달하면 지출이 자동으로 중단됩니다(아래 참조).
* **AI 감지 페이지를 끈 상태로 유지합니다.** 이 페이지는 **기본적으로 꺼져** 있으며 공개 미리 보기 상태로 유지되므로, 켰을 때만 AI credits를 소모합니다. 미리 보기 중에 사용하도록 설정한 리포지토리는 계속 켜두므로 사용하지 않으려면 해당 리포지토리를 끕니다.

<!-- VERIFY before GA: exact path to turn off the AI detections page for a repo that enabled it during preview. (Default-off-at-GA confirmed in github/security-products#2357.) -->

### 예산 설정

예산은 Code Quality의 AI credits 측면을 제어하는 주요 수단입니다. 왜냐하면 Code Quality는 공유 AI credits 풀을 사용하기 때문입니다.

Code Quality의 경우 예산은 항상 엄격한 상한입니다. 예산을 만들 때 **예산 한도에 도달하면 사용 중지가** 기본적으로 활성화되고 해제할 수 없으므로 예산이 소진되면 사용이 자동으로 중지됩니다.

예산을 만들 때 **예산 유형을** 선택합니다. 다음 두 가지가 Code Quality에 적용됩니다:

* Code Quality를 포함하여 AI credits를 사용하는 모든 SKU를 포함하는 **AI credits예산**입니다. 이를 사용하여 제품 전체의 총 AI 지출을 제한합니다.
* **SKU 수준 예산**은 단독으로 범위가 Code Quality 지정되므로 다른 AI 제품에 영향을 주지 않고도 지출을 제한할 수 있습니다. 이렇게 하면 예를 들어 예산을 건드리지 않고 롤아웃하는 동안 지출을 포함할 수 있는 세분화된 제품별 제어가 제공됩니다 Copilot .

시작하려면 [예산을 설정하여 요금제 제품에 대한 지출을 제어합니다.](/ko/billing/how-tos/set-up-budgets)을(를) 참조하세요.

## 제어할 수 없는 항목

놀라움이 없도록 두 가지 제한을 유의하세요.

* **지출을 미리 추정할 수 없습니다**. Code Quality을(를) 사용하도록 설정하기 전에는 사용량은 커밋 기여자 수, 스캔 빈도, 그리고 탐지 결과에 따라 달라지므로, 정확하게 예측하려 하기보다는 기능을 켠 후 실제 사용량을 모니터링할 계획을 세우는 것이 좋습니다.
* **풀 리퀘스트 내 AI 기능은 끌 수 없습니다.**
  Code Quality 는 검색된 모든 발견에 대한 수정을 생성하므로 AI credits 사용량은 실행에 내재되어 있습니다. 이 사용량을 완전히 중지하려면 리포지토리에서 사용하지 않도록 설정합니다 Code Quality .

## 다음 단계

* **조직 전체에 배포하세요.**
  [GitHub Code Quality 대규모 배포하기](/ko/code-security/how-tos/maintain-quality-code/roll-out-at-scale)을(를) 참조하세요.
* **조직 전체의 상태를 평가합니다.**
  [조직에서 GitHub 코드 품질 결과 살펴보기](/ko/code-security/how-tos/maintain-quality-code/explore-code-quality)을(를) 참조하세요.