GitHub AI usage report AI Credits fields update: 비용 리포트에서 봐야 할 필드

 

GitHub AI usage report 업데이트: AI Credits 비용 리포트에서 봐야 할 필드

2026년 6월 1일 이후 Copilot 비용 리포트는 `quantity`와 `gross_amount`부터 다시 확인해야 합니다.

 

GitHub AI usage report 업데이트, 지금 봐야 할 필드는 무엇인가

 

GitHub는 2026-06-11 AI usage report에서 AI Credits 사용량을 표준 report field로 읽도록 업데이트했습니다. 2026-06-01 이후 Copilot Business/Enterprise 비용 리포트는 AI credit quantity를 `quantity`, dollar amount를 `gross_amount` 중심으로 확인해야 합니다.

GitHub AI usage report AI Credits fields update에서는 비용 리포트 해석 변경을 먼저 봐야 합니다. 기존에 `aic_quantity`나 `aic_gross_amount`를 집계하던 대시보드가 있다면 6월 이후 사용량을 낮게 보거나 0으로 오해할 수 있습니다.

제가 보기에는 이번 공지는 Copilot 기능 뉴스보다 사내 AI 도구 운영팀이 바로 확인해야 할 리포팅 변경에 가깝습니다. GitHub는 AI Credits가 2026-06-01부터 Copilot 사용량의 native billing model이 된 뒤, AI usage report에서 표준 필드로 사용량과 금액을 보도록 정리했습니다.

확인 순서는 세 갈래입니다. 필드 매핑, 6월 1일 기준일, BI/API 자동화 영향입니다. GitHub Enterprise Cloud 관리자가 아니라면 모든 내용을 적용할 필요는 없습니다. 다만 Copilot 비용을 내부에서 배분하거나 예산 통제하는 팀이라면 필드명부터 확인하는 편이 안전합니다.

 

이미지 설명: GitHub 로고 없이, AI 비용 대시보드 화면 위에 `quantity`, `gross_amount`, `aic_quantity` CSV 컬럼명이 겹쳐 보이는 기술 블로그용 이미지

 

`quantity`와 `gross_amount`가 기준이 된 이유

 

2026-06-01 이후 AI Credits 사용량은 preview용 `aic_quantity`, `aic_gross_amount`가 아니라 표준 필드인 `quantity`, `gross_amount`로 읽어야 합니다. `aic_*` 컬럼이 0으로 보이는 것은 사용량이 없다는 뜻이 아니라 GitHub가 배포한 bug fix의 결과로 봐야 합니다.

GitHub의 안내는 짧지만 운영상 의미는 분명합니다. AI credit quantity는 `quantity`, dollar amount는 `gross_amount`를 사용하라는 쪽으로 리포트 해석 기준이 정리됐습니다. GitHub AI usage report AI Credits fields update라는 검색어로 들어온 독자에게는 이 필드 매핑이 가장 먼저 필요한 답입니다.

`aic_quantity`와 `aic_gross_amount`는 AI Credits가 native billing model이 되기 전 preview 기간에 붙은 필드였습니다. GitHub는 2026-06-01 이후 AI credit usage에서 이 두 컬럼이 더 이상 의미 있는 신호가 아니며, 관련 bug fix로 해당 컬럼을 retroactively zeroed 처리했다고 밝혔습니다.

6월 이후 `aic_* = 0`은 사용량 0의 증거가 아닙니다. 현재 비용 흐름은 `quantity`, `gross_amount`, `discount_amount`, `net_amount`를 함께 봐야 합니다.

한국 사용자 입장에서는 여기서 오해가 생기기 쉽습니다. 사내 대시보드가 `aic_gross_amount` 합계를 월별 비용으로 보여주고 있었다면, 6월 이후 값이 갑자기 줄어든 것처럼 보일 수 있습니다. 비용이 줄었다고 판단하기 전에 쿼리의 기준 필드가 무엇인지 먼저 봐야 합니다.

 

왜 2026년 6월 1일 이후 리포트 해석이 달라졌나

 

2026-06-01은 AI Credits가 Copilot 사용량의 native billing model이 된 기준일이고, 2026-06-11은 그 이후 리포트 필드 해석을 정리한 날짜입니다. 이 두 날짜를 나눠 봐야 과거 preview 데이터와 현재 비용 추적을 섞지 않습니다.

날짜를 나눠 보면 혼동이 줄어듭니다.

