GitHub Code Quality 라이선스 CSV: 청구 인원과 저장소별 사용 대조하기

필요한 곳부터 보기: 다운로드 위치 · CSV 항목의 의미 · 5행·3명 예제 · 청구 수량이 다른 이유 · 전체 비용 확인 자료

Code Quality CSV는 어디서 다운로드하나요?

GitHub는 2026년 10월 15일 Code Quality 라이선스 사용량을 CSV로 내려받는 기능을 발표했습니다. Code Quality 제품 자체의 최초 출시일을 뜻하는 날짜는 아닙니다. 제공 대상은 GitHub Team·GitHub Enterprise Cloud입니다. CSV 다운로드 기능 추가 발표

1. 확인하려는 조직 또는 엔터프라이즈를 선택합니다.
2. Billing and licensing → Licensing을 엽니다.
3. Code Quality 카드에서 CSV 보고서를 다운로드합니다.
4. 내려받은 원본을 보존하고 조회 시각·시간대·청구 주체·청구 기간을 기록합니다.

클라우드의 라이선스 보고서 접근 역할은 엔터프라이즈 소유자·조직 소유자·청구 관리자입니다. 저장소 관리자라는 이유만으로 청구 자료도 볼 수 있다고 가정하지 말고 대상 계정의 역할을 확인하세요. 일반 라이선스 보고서는 이메일로 전달될 수 있지만 Code Quality CSV는 브라우저로 직접 다운로드되는 예외입니다. 다운로드 권한과 전달 방식

실제 파일의 열을 공식 항목과 대조하세요

10월 19일 확인한 공식 라이선스 보고서 참조 문서는 다음 네 항목을 설명합니다. 아래 명칭은 문서에 명시된 항목이며 이번에 실제 계정에서 받은 CSV를 관찰한 결과는 아닙니다. 다운로드한 파일의 헤더와 값을 먼저 확인한 뒤 작업 사본에서 대조하세요. Code Quality CSV 항목 참조

공식 항목	의미	대조할 때 주의할 점
User login	GitHub 사용자명	같은 사용자가 저장소마다 반복될 수 있음
Organization / repository	라이선스 사용에 기여한 저장소의 소유자와 이름	같은 사용자의 다른 조직·저장소 관계도 함께 확인
Last pushed date	해당 저장소의 라이선스 사용에 기록된 push 날짜. YYYY-MM-DD 형식	-는 날짜를 알 수 없다는 뜻이며 활동 없음이나 0으로 바꾸지 않음
Last pushed email	사용자의 Git author 이메일	이메일을 push 수행자의 인증 정보로 해석하지 않음

CSV의 행 수는 사용자·저장소 관계를 이해하는 데 쓰고, 인원은 청구 범위 안의 사용자명을 기준으로 중복을 확인합니다. 현재 보고서는 현재 활성 커미터를 보여 주므로 해당 청구 기간에 요금이 발생한 모든 라이선스의 이력과 동일하게 취급하면 안 됩니다.

active committer와 unique committer는 무엇이 다른가요?

Code Quality의 활성 여부는 커밋을 처음 작성한 날이 아니라 최근 90일 안에 그 커밋이 저장소로 push됐는지를 기준으로 판단합니다. 공식 문서는 조직·엔터프라이즈의 GitHub Team 또는 Enterprise 라이선스가 있는 멤버·외부 협업자·초대 대기 사용자 등을 활성 커미터 범위로 설명합니다. 재직자 명부의 인원만으로 예상 수량을 정하지 마세요. GitHub App 봇은 제외되지만 자동화에 쓰는 개인 계정을 모두 같은 봇으로 취급할 수는 없습니다. 활성 커미터·라이선스 집계 기준

unique committer는 특정 저장소 하나에만 기여하거나 특정 조직 안의 저장소에만 기여한 활성 커미터를 가리킵니다. 저장소 한 곳에만 해당하는지, 조직 한 곳에만 해당하는지 범위를 나눠 봐야 합니다. 한편 청구 인원에서 중복을 제거한다는 것은 같은 계정이 여러 저장소·조직에 보여도 청구 범위 전체에서 한 번 집계한다는 뜻입니다.

합성 예제: CSV 5행을 라이선스 5개로 세면 틀리는 이유

