GitHub Copilot: 도구별 모델 요청, 토큰 사용량

1. 코드 편집기 밖 사용량까지 집계

GitHub은 2026년 10월 23일 변경 로그에서 도구별 집계인 totals_by_client 배열을 발표했다. 기업·조직 전체와 각각의 사용자별 1일 및 28일 보고서가 대상이다. 28일 보고서에서는 날짜별 day_totals 항목에 배열이 들어간다.

그동안 코드 편집기 밖의 도구는 편집기 사용 기록을 보내지 않는 경우가 많아 기존 편집기별 집계에서 빠졌다. 이번 변경은 서버에서 모델 요청을 세어 그 공백을 메운다. 관리자는 도구별 요청량과 토큰량을 비교해 어떤 도구가 Copilot 사용을 이끄는지 확인할 수 있다.

새 배열은 기존 보고서에 추가되는 항목이다. 기존 필드는 그대로 유지되며, 보고할 사용량이 없으면 새 배열은 비어 있다.

2. 요청 수와 토큰, 모델 선택 방식

각 항목은 요청을 보낸 도구, 성공한 모델 요청 수, 서로 다른 세션 수, 프롬프트·출력·요청당 평균 토큰을 담는다. OpenCode나 Claude Code 같은 도구가 집계 대상이며, 알아보지 못한 도구는 other로 묶인다.

요청 수와 토큰량은 모델별로도 나뉜다. 모델 선택 방식에서는 사용자가 직접 요청한 경우를 user_selected, 자동 선택한 경우를 auto로 표시한다.

Copilot Code Review와 Copilot Cloud Agent는 제품이 모델을 고르므로 선택 방식이 product_selected로 보고된다. 이 가운데 코드 검토 기능의 모델 이름은 unknown으로 표시된다.

GitHub에서 에이전트 앱이 시작한 작업 수를 세는 기존 활동 지표와 달리, 새 집계의 중심은 모델에 오간 요청과 토큰이다. 관리자는 작업 단위 활동에 더해 도구별 모델 이용 규모를 살필 수 있게 된다.

3. 권한을 갖춘 사용자가 API로 조회

조회하려면 기업의 Copilot 사용량 지표 정책을 전체 활성화로 설정해야 한다. 변경 로그에 따르면 기업 소유자와 결제 관리자, 조직 소유자, 사용자 지정 기업·조직 역할로 Copilot 지표 보기 권한을 받은 사용자가 이용할 수 있다.

문서의 기업 1일 보고서 요청 예시는 다음과 같다. 날짜는 day에 지정하며, API 버전 헤더는 문서에 실린 예시 그대로다.

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/enterprise-1-day?day=DAY"

응답에는 줄마다 JSON 객체를 담는 NDJSON 형식 보고서의 다운로드 링크가 들어 있다.

문서에 따르면 기업 1일 보고서는 2025년 10월 10일부터의 데이터를 제공하며, 과거 데이터는 현재 날짜 기준 최대 1년까지 조회할 수 있다.

4. 지원 정책의 근거 확대와 보고서 처리 부담

도구별 집계는 관리자가 지원할 도구와 운영 정책을 실제 이용 현황에 맞춰 검토할 근거를 넓힌다. 이를 정기 분석에 쓰려면 API 응답에서 링크를 받아 보고서 파일을 내려받아 처리하는 절차가 필요하다. 링크는 만료 시간이 있는 서명 URL, 정해진 시간 동안 접근을 허용하는 링크이므로 다운로드 절차도 운영에 포함된다.

해석할 때 request_count는 한 프롬프트에서 여러 번 발생할 수 있는 모델 호출 수여서 프롬프트·상호작용 수와 직접 비교할 수 없다. 또 도구 분류는 요청에 실린 통합 식별값, 요청에 실려 도구를 구분하는 문자열을 따르는 근사치, 정확한 확인이 아닌 대략적인 값으로, GitHub이 도구의 신원을 검증한 결과는 아니다.

이번 변경의 핵심은 편집기에 치우쳤던 Copilot 사용량 파악을 도구별 모델 이용 현황으로 넓혀 지원 정책의 근거를 보강한 데 있다.