날짜	확인할 내용	운영상 의미
2026-04-27	GitHub가 Copilot 플랜의 usage-based billing 전환을 발표	Premium Request Units에서 AI Credits 중심으로 바뀌는 예고
2026-06-01	AI Credits가 Copilot Business/Enterprise 사용량의 native billing model이 됨	현재 비용 리포트의 기준일
2026-06-04	billing usage reports API와 budget/usage management APIs 관련 GA 공지	CSV 리포트와 비용 관리 자동화 맥락 강화
2026-06-11	AI usage report field update 공지	`quantity`, `gross_amount` 중심으로 리포트 해석

6월 1일 이전 리포트가 전부 바뀐 것은 아닙니다. GitHub는 2026-06-01 이전 리포트는 변경되지 않아 기존 historical analysis가 계속 동작한다고 안내했습니다. 그래서 예전 데이터를 분석하는 쿼리와 현재 AI Credits 비용을 추적하는 쿼리를 같은 방식으로 고치면 곤란합니다.

실제로 확인할 부분은 기간 조건입니다. `WHERE date >= '2026-06-01'` 같은 기준을 두고 현재 리포트는 표준 필드를 쓰며, preview 기간 데이터는 기존 분석 로직을 보존할지 별도 검토하는 방식이 안전합니다.

 

이미지 설명: 2026년 4월, 6월 1일, 6월 11일로 이어지는 AI Credits 비용 리포트 타임라인을 표현한 미니멀한 기술 일러스트

 

Copilot Business와 Enterprise 비용 추적에 왜 중요한가

 

이 변경은 사내 AI 도구 운영 데이터의 기준 필드가 바뀐 문제입니다. 기존 BI 대시보드, 알림, chargeback 쿼리가 `aic_*`를 기준으로 되어 있으면 2026-06-01 이후 사용량과 금액을 잘못 읽을 수 있습니다.

Copilot Business나 Enterprise를 쓰는 조직은 개인이 결제 내역을 보는 수준에서 끝나지 않습니다. 부서별 비용 배분, 모델별 spend, heavy consumer 확인, 예산 초과 알림 같은 운영 흐름이 붙습니다. 운영자가 GitHub AI usage report AI Credits fields update를 확인해야 하는 지점도 여기입니다.

GitHub Docs 기준으로 AI usage report는 date, model, username 조합을 기준으로 quantity, gross_amount, discount_amount, net_amount를 합산하는 상세 리포트입니다. 또 GitHub는 AI usage 화면에서 총 AI Credits 소비, 사용자별 heavy consumers, 모델별 spend, 조직별 채택 범위를 확인할 수 있다고 설명합니다.

다만 사용자 권한에 따라 보이는 데이터가 다릅니다. Enterprise owners와 billing managers는 사용자별 필터를 쓸 수 있지만, organization owners가 사용자별 소비를 보려면 usage report 다운로드가 필요할 수 있습니다. 한국 기업에서 재무팀, 플랫폼팀, 개발 생산성팀이 함께 보는 구조라면 이 권한 차이를 운영 문서에 남겨야 나중에 원인 파악이 빨라집니다.

 

도입 시뮬레이션: 첫 검증부터 운영 모델까지

 

설치형 repo가 아니라 GitHub billing/reporting update이므로 첫 테스트는 Enterprise Cloud에서 AI usage report를 내려받아 2026-06-01 이후 행의 `quantity`, `gross_amount`, `discount_amount`, `net_amount`, `model`, `username`을 확인하는 방식이 적합합니다. 운영 모델은 CSV 리포트 검증, API 자동 수집, 예산 통제, skip 조건을 나눠 설계해야 합니다.

첫 검증은 GitHub Enterprise Cloud의 Billing & Licensing 또는 Usage 화면에서 AI usage report를 다운로드하는 일부터 시작합니다. 2026-06-01 이후 데이터만 따로 보고, 기존 대시보드가 `aic_quantity`나 `aic_gross_amount`를 집계했다면 같은 기간을 `quantity`와 `gross_amount` 기준으로 다시 합산합니다.

처음에는 아래 다섯 가지만 확인해도 충분합니다.

• 2026-06-01 이후 AI usage report CSV를 내려받습니다.
• `date`, `model`, `username`, `quantity`, `gross_amount`, `discount_amount`, `net_amount`를 확인합니다.
• 기존 BI 쿼리에서 `aic_quantity`, `aic_gross_amount`를 찾습니다.
• 현재 비용 집계는 `quantity`, `gross_amount`로 바꿔 비교합니다.
• `aic_* = 0`을 사용량 없음으로 처리하는 알림 규칙이 있는지 회귀 테스트합니다.