합성 라이선스 CSV 예제는 공식 문서의 네 항목을 사용해 만든 교육용 데이터입니다. 실제 GitHub 내보내기나 직원 명부가 아닙니다. 하나의 엔터프라이즈에 sample-alpha·sample-beta 두 조직이 있고, 표에 나온 세 저장소만 Code Quality 사용에 기여한다고 가정합니다. 세 사용자는 모두 현재 활성·라이선스 대상이라는 조건입니다.

가상 사용자	사용량에 포함된 저장소	특정 범위에만 기여하는지
sample-user-a	sample-alpha/web · sample-alpha/api	저장소는 두 곳, 조직은 sample-alpha 한 곳
sample-user-b	sample-alpha/api · sample-beta/tools	두 조직에 걸쳐 있음
sample-user-c	sample-beta/tools	저장소·조직 모두 한 곳에만 해당

사용자와 저장소의 관계는 5개이지만 엔터프라이즈 전체의 서로 다른 사용자는 3명입니다. 조직별로는 각각 2명이므로 조직 수량을 단순 합산하면 4명이 됩니다. 이 경우에도 엔터프라이즈 범위에서는 sample-user-b가 중복된다는 점을 확인해야 합니다.

이 조건에서 sample-beta/tools의 Code Quality만 해제하면 sample-user-b는 sample-alpha/api 때문에 계속 포함됩니다. sample-user-c만 다음 청구 기간의 라이선스 해제 후보가 됩니다. 이는 합성 데이터의 관계를 계산한 결과이며 실제 계정의 요금 절감이나 다음 청구서를 확인한 결과가 아닙니다.

내부 사용 명부와 대조할 때는 범위와 식별자를 먼저 맞추세요

1. 청구 주체를 고정합니다. 엔터프라이즈 청구인지 독립 조직 청구인지 적고, 같은 범위의 CSV·Licensing 화면·청구 자료를 모읍니다.
2. 원본과 작업 사본을 나눕니다. 다운로드 시각, 파일명, 실제 헤더, 데이터 행 수를 기록합니다. 빈 값과 알 수 없는 날짜도 보존합니다.
3. 사용자명을 내부 명부에 연결합니다. 승인된 GitHub 계정 매핑으로 구성원·외부 협업자·초대 대기 등을 확인합니다. 표시 이름이나 이메일만 같다고 계정을 임의로 합치지 말고, 매칭되지 않는 계정은 확인 대상으로 남깁니다.
4. 사용자별 저장소 관계를 묶습니다. 한 저장소를 끄더라도 다른 활성 저장소 때문에 계속 집계되는지 봅니다. 조직별 자료를 합칠 때는 엔터프라이즈 범위의 중복도 확인합니다.
5. 차이를 원인별로 기록합니다. 행 중복, 조회 시점, 청구 범위, 기간 내 최대 인원, 미확인 계정을 각각 분리합니다.

조회·명부 대조·변경 후보 기록 양식에 확인 결과를 남길 수 있습니다. 합성 CSV·계산 결과·기록 양식 ZIP도 제공합니다. 직원 이메일·비공개 저장소명이 포함된 원본은 조직이 승인한 환경에서 다루고 외부 AI에 임의 업로드하지 마세요. 일반적인 원본 보존과 누락 확인 방법은 AI 데이터 분석 가이드에서 이어 볼 수 있습니다.

기능을 껐는데 이번 청구 기간의 수량이 줄지 않는 이유

공식 비활성화 문서에 따르면 기간별 라이선스 청구는 그 기간 중 어느 시점에든 사용한 라이선스의 최대 수량을 기준으로 합니다. 현재 CSV의 중복 제거 인원과 그 기간의 청구 수량이 다른 것은 이 기준부터 확인해야 합니다. 기간 말에 저장소를 끄거나 현재 활성 수량이 줄어도 이미 기록된 기간 내 최대 수량을 낮추지는 않습니다. 비활성화 후 청구와 최대 수량 기준

저장소를 끄면 그 저장소의 새 스캔과 이에 따른 사용량 발생이 멈추지만, 이미 쓴 Actions 실행 시간·AI 크레딧은 정상 청구됩니다. 또 같은 사용자가 Code Quality가 켜진 다른 저장소에도 기여했다면 라이선스 집계가 계속될 수 있습니다. CSV 조회일의 인원, 청구 기간 중 최대 인원, 이미 발생한 사용량을 서로 다른 값으로 기록하세요.

