GitHub Copilot 할당량 조회: Premium Requests 및 모델 상세

학습 완료 후 할 수 있는 것

GitHub Copilot Premium Requests 월별 사용 현황 빠르게 보기
다양한 구독 유형(Free/Pro/Pro+/Business/Enterprise)의 한도 차이 이해
모델 사용 상세 보기(예: GPT-4, Claude 등 사용 횟수)
초과 사용 횟수 식별, 추가 비용 예측
새 OpenCode 통합의 권한 문제 해결(OAuth 토큰 할당량 조회 불가)

현재 문제 상황

새 OpenCode 통합의 권한 문제

OpenCode의 최신 OAuth 통합은 더 이상 /copilot_internal/* API 액세스를 부여하지 않아, 원래의 OAuth 토큰 방식으로 할당량을 조회할 수 없습니다.

다음과 같은 오류를 만날 수 있습니다:

⚠️ GitHub Copilot 할당량 조회가 일시적으로 사용 불가능합니다.
OpenCode의 새 OAuth 통합은 할당량 API 액세스를 지원하지 않습니다.

해결 방법:
1. fine-grained PAT 생성 (https://github.com/settings/tokens?type=beta 방문)
2. 'Account permissions'에서 'Plan'을 'Read-only'로 설정
...

이것은 정상적인 상황이며, 이 튜토리얼에서는 해결 방법을 가르칩니다.

핵심 개념

GitHub Copilot의 할당량은 다음 핵심 개념으로 나뉩니다:

Premium Requests(주 할당량)

Premium Requests은 Copilot의 주 할당량 지표로, 다음을 포함합니다:

Chat 상호작용(AI 어시스턴트와 대화)
Code Completion(코드 완성)
Copilot Workspace 기능(작업 공간 협업)

Premium Requests란 무엇인가?

간단히 이해: Copilot이 귀하를 위해 "일"을 할 때마다(코드 생성, 질문 답변, 코드 분석) Premium Request로 간주됩니다. 이것은 Copilot의 주 요금 단위입니다.

구독 유형 및 한도

다양한 구독 유형은 다른 월별 한도가 있습니다:

구독 유형	월별 한도	적용 대상
Free	50 회	개인 개발자 시험
Pro	300 회	개인 개발자 정식 버전
Pro+	1,500 회	중도 개인 개발자
Business	300 회	팀 구독(각 계정 300)
Enterprise	1,000 회	엔터프라이즈 구독(각 계정 1000)

초과 사용

월별 한도를 초과하더라도 Copilot은 계속 사용할 수 있지만, 추가 비용이 발생합니다. 초과 사용 횟수는 출력에 별도로 표시됩니다.

🎒 시작 전 준비

전제 조건

구성 확인

이 튜토리얼에서는 다음을 이미 완료했다고 가정합니다:

✅ opencode-mystatus 플러그인 설치
- 빠른 시작 참조
✅ 다음 중 최소한 하나 구성:
- OpenCode에서 GitHub Copilot 로그인(OAuth 토큰)
- Fine-grained PAT 구성 파일 수동 생성(권장)

구성 방법(둘 중 하나 선택)

방법 1: Fine-grained PAT 사용(권장)

가장 안정적인 방식으로, OpenCode OAuth 통합 변경의 영향을 받지 않습니다.

https://github.com/settings/tokens?type=beta 방문
"Generate new token (classic)" 또는 "Generate new token (beta)" 클릭
"Account permissions"에서 Plan을 Read-only로 설정
토큰 생성, 형식은 github_pat_11A...
구성 파일 ~/.config/opencode/copilot-quota-token.json 생성:

json

{
  "token": "github_pat_11A...",
  "username": "your-username",
  "tier": "pro"
}

구성 파일 필드 설명:

token: 귀하의 Fine-grained PAT
username: GitHub 사용자 이름(API 호출 필요)
tier: 구독 유형, 선택 가능한 값: free / pro / pro+ / business / enterprise

방법 2: OpenCode OAuth 토큰 사용

OpenCode에서 이미 GitHub Copilot에 로그인한 경우, mystatus는 귀하의 OAuth 토큰을 사용하려고 시도합니다.

호환성 설명

이 방식은 OpenCode OAuth 통합 권한 제한으로 인해 실패할 수 있습니다. 실패하면 방법 1(Fine-grained PAT)를 사용하세요.

단계별 따라하기

1단계: 조회 명령 실행

OpenCode에서 슬래시 명령을 실행합니다:

bash

/mystatus

다음을 확인해야 합니다:

Copilot 계정이 구성된 경우(Fine-grained PAT 또는 OAuth 토큰 사용), 출력은 다음과 같은 내용을 포함합니다:

## GitHub Copilot 계정 할당량

Account:        GitHub Copilot (pro)

Premium Requests [████████░░░░░░░░░] 40% (180/300)

모델 사용 상세:
  gpt-4: 120 requests
  claude-3-5-sonnet: 60 requests

Period: 2026-01

2단계: 출력 결과 해석

출력은 다음 핵심 정보를 포함합니다:

1. 계정 정보

Account:        GitHub Copilot (pro)

Copilot 구독 유형(pro/free/business 등)을 표시합니다.

2. Premium Requests 할당량

Premium Requests [████████░░░░░░░░░] 40% (180/300)

진행률 막대: 남은 비율 직관적 표시
비율: 남은 40%
사용/총: 사용 180회, 총 300회

진행률 막대 설명

녹색/노란색 채움은 사용량을, 공백은 남은 양을 나타냅니다. 채움을 많이 할수록 사용량이 많다는 것을 의미합니다.

3. 모델 사용 상세(공용 API만 해당)

모델 사용 상세:
  gpt-4: 120 requests
  claude-3-5-sonnet: 60 requests

각 모델의 사용 횟수를 표시하며, 사용량 내림차순 정렬(최대 5개 표시).

왜 내 출력에 모델 상세가 없나요?

모델 상세는 공용 API(Fine-grained PAT) 방식에서만 표시됩니다. OAuth 토큰(내부 API)를 사용하는 경우에는 모델 상세가 표시되지 않습니다.

4. 초과 사용(있는 경우)

월별 한도를 초과한 경우, 다음이 표시됩니다:

초과 사용: 25 요청

초과 사용은 추가 비용이 발생하며, 구체적인 요금은 GitHub Copilot 가격표를 참조하세요.

5. 재설정 시간(내부 API만 해당)

할당량 재설정: 12d 5h (2026-02-01)

할당량 재설정까지의 카운트다운을 표시합니다.

3단계: 일반적인 상황 확인

상황 1: "⚠️ 할당량 조회가 일시적으로 사용 불가"를 볼 때

이것은 정상적인 상황으로, OpenCode OAuth 토큰에 할당량 API 액세스 권한이 없음을 나타냅니다.

해결 방법: 「방법 1: Fine-grained PAT 사용」에 따라 PAT 구성.

상황 2: 진행률 막대가 전체 비어 있거나 거의 가득 찬 경우

전체 비어 있음 ░░░░░░░░░░░░░░░: 할당량 다 사용됨, 초과 사용 횟수 표시됨
거의 가득 참 ██████████████████: 거의 사용됨, 사용 빈도 제어 필요

상황 3: "Unlimited" 표시

일부 Enterprise 구독은 "Unlimited"로 표시될 수 있으며, 무제한을 의미합니다.

4단계: 오류 처리(조회 실패 시)

다음 오류를 볼 경우:

GitHub Copilot API 요청 실패 (403): Resource not accessible by integration

원인: OAuth 토큰에 Copilot API 액세스 권한이 충분하지 않습니다.

해결 방법: Fine-grained PAT 방식 사용(방법 1 참조).

검사점 ✅

위 단계를 완료한 후 다음을 수행할 수 있어야 합니다:

[ ] /mystatus 출력에서 GitHub Copilot 할당량 정보 볼 수 있음
[ ] Premium Requests 진행률 막대 및 비율 이해
[ ] 본인 구독 유형 및 월별 한도 파악
[ ] 모델 사용 상세 보는 방법 알기(Fine-grained PAT 사용 시)
[ ] 초과 사용의 의미 이해

주의 사항

함정 1: OAuth 토큰 할당량 조회 불가(가장 일반적)

일반적인 오류

⚠️ GitHub Copilot 할당량 조회가 일시적으로 사용 불가능합니다.
OpenCode의 새 OAuth 통합은 할당량 API 액세스를 지원하지 않습니다.

원인: OpenCode OAuth 통합은 /copilot_internal/* API 액세스 권한을 부여하지 않습니다.

해결: Fine-grained PAT 방식 사용, 「방법 1: Fine-grained PAT 사용」 참조.

함정 2: 구성 파일 형식 오류

구성 파일 ~/.config/opencode/copilot-quota-token.json 형식이 틀리면 조회가 실패합니다.

오류 예시:

json

// ❌ 오류: username 필드 누락
{
  "token": "github_pat_11A...",
  "tier": "pro"
}

올바른 예시:

json

// ✅ 올바름: 모든 필수 필드 포함
{
  "token": "github_pat_11A...",
  "username": "your-username",
  "tier": "pro"
}

함정 3: 구독 유형 잘못 입력

tier를 실제 구독과 다르게 입력하면 한도 계산이 틀릴 수 있습니다.

실제 구독	tier 필드에 입력해야 할 값	잘못 입력 예시
Free	`free`	`pro` ❌
Pro	`pro`	`free` ❌
Pro+	`pro+`	`pro` ❌
Business	`business`	`enterprise` ❌
Enterprise	`enterprise`	`business` ❌

실제 구독 유형 보는 방법:

https://github.com/settings/billing 방문
"GitHub Copilot" 섹션 보기

함정 4: 토큰 권한 부족

Classic 토큰(Fine-grained 아님)을 사용하고 "Plan" 읽기 권한이 없으면 403 오류가 반환됩니다.

해결:

Fine-grained 토큰 사용 확인(beta 버전 페이지에서 생성)
"Account permissions → Plan → Read-only" 권한 부여 확인

함정 5: 모델 상세 미표시

정상적인 현상

OAuth 토큰(내부 API) 방식을 사용하는 경우, 모델 사용 상세가 표시되지 않습니다.

이것은 내부 API가 모델 수준의 사용 통계를 반환하지 않기 때문입니다. 모델 상세가 필요하면 Fine-grained PAT 방식을 사용하세요.

이 수업 요약

이 수업에서는 opencode-mystatus를 사용하여 GitHub Copilot 할당량을 조회하는 방법을 설명했습니다:

핵심 요점:

Premium Requests은 Copilot의 주 할당량 지표로, Chat, Completion, Workspace 등 기능을 포함합니다
구독 유형이 월별 한도를 결정합니다: Free 50회, Pro 300회, Pro+ 1,500회, Business 300회, Enterprise 1,000회
초과 사용은 추가 비용을 발생하며, 출력에 별도로 표시됩니다
Fine-grained PAT은 권장하는 인증 방식으로, OpenCode OAuth 통합 변경의 영향을 받지 않습니다
OAuth 토큰 방식은 권한 제한으로 인해 실패할 수 있으며, PAT를 대안으로 사용해야 합니다

출력 해석:

진행률 막대: 남은 비율 직관적 표시
비율: 구체적인 남은 양
사용/총: 상세 사용 현황
모델 상세(선택 사항): 각 모델의 사용 횟수
재설정 시간(선택 사항): 다음 재설정까지 카운트다운

다음 수업 예고

다음 수업에서 **Copilot 인증 구성**를 배웁니다.
학습할 내용:
OAuth 토큰 및 Fine-grained PAT 상세 비교
Fine-grained PAT 생성 방법(전체 단계)
권한 문제 해결의 다양한 방안
다양한 시나리오에서 최적 사례

부록: 소스 코드 참조

소스 코드 위치 확인하려면 클릭

업데이트 시간: 2026-01-23

기능	파일 경로	행번호
Copilot 할당량 조회	`plugin/lib/copilot.ts`	481-524
---	---	---
공용 Billing API 조회	`plugin/lib/copilot.ts`	157-177
내부 API 조회	`plugin/lib/copilot.ts`	242-304
토큰 교환 로직	`plugin/lib/copilot.ts`	183-208
내부 API 포맷팅	`plugin/lib/copilot.ts`	354-393
공용 API 포맷팅	`plugin/lib/copilot.ts`	410-468
Copilot 구독 유형 정의	`plugin/lib/types.ts`	57-58
CopilotQuotaConfig 유형 정의	`plugin/lib/types.ts`	66-73
CopilotAuthData 유형 정의	`plugin/lib/types.ts`	46-51
Copilot 구독 한도 상수	`plugin/lib/copilot.ts`	397-403

핵심 상수:

COPILOT_PLAN_LIMITS: 각 구독 유형의 월별 한도(397-403행)
- free: 50
- pro: 300
- pro+: 1500
- business: 300
- enterprise: 1000
COPILOT_QUOTA_CONFIG_PATH: Fine-grained PAT 구성 파일 경로(93-98행)
- ~/.config/opencode/copilot-quota-token.json

핵심 함수:

queryCopilotUsage(): 주 조회 함수, 두 가지 인증 전략 지원(481-524행)
fetchPublicBillingUsage(): Fine-grained PAT 사용하여 공용 Billing API 조회(157-177행)
fetchCopilotUsage(): OAuth 토큰 사용하여 내부 API 조회(242-304행)
exchangeForCopilotToken(): OAuth 토큰 교환 로직(183-208행)
formatPublicBillingUsage(): 공용 API 응답 포맷팅, 모델 상세 포함(410-468행)
formatCopilotUsage(): 내부 API 응답 포맷팅(354-393행)

인증 전략:

전략 1(우선): Fine-grained PAT + 공용 Billing API 사용
- 장점: 안정적, OpenCode OAuth 통합 변경 영향을 받지 않음
- 단점: 사용자가 수동으로 PAT 구성 필요
전략 2(폴백): OAuth 토큰 + 내부 API 사용
- 장점: 추가 구성 불필요
- 단점: 권한 제한으로 인해 실패할 수 있음(현재 OpenCode 통합 지원하지 않음)

API 엔드포인트:

공용 Billing API: https://api.github.com/users/{username}/settings/billing/premium_request/usage
내부 할당량 API: https://api.github.com/copilot_internal/user
토큰 교환 API: https://api.github.com/copilot_internal/v2/token

GitHub Copilot 할당량 조회: Premium Requests 및 모델 상세 ​

학습 완료 후 할 수 있는 것 ​

현재 문제 상황 ​

핵심 개념 ​

Premium Requests(주 할당량) ​

구독 유형 및 한도 ​

초과 사용 ​

🎒 시작 전 준비 ​

전제 조건 ​

구성 방법(둘 중 하나 선택) ​

방법 1: Fine-grained PAT 사용(권장) ​

방법 2: OpenCode OAuth 토큰 사용 ​

단계별 따라하기 ​

1단계: 조회 명령 실행 ​

2단계: 출력 결과 해석 ​

1. 계정 정보 ​

2. Premium Requests 할당량 ​

3. 모델 사용 상세(공용 API만 해당) ​

4. 초과 사용(있는 경우) ​

5. 재설정 시간(내부 API만 해당) ​

3단계: 일반적인 상황 확인 ​

상황 1: "⚠️ 할당량 조회가 일시적으로 사용 불가"를 볼 때 ​

상황 2: 진행률 막대가 전체 비어 있거나 거의 가득 찬 경우 ​

상황 3: "Unlimited" 표시 ​

4단계: 오류 처리(조회 실패 시) ​

검사점 ✅ ​

주의 사항 ​

함정 1: OAuth 토큰 할당량 조회 불가(가장 일반적) ​

함정 2: 구성 파일 형식 오류 ​

함정 3: 구독 유형 잘못 입력 ​

함정 4: 토큰 권한 부족 ​

함정 5: 모델 상세 미표시 ​

이 수업 요약 ​

다음 수업 예고 ​

부록: 소스 코드 참조 ​

GitHub Copilot 할당량 조회: Premium Requests 및 모델 상세

학습 완료 후 할 수 있는 것

현재 문제 상황

핵심 개념

Premium Requests(주 할당량)

구독 유형 및 한도

초과 사용

🎒 시작 전 준비

전제 조건

구성 방법(둘 중 하나 선택)

방법 1: Fine-grained PAT 사용(권장)

방법 2: OpenCode OAuth 토큰 사용

단계별 따라하기

1단계: 조회 명령 실행

2단계: 출력 결과 해석

1. 계정 정보

2. Premium Requests 할당량

3. 모델 사용 상세(공용 API만 해당)

4. 초과 사용(있는 경우)

5. 재설정 시간(내부 API만 해당)

3단계: 일반적인 상황 확인

상황 1: "⚠️ 할당량 조회가 일시적으로 사용 불가"를 볼 때

상황 2: 진행률 막대가 전체 비어 있거나 거의 가득 찬 경우

상황 3: "Unlimited" 표시

4단계: 오류 처리(조회 실패 시)

검사점 ✅

주의 사항

함정 1: OAuth 토큰 할당량 조회 불가(가장 일반적)

함정 2: 구성 파일 형식 오류

함정 3: 구독 유형 잘못 입력

함정 4: 토큰 권한 부족

함정 5: 모델 상세 미표시

이 수업 요약

다음 수업 예고

부록: 소스 코드 참조