API 자동화가 이미 있다면 CSV와 REST API 응답명을 섞지 않는 편이 좋습니다. CSV/usage report 문서는 `gross_amount`처럼 snake_case 필드를 설명하지만, Enterprise-level AI credit usage REST endpoint 예시는 `grossAmount`, `netAmount` 같은 camelCase 응답을 씁니다. 같은 의미를 다루더라도 파이프라인 단계별 필드 매핑을 분리해야 합니다.

제가 운영 문서를 만든다면 `report_csv.quantity -> warehouse.ai_credit_quantity`, `report_csv.gross_amount -> warehouse.ai_credit_gross_amount`, `api.grossAmount -> warehouse.ai_credit_gross_amount`처럼 출처별 매핑을 남기겠습니다. 나중에 GitHub Docs가 갱신되거나 API 버전이 바뀌어도 값의 출처를 추적하기 쉽습니다.

 

 

 

대시보드와 자동화는 어떻게 고쳐야 하나

 

2026-06-01 이후 집계 쿼리는 `quantity`와 `gross_amount`를 기준으로 바꾸고, 실제 청구 관점에서는 `discount_amount`와 `net_amount`도 함께 분리해 봐야 합니다. REST API를 쓰는 경우 CSV의 snake_case 필드명과 API의 camelCase 응답명을 같은 컬럼처럼 섞지 않아야 합니다.

대시보드 수정은 필드명 치환만으로 끝내면 부족합니다. `gross_amount`는 할인 전 금액의 성격으로 읽어야 하고, 실제 청구 관점에서는 `discount_amount`, `net_amount`를 같이 봐야 합니다. 포함 크레딧, 할인, 예산 제한이 얽힌 환경에서 gross만 보고 월말 비용을 단정하면 재무팀 숫자와 어긋날 수 있습니다.

알림도 함께 봐야 합니다. 예를 들어 `aic_gross_amount > 100` 같은 조건으로 모델별 비용 경고를 걸어두었다면 6월 이후에는 작동하지 않을 가능성이 있습니다. 반대로 `aic_quantity = 0`을 비활성 사용자로 분류하는 규칙이 있으면 Copilot을 많이 쓰는 사용자를 놓칠 수 있습니다.

Budget controls 문서도 같이 확인할 만합니다. GitHub Docs는 user, organization, cost center, enterprise 수준 예산이 함께 작동한다고 설명합니다. user-level budget은 shared pool과 metered phase 모두에서 hard stop으로 동작한다고 되어 있으므로, 리포트 필드 수정 뒤에는 heavy agentic coding 사용자에게 어떤 budget override가 필요한지도 검토 대상입니다.

 

주의할 점: 이 업데이트로 단정하면 안 되는 것

 

이번 공지만으로 특정 조직의 실제 청구액, 절감액, 모든 플랜 적용 여부를 단정하면 안 됩니다. 2026-06-01 이전 historical analysis에는 기존 preview 필드가 남아 있을 수 있고, Enterprise Cloud 외 환경은 적용 범위를 별도로 확인해야 합니다.

GitHub AI usage report AI Credits fields update는 비용 리포트의 해석 기준을 잡아주는 업데이트입니다. 특정 회사의 Copilot 비용이 줄었다거나, 모든 플랜의 화면이 동일하게 바뀌었다고 말할 근거는 아닙니다.

다만 여기서 조심할 점은 세 가지입니다. 첫째, 2026-06-01 이전 리포트를 현재 기준으로 덮어쓰지 않아야 합니다. 둘째, Enterprise Cloud 고객에게 이미 제공된 fix라는 표현을 모든 GitHub 환경으로 넓히지 않아야 합니다. 셋째, 모델별 단가나 최종 invoice 금액은 별도 가격 문서와 청구 자료에서 확인해야 합니다.

개인 개발자나 소규모 팀이 Copilot 사용량 감만 보려는 경우라면 여기서 다룬 대시보드 마이그레이션은 과할 수 있습니다. 반대로 Copilot Business/Enterprise를 쓰고, AI Credits를 팀별로 배분하거나 비용 경고를 자동화한다면 이번 필드 변경은 작은 설정값 문제가 아닙니다. 월말 리포트가 틀리기 전에 한 번은 확인할 만한 항목입니다.

 

 

 

