GitHub이 Copilot 사용량 API에 개발자 개인의 키나 로컬 모델로 처리한 요청, 조직이 지정한 모델로 처리한 요청을 따로 식별하는 지표를 추가했다. 기업과 조직 관리자는 기존 Copilot 제공 모델 사용량과 구분해 보고서에서 사용 경로와 비용 귀속, 비용 부담 주체를 나누는 방식을 살필 수 있다.

1. 두 가지 BYOK 경로를 별도로 집계

GitHub은 2026년 11월 3일 변경 안내에서 새 지표가 엔터프라이즈와 조직 보고서에 모두 제공된다고 밝혔다. 사용자별 보고서와 집계 보고서, 하루치와 28일치 보고서에서 확인할 수 있다.

로컬 BYOK는 개발자가 자신의 제공업체 키나 로컬 모델을 연결하는 방식이다. 개발자가 클라이언트에서 설정하면 Copilot CLI나 GitHub Copilot 앱의 요청이 해당 제공업체나 로컬 모델로 직접 향한다.

조직 사용자 지정 모델은 관리자가 GitHub 설정에서 지정한다. 요청은 GitHub을 거쳐 조직의 제공업체로 전달되며, GitHub은 이를 서버 쪽에서 관찰한다. 따라서 IDE를 포함해 클라이언트 종류에 관계없이 이 경로의 사용량을 기록한다.

2. 사용자 활동과 요청·토큰 수를 보여 준다

사용자별 보고서의 used_local_byok는 해당 사용자가 그날 CLI나 앱에서 로컬 BYOK 요청을 한 번이라도 보냈는지 나타낸다. 세부 집계인 totals_by_local_byok는 세션·요청·프롬프트·토큰 수를 BYOK 종류와 CLI·앱별로 나눠 사용자별 보고서와 전체 집계 보고서에 담는다.

활동 사용자 수는 같은 사람을 중복해서 세지 않고 하루, 달력 주, 달력 월 단위로 제공한다. 이 수치는 집계 보고서에서 확인할 수 있다.

조직 사용자 지정 모델은 모델별 집계 항목의 is_custom_enterprise_model이 참인지로 식별한다. 같은 모델을 Copilot 제공 모델과 사용자 지정 모델 양쪽에서 썼다면 항목이 분리되고, 사용자 지정 모델 항목에는 실제 요청 및 토큰 수가 담긴다.

3. 기존 총계는 유지되고 비용 해석은 달라진다

이번 변화는 기존 집계에 새 사용량을 더하는 것이 아니라, 기존 총계에 포함돼 있던 사용량을 경로별로 구분해 보여 주는 것이다. 로컬 BYOK 사용량은 기존 CLI 및 Copilot 앱 총계의 일부이고, 조직 사용자 지정 모델 사용량도 클라이언트별 총계에 이미 포함돼 있다. 이에 따라 새 지표로 사용량의 출처와 비용 부담 주체를 분리해 볼 수 있다.

관리자는 Copilot이 제공한 사용량을 따로 살펴 사용자당 Copilot 비용을 해석하기 쉬워진다. 대신 자체 제공업체로 보낸 요청의 비용은 그 제공업체의 청구에서 살펴야 하며, 무료 로컬 모델 사용량도 별도로 볼 수 있다.

BYOK 또는 사용자 지정 모델 사용에 따라 사용자를 묶고 기존에 추적하던 Copilot 사용 지표와 비교할 수도 있다. 누가 어떤 경로로 요청을 보내는지 확인해 조직의 BYOK 정책과 대조하는 데에도 활용할 수 있다.

4. API 보고서를 받는 방법과 접근 조건

보고서 API는 일정 시간이 지나면 만료되는 다운로드 링크를 반환한다. 엔터프라이즈와 조직의 하루치 보고서 또는 최근 28일 보고서를 요청할 수 있다.

문서에 따르면 엔터프라이즈 하루치 보고서는 2025년 10월 10일 데이터부터 제공되며, 조회 시점에서 최대 1년 전 데이터까지 접근할 수 있다. 최근 28일 보고서는 처리가 끝난 가장 최근 날짜를 끝으로 하는 28일 전체를 다룬다.

엔터프라이즈 보고서는 엔터프라이즈 소유자, 청구 관리자, 또는 해당 지표를 읽을 권한이 부여된 사용자에게 제공된다. 조직 보고서는 조직 소유자와 해당 조직 지표 읽기 권한이 있는 사용자가 이용할 수 있다. 엔터프라이즈 전체에서 Copilot 사용량 지표 정책도 활성화해야 한다.

최근 28일 사용자 보고서의 요청 예시는 다음과 같다.

curl -L \
  -H "Accept: application/vnd.github+json" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "X-GitHub-Api-Version: 2026-03-10" \
  https://api.github.com/enterprises/ENTERPRISE/copilot/metrics/reports/users-28-day/latest

5. 기록 전송 상태와 배포 시점이 해석의 기준

로컬 BYOK는 클라이언트가 보내는 사용 기록에 의존하므로 기록 전송이 꺼져 있거나 일부 제공업체가 토큰 수를 보내지 않으면 사용량이나 토큰 수가 실제보다 적게 집계될 수 있다. 조직 사용자 지정 모델 표시는 이번 변경 배포 전 날짜의 보고서에는 소급해, 과거 자료에 나중에 반영해 추가되지 않는다.

새 지표의 핵심은 기존 사용량 총계를 바꾸지 않고 처리 경로를 드러내 비용과 사용 정책을 더 정확히 살피게 하는 데 있다.