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

BYOK (bring your own key)는 GitHub Copilot의 공식 기능으로, 자체 모델 제공자를 연결하여 내장된 GPT나 Claude 대신 나만의 모델로 에이전트 세션을 실행할 수 있습니다. 2026년 1월부터는 모든 OpenAI 호환 endpoint가 지원되며, 6월 23일부터는 Copilot 앱의 모든 유료 플랜에서 public preview로 BYOK를 사용할 수 있고, 7월 14일부터는 JetBrains 버전에서도 지원됩니다. 즉, Copilot을 셸로 유지하면서 추론은 JoinGonka Gateway를 통해 실행할 수 있습니다. 이를 통해 Gonka의 탈중앙화 네트워크 가격으로 이용하며 구독의 프리미엄 요청을 소모하지 않습니다.

BYOK의 장점 및 필요성

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

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

타임라인: 출시 기록

시기	내용
2025년 11월	BYOK public preview: Anthropic, OpenAI, xAI, Microsoft Foundry; VS Code, JetBrains, Eclipse, Xcode 내 Agent, Plan, Ask, Edit 모드
2026년 1월	모든 OpenAI 호환 제공자 + AWS Bedrock 및 Google AI Studio 지원; Responses API 지원 모델
2026년 6월 23일	GitHub Copilot 앱 내 BYOK — 모든 유료 플랜 대상 public preview
2026년 7월 14일	JetBrains용 Copilot에서 사용자 정의 OpenAI 호환 endpoints 지원 (Pro 플랜 이상)

JoinGonka Gateway 연결 단계

jg-… 키가 필요합니다. 이는 게이트웨이 등록 시 10M 무료 토큰과 함께 제공되며, 카드는 필요하지 않습니다.

1. 설정	Settings → Model Providers를 엽니다 (VS Code는 Copilot Chat을 통해, Copilot 앱은 계정 설정 내)
2. 제공자	endpoint에 `https://gate.joingonka.ai/v1`를 입력하여 "OpenAI compatible" 타입의 제공자를 추가합니다
3. 키	`jg-…` 키를 입력하세요(로컬 키체인에 저장됩니다)
4. 모델	네트워크 모델이 내장 모델 옆의 선택기에 나타납니다. 최신 목록은 `GET /v1/models`를 확인하세요: `moonshotai/Kimi-K2.6`, `MiniMaxAI/MiniMax-M2.7`, `deepseek-ai/DeepSeek-V4-Flash-0731`
5. 세션	세션별로 모델을 선택하세요. Copilot-hosted와 BYOK 모델은 자유롭게 전환할 수 있습니다

힌트: npx @joingonka/setup --tool copilot-byok 명령어는 아래 필드에 대한 준비된 값(base URL, 키, 최신 제한이 적용된 모델 ID)을 출력하고, 게이트웨이가 이를 수락하는지 실시간 요청으로 확인합니다. Copilot 자체는 UI를 통해서만 설정할 수 있으며, 안전하게 수정할 수 있는 파일이 없으므로 값을 수동으로 입력해야 합니다.

네트워크 모델 선택 가이드

세 네트워크 모델 모두 스트리밍과 tool calling을 지원합니다. deepseek-ai/DeepSeek-V4-Flash-0731은 네트워크에서 가장 긴 컨텍스트(380K 토큰)와 최대 32768 토큰 출력을 제공하여 대규모 리포지토리 및 긴 에이전트 세션에 적합합니다. moonshotai/Kimi-K2.6은 다단계 작업에 강력한 에이전트 모델입니다. MiniMaxAI/MiniMax-M2.7은 범용 모델입니다. Kimi와 MiniMax는 최대 8192 토큰을 출력합니다.

public preview 제한 사항

BYOK는 에이전트 세션과 채팅을 지원하지만, 에디터 내의 inline-제안은 여전히 Copilot 모델을 사용할 수 있습니다. 이는 프로바이더의 문제가 아니라 Copilot 자체의 제한입니다. 기업용 BYOK는 조직 단위로 설정되며 GitHub Enterprise/Business에서 사용할 수 있습니다. 게이트웨이를 통한 비전 작업은 작동하지 않습니다(네트워크 모델은 텍스트 전용). 도구가 Responses API 형식으로 요청을 보내는 경우 게이트웨이에서 지원하지 않으므로 Chat Completions를 선택하십시오.

BYOK는 Copilot을 한도 제한이 있는 구독에서 자체 추론 제어 셸로 전환합니다. Settings → Model Providers → endpoint gate.joingonka.ai/v1 + jg- 키만 입력하면 에이전트 세션이 Gonka 모델과 실시간 가격으로 실행되며 프리미엄 할당량을 소모하지 않습니다. 10M 무료 토큰으로 시작해 보세요.

← JetBrains IDE + JoinGonka Gateway — 크레딧 대신 자체 endpoint 사용 Zed + JoinGonka Gateway — 에디터 내 저렴한 추론 →

더 자세히 알고 싶으세요?

다른 섹션을 탐색하거나 지금 GNK를 얻기 시작하세요.

copilot-byok.cta.text →