조직 단위로 끄는 경우에는 실제 적용 저장소도 확인해야 합니다. 조직 기본값을 No repositories로 바꿔도 관리자가 명시적으로 활성화한 저장소는 남을 수 있으며, 공식 문서는 Enforce access 적용 여부를 함께 설명합니다. 비용 검토 단계에서는 변경 후보와 유지할 품질 검사를 담당자에게 확인하고, 변경 후 개별 저장소의 실제 상태를 대조하세요.

이 CSV만으로 Code Quality 전체 비용을 계산할 수는 없습니다

공식 비용 문서는 Code Quality 비용을 라이선스, GitHub Actions 실행 시간, GitHub AI Credits로 나눕니다. AI 크레딧은 Copilot 등과 공유하는 풀에서 사용하므로 라이선스 인원만 줄었다고 전체 비용도 같은 비율로 줄었다고 판단할 수는 없습니다. 비용별 확인 자료와 관리 방법

확인할 비용	추가로 대조할 자료	확인하려는 질문
커미터 라이선스	Code Quality 라이선스 CSV·Licensing 수량·기간별 청구 자료	누가 어떤 저장소 때문에 포함됐고, 기간 최대 수량은 얼마인가?
Actions 실행 시간	청구 사용량·상세 실행 보고서	해당 저장소의 Code Quality 스캔 실행으로 발생한 사용량은 얼마인가?
AI 크레딧	AI usage의 제품별 보기·사용량 보고서	공유 풀에서 Code Quality가 차지하는 소비량은 얼마인가?

상세 사용량 보고서에서 Code Quality 스캔을 찾을 때 공식 청구 문서가 안내하는 식별자는 workflow_path의 dynamic/github-code-quality/codeql입니다. 이 항목은 상세 사용량 보고서에 쓰는 필터이며 라이선스 CSV의 추가 열로 가정하면 안 됩니다. self-hosted runner는 해당 Actions 실행 시간 청구 예외이지만 자체 인프라 비용까지 없어지는 뜻은 아닙니다.

AI usage에서는 제품별로 Code Quality 소비를 확인하고, 조직이 엔터프라이즈를 통해 청구된다면 공유 풀의 범위도 엔터프라이즈에 맞춥니다. 기간·제품·조직·저장소를 맞춘 사용량 보고서 다운로드 절차는 제품·라이선스 사용량 확인 문서에서 확인할 수 있습니다.

여기서 말하는 라이선스는 Code Quality 제품 사용권입니다. 오픈소스 의존성의 라이선스 허용 정책이나 PR 병합 차단 검사는 별도 주제입니다.

자주 묻는 질문

같은 사람이 여러 저장소에 나오면 모두 합산하나요?

같은 계정은 조직 또는 엔터프라이즈의 청구 범위에서 한 라이선스를 사용합니다. CSV 여러 행이나 조직별 수량을 그대로 합산하지 말고 같은 사용자명의 중복과 청구 범위를 확인하세요. 현재 활성 인원과 청구 기간의 최대 인원도 구분해야 합니다.

저장소에서 기능을 끄면 이번 달 요금도 줄어드나요?

현재 청구 기간의 라이선스 요금은 즉시 줄어들지 않습니다. 기간 내 최대 사용 수량이 기준이기 때문입니다. 다음 기간의 라이선스 해제 가능성은 같은 사용자가 다른 활성 저장소에도 기여했는지 확인해야 하며, 비활성화 전에 발생한 Actions·AI 사용량은 남습니다.

이 CSV 하나로 Code Quality 전체 비용을 계산할 수 있나요?

이 CSV는 현재 라이선스 사용에 기여한 사용자와 저장소를 설명합니다. 전체 비용을 보려면 기간별 청구 자료, Actions 실행 시간, Code Quality의 AI 크레딧 소비 자료를 같은 청구 범위로 추가 대조해야 합니다.

확인 범위와 업데이트 기록

CSV 기능 발표일은 2026년 10월 15일, 공식 항목·청구 기준 확인일은 10월 19일입니다. 이 글은 공식 문서 분석과 합성 데이터의 인원·저장소 관계 계산입니다. 실제 계정의 CSV·직원 명부·청구서를 받거나 기능을 비활성화한 검증은 수행하지 않았습니다. CSV 항목·활성 커미터·청구 기준·권한이 바뀌면 해당 설명과 예제를 갱신합니다.