자주 묻는 질문

 

Q. GitHub AI usage report에서 `quantity`와 `gross_amount`는 무엇을 뜻하나?
A. 2026-06-01 이후 AI Credits 사용량을 볼 때 `quantity`는 AI credit quantity, `gross_amount`는 dollar amount를 확인하는 기준 필드입니다. Billing reports reference의 금액 필드와 함께 `discount_amount`, `net_amount`도 분리해서 보는 편이 안전합니다.

Q. 2026-06-01 이후에도 `aic_quantity`와 `aic_gross_amount`를 계속 써도 되나?
A. 현재 AI Credits 사용량 추적에는 쓰지 않는 편이 맞습니다. GitHub는 두 필드가 native billing model 전 preview 용도로 추가됐고, 2026-06-01 이후 AI credit usage에는 의미 있는 신호가 아니라고 안내했습니다.

Q. `aic_*` 컬럼이 0이면 AI Credits 사용량이 없었다는 뜻인가?
A. 아닙니다. GitHub는 bug fix로 2026-06-01 이후 AI credit usage에서 `aic_quantity`, `aic_gross_amount`를 retroactively zeroed 처리했다고 밝혔습니다. 현재 사용량은 `quantity`와 `gross_amount` 기준으로 다시 확인해야 합니다.

Q. Copilot Business/Enterprise 관리자는 무엇을 먼저 점검해야 하나?
A. AI usage report CSV를 내려받아 2026-06-01 이후 행의 `date`, `model`, `username`, `quantity`, `gross_amount`, `discount_amount`, `net_amount`를 확인하고, 기존 BI 쿼리나 알림이 `aic_*` 필드에 묶여 있는지 찾아야 합니다.

Q. CSV 리포트 필드명과 REST API 응답 필드명은 왜 다르게 보이나?
A. Billing report 쪽은 `gross_amount` 같은 snake_case 필드를 설명하지만, Enterprise AI credit usage REST API 예시는 `grossAmount`, `netAmount` 같은 camelCase 응답을 사용합니다. 자동화할 때는 CSV 입력과 API 입력의 매핑표를 따로 두는 것이 좋습니다.

Q. 이번 업데이트가 모든 GitHub 플랜에 동일하게 적용됐다고 봐도 되나?
A. 그렇게 넓혀 쓰면 안 됩니다. GitHub Changelog는 이 fix가 GitHub Enterprise Cloud 고객에게 이미 제공된다고 설명합니다. 다른 플랜, 계정 화면, 청구 구조는 공식 문서와 실제 계정 권한에서 따로 확인해야 합니다.

함께 읽으면 좋은 글

 

• Kimi K2.7 Code가 Vercel AI Gateway에 추가됐다: 코딩 모델 라우팅은 어떻게 쓰나 — AI UPDATES
• GitHub Copilot CLI /settings 업데이트: 터미널 AI 코딩 환경 설정이 어떻게 쉬워졌나 — AI UPDATES
• OpenAI 웹 검색 API에 이미지 결과 추가: 검색형 AI 앱이 달라지는 지점 — AI UPDATES

참조 링크

 

• AI usage report updates — 2026-06-11 AI usage report field update의 원문입니다. `quantity`, `gross_amount`, `aic_quantity`, `aic_gross_amount`, retroactive zeroing, Enterprise Cloud 적용 상태를 확인하는 1차 출처입니다.
• Billing reports reference — AI usage report의 필드, 집계 기준, 상세 리포트 맥락을 확인하는 기준 문서입니다.
• Usage-based billing for organizations and enterprises — 2026-06-01 AI Credits billing model 전환과 Copilot Business/Enterprise 사용량 과금 배경을 설명합니다.
• Viewing your usage of metered products and licenses — 관리자가 AI usage 화면과 usage report 다운로드 경로를 확인하는 문서입니다.
• Billing usage REST API — Enterprise-level AI credit usage endpoint, 필터, API 자동화 맥락을 확인하는 문서입니다.
• API access to billing usage reports now generally available — billing usage report를 API로 요청하고 CSV로 다운로드하는 자동화 맥락을 보강합니다.
• Budget and usage management APIs now generally available — AI Credits 비용 통제와 예산 관리 API를 함께 점검할 때 필요한 공식 업데이트입니다.
• GitHub Copilot is moving to usage-based billing — 2026-04-27 Copilot usage-based billing 전환 발표로, 6월 1일 AI Credits 전환 배경을 확인하는 출처입니다.