GitHub Code Quality를 꺼도 이번 청구기간의 라이선스 요금이 줄지 않는 이유

새 스캔은 멈춰도 이번 청구기간의 최고 인원은 남는다

Code Quality의 라이선스 요금은 청구기간 마지막 날의 인원이 아니라, 그 기간 중 가장 많았던 사용 인원으로 계산된다. GitHub의 비활성화 안내에 따르면 저장소에서 기능을 끄는 것은 다음 기간의 라이선스를 줄이는 데 도움이 되지만 현재 기간의 라이선스 청구를 낮추지는 않는다.

대신 해당 저장소의 새 스캔은 즉시 중단된다. 이후 스캔에서 소비할 GitHub Actions 시간과 AI 크레딧도 발생하지 않는다. 이미 사용한 양은 정상 청구되므로, ‘끄고 나서도 청구서에 금액이 있다’는 사실만으로 스캔이 계속 실행된다고 판단할 수는 없다.

GitHub가 10월 15일 추가한 라이선스 CSV는 여기서 쓸 수 있다. 어떤 커미터가 어느 저장소 때문에 라이선스를 소비하는지 확인하고, 활성화 범위를 줄였을 때 빠질 수 있는 인원을 가늠하는 자료다. GitHub Team과 Enterprise Cloud에서 제공한다.

Code Quality 카드에서 CSV를 내려받는다

조직이나 엔터프라이즈의 Billing and licensing → Licensing → Code Quality로 이동해 CSV 다운로드를 선택한다. 라이선스 보고서 다운로드는 조직·엔터프라이즈 소유자와 청구 관리자가 사용할 수 있다. Code Quality 보고서는 다른 일부 라이선스 보고서처럼 이메일을 기다리는 방식이 아니라 브라우저로 바로 내려받는다.

CSV 필드 문서에서 설명하는 항목은 다음과 같다.

이 파일은 현재 활성 커미터 목록이다. 청구기간 동안 요금에 포함된 모든 사람의 이력을 담은 원장은 아니다. CSV의 현재 인원이 청구 인원보다 적더라도, 기간 중 더 높은 인원을 기록했다면 두 숫자는 달라질 수 있다.

같은 사람이 두 저장소에 기여했다면 한 명으로 센다

활성 커미터는 자신의 커밋이 Code Quality를 켠 저장소에 최근 90일 안에 push된 사람을 기준으로 한다. 커밋을 처음 작성한 날짜가 기준은 아니다. 동일 조직 또는 엔터프라이즈 안에서 여러 저장소에 기여한 사용자도 라이선스는 하나다.

예를 들어 같은 조직의 비공개 저장소 A와 B에 Code Quality를 켰다고 가정한다. 민수는 두 저장소에, 지연은 A에만 최근 90일 내 기여했고 두 사람 모두 다른 활성 저장소에는 기여하지 않았다.

이 가상 사례의 CSV는 세 행이어도 사용자는 두 명이다. A를 끈 뒤 활성 인원은 한 명이 되지만, 해당 기간의 최고 인원이 이미 두 명이었다면 현재 라이선스 청구는 두 명 기준으로 남는다. 다음 기간도 한 명일지는 이후 커밋과 활성화 범위에 달려 있다.

‘고유 커미터’는 이런 차이를 읽기 위한 개념이다. 특정 저장소에 표시된 사용자를 모두 절감 가능한 인원으로 더하지 말고, 사용자명으로 묶어 다른 활성 저장소가 남는지 봐야 한다.

라이선스 CSV만으로 전체 Code Quality 요금을 계산할 수는 없다

현재 공개 가격은 비공개 저장소의 커미터당 월 10달러에 사용량 요금이 더해지는 구조다. 공개 저장소에는 커미터당 요금이 없지만 AI 작업의 사용량 과금은 남는다. 저장소 공개 여부부터 구분해야 한다.

전체 비용을 대조할 때는 청구 사용량 보고서에서 저장소·조직별 사용을 보고, AI usage 화면에서는 Product로 묶어 Code Quality의 AI 크레딧 소비를 찾는다. 라이선스 인원과 Actions 시간, AI 크레딧은 같은 숫자가 아니다.

저장소 범위를 줄이려면 현재 CSV에서 같은 사용자의 여러 행을 한 명으로 묶고, 남는 저장소를 확인한 뒤 다음 청구기간의 인원을 예상해야 한다. 이번 청구액을 대조할 때는 현재 인원만이 아니라 기간 중 최고 인원과 이미 발생한 사용량까지 함께 봐야 한다.