GitHub Copilot BYOK — 할당량 대신 자체 모델 사용

Copilot 구독은 프리미엄 요청을 월 단위로 제한하며, 에이전트 세션, 리팩토링, 다단계 작업이 할당량을 가장 빨리 소모합니다. BYOK는 이러한 호출을 자신의 제공자로 라우팅하여 Copilot의 프리미엄 할당량을 소모하지 않고 자신의 제공자 가격으로 청구되도록 합니다. 키는 시스템 키체인에 저장되며 인터페이스가 읽을 수 없습니다.

한도에 도달했거나, 오픈 웨이트 모델을 사용하고 싶거나, 추론 비용을 훨씬 더 저렴하게 지불하고 싶을 때 BYOK는 합리적인 선택입니다. Gonka 네트워크는 벤더의 표준 가격보다 수백 배 저렴하게 오픈 소스 모델을 제공하며, 실제 가격은 언제나 게이트웨이의 실시간 가격표에서 확인할 수 있습니다.

jg-… 키가 필요합니다. 이 키는 게이트웨이 등록 시 스타터 3M 무료 토큰과 함께 발급되며, 카드는 필요하지 않습니다. 키와 모델은 각 Copilot 클라이언트마다 개별적으로 설정합니다 — 아래 세 가지 방법을 소개합니다.

VS Code — Custom Endpoint 프로바이더. 이것이 현재的方法입니다. 기존의 "OpenAI Compatible" 프로바이더와 github.copilot.chat.customOAIModels 설정은 더 이상 사용되지 않습니다.

"models": [
  {
    "id": "deepseek-ai/DeepSeek-V4-Flash-0731",
    "name": "DeepSeek V4 Flash (Gonka)",
    "url": "https://gate.joingonka.ai/v1/chat/completions",
    "toolCalling": true,
    "vision": false,
    "maxInputTokens": 347232,
    "maxOutputTokens": 32768
  },
  {
    "id": "MiniMaxAI/MiniMax-M2.7",
    "name": "MiniMax M2.7 (Gonka)",
    "url": "https://gate.joingonka.ai/v1/chat/completions",
    "toolCalling": true,
    "vision": false,
    "maxInputTokens": 191808,
    "maxOutputTokens": 8192
  },
  {
    "id": "zai-org/GLM-5.3-Flash",
    "name": "GLM 5.3 Flash (Gonka)",
    "url": "https://gate.joingonka.ai/v1/chat/completions",
    "toolCalling": true,
    "vision": false,
    "maxInputTokens": 381808,
    "maxOutputTokens": 8192
  }
]

maxInputTokens는 모델의 컨텍스트 윈도우에서 응답 상한을 뺀 값입니다. maxOutputTokens와 함께 윈도우를 정의합니다. toolCalling: true가 없으면 에이전트 사용 시 모델이 목록에 나타나지 않습니다.

Copilot CLI — 환경 변수만 사용. 이 프로바이더에는 설정 파일이 없으며, 값은 copilot을 실행하는 셸에서 설정합니다:

export COPILOT_PROVIDER_BASE_URL=https://gate.joingonka.ai/v1
export COPILOT_PROVIDER_TYPE=openai
export COPILOT_PROVIDER_API_KEY=jg-your-key
export COPILOT_MODEL=deepseek-ai/DeepSeek-V4-Flash-0731
export COPILOT_PROVIDER_MAX_PROMPT_TOKENS=347232
export COPILOT_PROVIDER_MAX_OUTPUT_TOKENS=32768
copilot

COPILOT_PROVIDER_* 이름은 Copilot CLI만 읽기 때문에 이 설정이 다른 도구에 영향을 주지 않습니다. CLI는 모델에 tool calling과 스트리밍을 요구하며, 네트워크의 모든 모델이 이를 지원합니다.

JetBrains — GitHub Copilot 플러그인. Copilot Chat 열기 → 모델 목록 → Manage Models를 선택하고 OpenAI 호환 엔드포인트 프로바이더를 고른 뒤 Add Models를 클릭하고 Base URL https://gate.joingonka.ai/v1, 키 jg-…, 모델 식별자를 입력하세요. Save를 클릭하고 자신의 키 아래에 있는 모델을 체크한 후 다시 저장하면 내장 모델 옆에 나타납니다.

팁. npx @joingonka/setup --tool copilot-byok 명령을 실행하면 세 섹션 모두가 당신의 키와 선택한 모델의 실제 한도와 함께 출력됩니다 — VS Code용 "models" 배열도 포함되며 — 라이브 요청으로 게이트웨이가 키와 모델을 받아들이는지도 검증합니다. 파일은 전혀 쓰지 않습니다. 각 Copilot 클라이언트는 키를 자체 저장소에 보관합니다.

네트워크의 세 가지 모델 모두 스트리밍과 tool calling을 지원합니다. deepseek-ai/DeepSeek-V4-Flash-0731 — 네트워크에서 가장 긴 컨텍스트(380K 토큰)와 최대 32768 토큰의 가장 큰 출력을 제공하므로 대규모 리포지토리 및 긴 에이전트 세션에 적합합니다. MiniMaxAI/MiniMax-M2.7 — 범용 모델로, 출력은 최대 8192 토큰입니다. zai-org/GLM-5.3-Flash — 네트워크에서 가장 긴 컨텍스트(390K 토큰)를 가진 Z.ai의 추론(reasoning) 모델로, 답변 전에 추론을 수행하며 최대 8192 토큰을 출력합니다. 답변 예산의 일부가 추론에 사용되므로 설정에서 출력 제한을 너무 낮게 잡지 마십시오.

BYOK는 에이전트 세션과 채팅을 지원하지만, 인라인 제안 및 프로젝트 전체 시맨틱 검색은 여전히 Copilot 모델을 사용하며 GitHub 계정이 필요합니다. 이는 프로바이더가 아닌 Copilot 자체의 제한입니다. Copilot Business 및 Enterprise에서 로컬 BYOK는 관리자 정책('Bring Your Own Language Model Key')에 의해 제어됩니다. 인터페이스에 항목이 없으면 조직 차원에서 비활성화된 것입니다. 게이트웨이를 통한 Vision 작업은 작동하지 않는데, 네트워크 모델은 텍스트 전용이기 때문입니다. 도구가 Responses API 형식으로 요청을 보내면 게이트웨이가 이를 수락합니다(POST /v1/responses). 스트리밍 및 Function Tools도 작동합니다. 대화 이력은 저장하지 않으므로 store는 무시되며, previous_response_id는 오류를 반환합니다. 전체 대화 이력을 input에 전달하세요.