GitHub Code Quality 사용량 CSV: 저장소를 꺼도 이번 청구액은 줄지 않는다

개발
조회 3

Code Quality를 쓰는 저장소 하나를 끄면 그 저장소의 커미터 수만큼 비용이 바로 빠질까. GitHub가 2026년 10월 15일 제공한 라이선스 사용량 CSV는 이런 판단을 검증할 출발점이다. 작은 팀에는 다운로드 버튼보다 사람·저장소·청구 기간을 함께 대조하는 절차가 더 중요하다. 이 글은 실제 계정의 사용량이나 가격을 추정하지 않는다.

검토 도식: 사용량 스냅샷 → 중복 커미터 대조 → 다음 기간 확인. 실제 계정이나 비용 그래프가 아닌 편집 도식이다.
검토 도식: 사용량 스냅샷 → 중복 커미터 대조 → 다음 기간 확인. 실제 계정이나 비용 그래프가 아닌 편집 도식이다.

새 보고서가 보여 주는 범위

공식 발표에 따르면 CSV에는 라이선스를 소비하는 활성 커미터, 최근 90일 동안 그들의 커밋을 받은 저장소, 단일 저장소 또는 조직에만 해당하는 커미터 정보가 담긴다. GitHub Team과 GitHub Enterprise Cloud에서 Billing and licensing의 Licensing 안 Code Quality 카드로 내려받는다. 저장소를 비활성화하면 다음 청구 기간에 라이선스를 줄일 여지가 있지만 현재 라이선스 청구액은 바뀌지 않는다. 오늘 설정을 끈 사실을 오늘 환급의 근거로 쓰면 안 된다.

저장소별 인원 합계 대신 중복 관계를 보기

다음 절차는 GitHub의 자동 절감 기능이 아니라 팀 운영 제안이다. 같은 시점에 받은 CSV와 내부 인원 기록을 대조하되 저장소마다 인원을 더하지 말고 커미터가 여러 저장소에 걸쳐 있는지 확인한다. 한 저장소를 꺼도 같은 사람이 다른 활성 저장소에서 라이선스를 소비한다면 기대한 감소가 나타나지 않을 수 있다. 계정 연결이 불명확하면 추측으로 사람을 합치지 말고 확인 대기 항목을 남긴다. CSV의 실제 열 이름과 범위도 다운로드한 파일에서 확인한다.

절감 후보에는 품질 검토 비용도 붙는다

각 후보 저장소에 소유자, 제품에서의 역할, 최근 변경, 대체 검토 경로를 적는다. 기여자가 적다는 이유만으로 핵심 라이브러리의 검사를 끄는 것은 성급하다. 라이선스 후보 감소와 놓칠 수 있는 품질 문제를 같은 검토 메모에서 비교하자. 조치 전 스냅샷을 보존하고 담당자의 동의를 받아 작은 범위부터 바꾼다. 이 글은 조직의 설정이나 계약을 대신 변경하라고 제안하지 않는다.

라이선스 CSV는 총비용 보고서가 아니다

공식 비용 문서는 라이선스 외에 스캔의 GitHub Actions 사용 시간과 AI 기능의 GitHub AI Credits 비용을 구분한다. 라이선스 수가 줄어도 전체 비용이 같은 비율로 움직인다고 계산할 수 없다. 팀은 다음 청구 기간의 실제 라이선스 수와 해당 기간의 스캔 실행량을 별도로 비교해야 한다. CSV 한 장에서 임의의 절감 금액을 만들어 예산에 반영하지 말고, 비교 기간과 확인 일자를 먼저 정하자.

이번 조사에서는 커뮤니티의 절감 경험을 정량 근거로 쓰지 않았다. 독자가 검증할 질문은 ‘몇 명을 줄였는가’보다 ‘중복 관계를 제거하고도 어떤 검토 범위를 유지하는가’다. 파일에는 사람과 저장소의 연결 정보가 있으므로 공개 이슈나 블로그에 원본을 붙이지 않는다. 필요한 담당자에게 승인된 내부 경로로 공유하고, 독자에게는 집계한 판단 과정만 설명한다.

실행은 CSV 한 번과 비교 메모 한 장으로 시작할 수 있다. 기준 시점, 조사 범위, 중복 커미터 관계, 후보 저장소, 보완 검토, 다음 청구 확인일을 기록한다. 조치하지 않는 선택도 비용보다 품질 위험이 클 때는 타당하다. 다음 기간에 실제 수와 검토 결과를 확인해야 절감 가설이 검증된다. 다운로드 성공을 비용 최적화 완료로 보고하지 않는 것이 이 기능을 유용하게 쓰는 방법이다.

공식 출처

GitHub Changelog · License usage CSV

GitHub Docs · Code Quality costs

저장소 한 개의 절감 후보를 고르기 전에 커미터의 중복 관계와 품질 검토 경로부터 기록해 보자.