GitHub Copilot 모델 종료: 12월 14일 이전 전환과 BYOK

GitHub Copilot은 2026년 12월 14일 호스팅 모델 6개를 종료합니다. Claude Fable 5, Haiku 4.5, Gemini 3.8 Flash, Gemini 4 Argon, Grok 4.6의 권장 대체 모델과 후속 모델이 발표되지 않은 Kimi K3의 대응 방법을 설명합니다. 개인 연간 구독 예외, Business·Enterprise 관리자 정책, 코드에 고정된 모델 ID 변경, 외부 API와 BYOK 연결 방법 및 검증 절차를 확인할 수 있습니다.

목차
GitHub Copilot 모델 종료: 12월 14일 이전 전환과 BYOK

GitHub Copilot은 2026년 12월 14일 호스팅 모델 6개의 제공을 종료합니다. Chat에서 해당 모델을 선택하는 개발자뿐 아니라 설정 파일과 연동 도구에 모델 ID를 고정한 팀도 영향을 받습니다. 종료 전에 GitHub가 권장하는 대체 모델로 전환하고, 관리자 정책에서 사용이 허용되는지 확인해야 합니다. 일부 대체 모델은 관리자가 직접 활성화해야 합니다. Kimi K3, Gemini 4 Argon 또는 Claude Fable 5를 계속 사용해야 한다면 별도의 호환 API를 확인할 수 있습니다. 다만 외부 API로 연결해도 GitHub가 호스팅하는 모델 목록에 해당 모델이 복구되지는 않습니다.

GitHub는 11월 13일 모델 종료 공지에서 날짜와 권장 대체 모델을 공개했습니다. 2026년 11월 16일 기준으로 Copilot 내 호스팅 모델의 종료와 모든 독립 API 제공업체에서의 종료는 구분해야 합니다.

12월 14일에 종료되는 GitHub Copilot 모델은 무엇인가요?

Copilot Chat, 인라인 편집, ask 및 agent 모드, 코드 자동 완성 등 Copilot의 전체 사용 환경에서 다음 6개 모델이 종료될 예정입니다.

종료되는 Copilot 모델종료 날짜GitHub 권장 대체 모델
Claude Fable 52026년 12월 14일Claude Fable 5.2
Claude Haiku 4.52026년 12월 14일*Claude Haiku 5.5
Gemini 3.8 Flash2026년 12월 14일Gemini 4 Hydrogen
Gemini 4 Argon2026년 12월 14일Gemini 4 Carbon
Grok 4.62026년 12월 14일Grok 4.7
Kimi K32026년 12월 14일To be announced

GitHub Copilot의 개인 연간 구독자는 Claude Haiku 4.5를 종료 날짜 이후에도 사용할 수 있습니다.

이 예외는 개인 연간 구독에만 적용됩니다. GitHub의 공지는 개인 월간 구독이나 Business·Enterprise 라이선스까지 예외를 확대하지 않습니다.

Kimi K3의 대체 모델에는 To be announced라고 표시되어 있습니다. 11월 13일 공지에서 GitHub는 후속 모델을 지정하지 않았습니다. Kimi K3.1 Pro나 다른 Kimi 모델을 Copilot의 공식 후속 모델로 간주해서는 안 됩니다.

이번 종료는 GitHub가 Copilot을 통해 직접 호스팅하는 모델에 적용됩니다. 독립 API 제공업체에서도 같은 모델을 종료한다는 발표는 아닙니다.

GitHub는 종료 모델을 자동으로 제거하므로 사용자가 수동으로 삭제할 필요는 없다고 안내합니다. 하지만 저장된 모델 선택, 연동 설정, 팀 구성은 종료 전에 변경해야 합니다. 모델이 목록에서 삭제되어도 코드에 적힌 ID는 자동으로 바뀌지 않습니다.

개인 개발자는 Copilot에서 모델을 어떻게 변경하나요?

현재 Copilot Chat에서 종료 대상 모델을 사용한다면 먼저 모델 선택 메뉴에서 권장 대체 모델을 선택합니다. 이어서 실제 개발 작업을 다시 실행해 기능을 검증합니다.

Visual Studio Code에서는 다음 순서로 진행합니다.

  1. Copilot Chat을 엽니다.
  2. Chat 화면 하단의 모델 선택 메뉴를 엽니다.
  3. 구독 요금제와 조직 정책에서 허용하는 대체 모델을 선택합니다.
  4. 새 대화를 시작하고 저장소 파일 읽기나 실패한 테스트 분석처럼 익숙한 작업을 요청합니다.
  5. 모델이 응답하고 필요한 도구도 정상적으로 작동하는지 확인합니다.

이 과정은 GitHub의 Copilot Chat 모델 변경 안내에 설명되어 있습니다.

Chat 모델을 변경해도 인라인 코드 제안에 사용하는 모델은 자동으로 바뀌지 않습니다. 코드 자동 완성을 사용한다면 해당 기능도 별도로 확인해야 합니다.

작업 유형과 구독 요금제에 따라 대체 모델 선택하기

GitHub의 권장 모델은 이전을 시작할 때 참고할 대상입니다. 기능, 컨텍스트 한도, 도구 호출 방식, 비용이 기존 모델과 같다고 보장되지는 않습니다.

Gemini 3.8 Flash를 사용했다면 Gemini 4 Hydrogen부터 확인합니다. 빠른 코딩 지원이나 여러 도구 호출이 이어지는 작업에 적합한 후보입니다.

GitHub는 11월 13일 Gemini 4 Hydrogen의 정식 출시를 발표했습니다. GitHub에 따르면 빠른 에이전트 기반 코딩, 도구 사용, 다단계 작업을 위해 설계되었습니다. Gemini 3.8 Flash보다 지시 이행 능력이 향상되었다고도 설명합니다.

Hydrogen은 Copilot Pro, Pro+, Max, Business, Enterprise 사용자에게 제공되며 단계적으로 배포됩니다. 발표에는 VS Code, Visual Studio, Copilot CLI, GitHub coding agent, Copilot 앱, github.com, 모바일 앱, JetBrains, Xcode, Eclipse, Copilot SDK가 포함되어 있습니다.

Hydrogen이 모델 목록에 없다면 요금제, 배포 상태, 조직의 모델 정책을 먼저 확인합니다. 배포 중 목록에 나타나지 않는다고 해서 영구적으로 사용할 수 없는 것은 아닙니다.

Copilot 외부에서 Gemini API를 직접 호출한다면 Gemini 4 Hydrogen API 이전 및 요금 안내를 참고할 수 있습니다.

Gemini 4 Argon을 사용했다면 Gemini 4 Carbon부터 확인합니다. 복잡한 코딩, 추론, 보안 관련 개발 작업을 위한 권장 대체 모델입니다.

GitHub는 11월 10일 Carbon 발표에서 이러한 용도를 명시했습니다. Carbon은 Copilot Pro+, Max, Business, Enterprise에서 정식 제공되며 단계적으로 배포됩니다.

Copilot Pro만 구독하는 사용자는 Carbon에 바로 접근할 수 있다고 가정해서는 안 됩니다. 발표된 대상 요금제에 Pro 단독 구독은 없습니다. 이전 계획을 세우기 전에 실제 접근 권한을 확인해야 합니다.

Google API를 직접 사용하는 애플리케이션은 Gemini 4 Carbon API 이전 안내에서 요청 매개변수와 과금 조건을 확인합니다.

Claude Fable 5를 사용했다면 Claude Fable 5.2부터 검증합니다. 대규모 코드베이스의 복잡한 다단계 코딩 작업에 GitHub가 권장하는 모델입니다.

GitHub의 11월 9일 발표에는 초기 테스트에서 Fable 5.2가 Fable 5.1보다 더 많은 작업을 해결하면서 단계와 도구 호출 수를 줄였다는 내용이 있습니다. 이는 GitHub가 보고한 평가 결과이며 모든 저장소에서 동일한 결과를 보장하지는 않습니다.

Fable 5.2는 Pro+, Max, Business, Enterprise에서 정식 제공됩니다. 단, Business와 Enterprise에서는 관리자가 직접 활성화해야 합니다. 관련 정책은 기본적으로 꺼져 있습니다.

독립적인 코딩 작업 비교가 필요하다면 Coding Agent Index의 Fable 5.2와 Opus 5.5 비교 분석을 참고합니다.

Claude Haiku 4.5 또는 Grok 4.6을 사용한다면 GitHub가 권장하는 Claude Haiku 5.5와 Grok 4.7부터 검토합니다. 모델 선택 메뉴에 표시되는지 확인하고 대표 작업을 테스트한 뒤 팀 기본값을 변경합니다.

Kimi K3를 사용한다면 GitHub가 아직 Copilot용 후속 모델을 발표하지 않았다는 점에 주의해야 합니다. GitHub 호스팅 모델만 사용해야 한다면 현재 선택 가능한 모델을 실제 작업에 맞춰 비교합니다.

Kimi K3.1 Pro는 별도 API에서 검토할 수 있는 후보일 뿐 GitHub가 지정한 공식 후속 모델은 아닙니다. 외부 연결 방법은 Kimi K3.1 Pro 코딩 도구 설정 안내를 참고합니다.

팀의 기본 모델을 바꾸기 전에 비용 확인하기

모델에 접근할 수 있다는 사실과 사용 비용은 별개입니다. 에이전트가 대량의 컨텍스트를 보내고 도구 호출을 반복한다면 비용 차이가 커질 수 있습니다.

GitHub에 따르면 Gemini 4 Hydrogen, Gemini 4 Carbon, Claude Fable 5.2는 Copilot의 사용량 기반 과금에서 제공업체의 정가를 적용합니다.

Copilot 모델 및 요금 문서는 입력 토큰, 출력 토큰, 캐시 토큰의 사용량을 구분합니다. 모델별 가격을 계산한 다음 GitHub AI Credits로 환산하며, 1 AI credit = $0.01 USD입니다.

요금제마다 기본 제공되는 AI Credits가 다릅니다. 포함된 할당량을 초과하면 문서에 명시된 토큰당 요금으로 추가 과금됩니다.

팀 기본 모델을 변경하기 전에 같은 코딩 작업의 토큰 사용량, 도구 호출, 최종 청구 금액을 비교합니다. 구독에 포함된 크레딧과 외부 API 토큰 가격을 같은 기준으로 단순 비교해서는 안 됩니다.

Copilot Business와 Enterprise 관리자는 무엇을 활성화해야 하나요?

GitHub의 기본 모델 활성화 정책에서는 Business와 Enterprise에 권장되는 대체 모델이 일반적으로 자동 활성화됩니다.

하지만 전역 기본 정책이 꺼져 있거나 특정 모델이 명시적으로 차단된 경우에는 적용되지 않습니다. 자동 활성화 대상에서 제외된 모델도 마찬가지입니다.

Claude Fable 5.2는 예외입니다. GitHub의 11월 9일 발표에 따르면 관리자 정책이 기본적으로 비활성화되어 있습니다. 따라서 관리자가 데이터 보관 조건을 검토한 후 직접 켜야 합니다.

조직 관리자의 설정 절차

조직에 모델 정책 관리 권한이 있다면 다음과 같이 진행합니다.

  1. GitHub에서 Organizations를 열고 해당 조직을 선택합니다.
  2. Settings를 엽니다.
  3. Code, planning, and automation 아래의 Copilot을 선택합니다.
  4. Models를 엽니다.
  5. 각 대체 모델을 찾아 현재 설정을 확인합니다.
  6. 조직에서 허용할 모델을 Enabled로 설정합니다.

자세한 화면 경로는 GitHub의 조직 모델 가용성 관리 안내에 있습니다.

같은 화면에서 Default availability for released models를 설정할 수도 있습니다. 모델이 Delegate to Default Policy로 지정되면 적용 대상인 경우 조직의 기본 정책을 따릅니다.

Enterprise 소유자가 모델 설정을 강제로 적용했다면 조직 관리자는 이를 덮어쓸 수 없습니다. 이 경우 Enterprise 관리자에게 제한 사항을 확인해야 합니다.

Enterprise 관리자의 설정 절차

Enterprise 소유자는 전체 사용자에게 적용할 모델 정책을 중앙에서 관리할 수 있습니다. 조직이나 enterprise teams에 결정을 위임할 수도 있습니다.

  1. GitHub에서 Enterprise 계정을 엽니다.
  2. AI controls를 선택합니다.
  3. Copilot을 엽니다.
  4. Configure models를 선택합니다.
  5. 승인된 대체 모델을 전체 사용자에게 활성화하거나 조직 또는 enterprise teams에 권한을 위임합니다.
  6. 대상 조직과 팀에서 실제로 사용할 수 있는지 확인합니다.

GitHub는 Enterprise 모델 가용성 관리 문서에 이러한 설정을 안내합니다.

Enterprise가 enterprise teams를 통한 모델 접근 제어 미리보기 기능을 선택하면 조직 수준의 모델 설정은 비활성화됩니다. 이때는 Enterprise 팀별로 접근 권한을 관리해야 합니다.

Fable 5.2에 별도 승인이 필요한 이유

GitHub의 Fable 5.2 출시 공지에 따르면 Anthropic은 이 모델을 사용할 때 안전 분류기를 실행하기 위해 데이터를 보관합니다. 여기에는 프롬프트와 출력이 포함됩니다.

GitHub는 보관된 데이터를 Anthropic 모델 학습에 사용하지 않는다고 설명합니다. 그러나 관리자가 Fable 5.2 정책을 활성화하면 해당 데이터 보관 요구사항을 인정한 것으로 간주합니다.

기밀 소스 코드나 민감한 데이터가 있는 저장소에 모델을 허용하기 전에 조직의 정보 관리 정책을 확인해야 합니다.

GitHub는 자격을 갖춘 Enterprise 고객을 위한 한시적인 예외도 안내합니다. 기본 데이터 보관 요구사항에서 예외를 승인받으면 Claude Fable 5, Fable 5.1, Fable 5.2를 데이터 보관 없이 사용할 수 있습니다.

이 예외는 Anthropic이 Enterprise Frontier Safeguards (EFS)를 도입하는 동안인 2026년 말까지만 적용됩니다.

이 기간 이후 발표된 조건으로 모델을 계속 사용하려면 EFS가 필요합니다. GitHub에 따르면 EFS는 자동화된 안전 모니터링과 적격 고객을 위한 추가 데이터 보관 옵션을 제공할 예정입니다.

예외 적용 자격은 담당 GitHub account team에 문의해야 합니다. GitHub Support는 자격 여부를 판정하거나 접근을 승인할 수 없습니다.

예외 승인을 받더라도 모델 정책은 자동으로 활성화되지 않습니다. Business 또는 Enterprise 관리자가 Fable 5.2 정책을 별도로 켜야 합니다.

조직에서 일반 데이터 보관 조건을 수용할 수 없고 승인된 예외도 없다면 다른 허용 모델을 선택해야 합니다.

관리자 정책이 적용됐는지 검증하기

관리자가 정책을 변경했다면 영향을 받는 사용자에게 Copilot Chat을 다시 열도록 요청합니다.

지원되는 클라이언트의 모델 선택 메뉴에 활성화된 대체 모델이 나타나야 합니다. 해당 모델을 선택하고 평소의 코딩 작업을 실행합니다.

모델이 계속 보이지 않는다면 Enterprise 기본 정책, 조직 위임 설정, 개별 차단, 요금제 자격, 배포 상태를 확인합니다.

관리자 화면에서 설정을 저장한 것만으로는 이전이 완료됐다고 볼 수 없습니다. 사용자 화면에 모델이 표시되고 실제 작업이 완료되는지까지 확인해야 합니다.

코드에 고정된 종료 예정 모델 ID는 어떻게 변경하나요?

Copilot Chat의 모델 선택 메뉴만 바꿔서는 소스 코드, 스크립트, 설정 파일, 연동 도구에 지정한 이전 모델 ID가 변경되지 않습니다.

화면에 표시되는 모델 이름과 API 형식의 식별자를 모두 찾아야 합니다. GitHub 클라이언트와 외부 API 제공업체의 식별자는 다를 수 있습니다.

저장소 루트에서 Bash 터미널을 열고 ripgrep으로 검색합니다.

rg -n -i 'Claude Fable 5|Claude Haiku 4\.5|Gemini 3\.8 Flash|Gemini 4 Argon|Grok 4\.6|Kimi K3|claude-fable-5|claude-haiku-4-5|gemini-3\.8-flash|gemini-4-argon|grok-4\.6|kimi-k3' .

이 명령은 참조 위치를 찾기 위한 것으로 파일을 자동 변경하지 않습니다. 다른 별칭, 저장소 외부 설정, .gitignore로 제외한 파일은 놓칠 수 있습니다.

특히 다음 항목을 점검합니다.

  • Copilot SDK 초기화 코드와 세션 설정
  • 에이전트 설정과 모델 라우팅 규칙
  • Copilot을 호출하는 저장소 자동화
  • CI 구성과 모델을 선택하는 환경 변수
  • 모델 식별자를 문자열로 저장하는 내부 도구

고정된 모델 값은 해당 클라이언트에서 지원하는 정확한 ID로 바꿔야 합니다. Claude Fable 5.2라는 표시 이름이 모든 API에서 유효한 모델 ID인 것은 아닙니다.

새 모델의 공식 연결 방법에서 변경을 요구하지 않는다면 기존 endpoint와 인증 설정은 그대로 유지합니다.

에이전트 연동은 전체 작업 흐름을 검증합니다.

  1. 대체 모델로 새 세션을 시작합니다.
  2. 에이전트에게 알고 있는 저장소 파일을 읽도록 요청합니다.
  3. 쉽게 되돌릴 수 있는 작은 코드 수정이나 도구 호출을 요청합니다.
  4. 결과를 확인하고 관련 테스트를 실행합니다.
  5. 사용 기록에서 호출된 모델과 예상치 못한 오류를 확인합니다.

텍스트 응답이 성공했다고 해서 파일 편집이나 도구 호출까지 정상 작동한다고 볼 수 없습니다.

대체 모델을 찾을 수 없다면 접근 정책부터 확인합니다. 클라이언트가 ID를 거부한다면 해당 클라이언트의 지원 모델 문서를 참조합니다.

12월 14일 전에 목록 확인과 수정 작업을 마쳐야 합니다. GitHub가 모델을 자동 제거해도 코드의 설정까지 고쳐주지는 않습니다.

Kimi K3, Gemini 4 Argon 또는 Fable 5를 계속 사용할 수 있나요?

독립 API 제공업체가 해당 모델을 계속 제공하고 실제 요청을 처리한다면 외부 API를 통해 사용할 수 있습니다.

Copilot 모델 종료 공지는 GitHub가 호스팅하는 모델에 관한 내용입니다. 모든 외부 API 제공업체에서 동시에 모델을 종료한다는 발표는 아닙니다.

2026년 11월 16일 기준 BetterToken의 구조화된 모델 카탈로그에는 다음 ID가 등록되어 있었습니다.

모델BetterToken API Model ID
Kimi K3kimi-k3
Gemini 4 Argongemini-4-argon
Claude Fable 5claude-fable-5
Claude Haiku 4.5claude-haiku-4-5-20251001

이 값은 BetterToken API에서 사용하는 Model ID입니다. GitHub가 호스팅하는 Copilot 모델의 식별자가 아닙니다.

BetterToken은 사용량에 따라 요금이 부과되는 별도 API 서비스입니다. GitHub Copilot 구독이나 모델 제공업체의 공식 구독을 대신하지 않습니다.

카탈로그에 표시되어도 요청 성공이나 영구적인 모델 제공이 보장되지는 않습니다. 실제 운영에 사용하기 전에 현재 모델 접근 가능 여부와 요금을 확인해야 합니다.

방법 1: Cline 또는 OpenCode로 외부 API 연결하기

사용자 지정 API endpoint를 지원하는 코딩 도구가 필요하다면 OpenAI-compatible 제공업체를 설정할 수 있는 Cline을 선택할 수 있습니다.

BetterToken의 Cline 설정 문서에 따라 다음과 같이 진행합니다.

  1. VS Code에 Cline을 설치하고 콘솔에서 본인의 BetterToken API Key를 생성합니다.
  2. Cline을 열고 Use your own API key를 선택합니다.
  3. API Provider를 OpenAI Compatible로 지정합니다.
  4. Base URL에 https://www.bettertoken.ai/v1을 입력합니다.
  5. Cline의 인증 정보 필드에 키를 넣고 모델이 제공되는 경우 Model을 kimi-k3로 설정합니다.
  6. 설정을 저장한 후 필요하면 Cline을 다시 로드합니다.
  7. Verify로 연결을 확인하고 짧은 테스트 프롬프트를 보냅니다.

인증 오류나 모델 오류 없이 응답하는지 확인합니다. 다음으로 알고 있는 프로젝트 파일을 읽기 전용으로 조회하도록 요청합니다.

선택한 모델의 확인된 컨텍스트 및 출력 한도를 설정해야 합니다. 도구 호출, 이미지 입력, Computer Use는 모델과 endpoint에서 모두 지원할 때만 활성화합니다.

OpenCode도 문서화된 연결 경로를 제공합니다. OpenAI-compatible 구성에서는 @ai-sdk/openai-compatible, Base URL https://www.bettertoken.ai/v1, bettertoken과 같은 제공업체 ID를 사용합니다.

OpenCode 1에서는 전역 구성을 ~/.config/opencode/opencode.json에 저장하거나 프로젝트 루트의 opencode.json을 사용할 수 있습니다. 실제 API Key를 JSON에 입력하지 말고 /connect를 이용해 인증 정보를 로컬에 저장합니다.

문서에 명시된 Kimi K3 모델 선택 값은 bettertoken/kimi-k3입니다. 자세한 내용은 OpenCode Kimi K3 설정 문서를 참조합니다.

Claude Code는 다른 프로토콜을 사용합니다. BetterToken Claude Code 연동 문서에 명시된 Anthropic-compatible Base URL은 https://bettertoken.ai이며, 끝에 /v1을 추가하지 않습니다.

Cline의 OpenAI-compatible Base URL을 Claude Code에 그대로 복사해서는 안 됩니다.

방법 2: API를 직접 호출해 모델 검증하기

Cline 또는 다른 도구의 문제를 분석하기 전에 제공업체 API에서 모델이 직접 응답하는지 먼저 확인합니다.

BetterToken은 OpenAI-compatible Chat Completions endpoint를 문서화하고 있습니다. 다음 Bash 예시는 kimi-k3에 짧은 응답을 요청합니다.

read -rs BETTERTOKEN_API_KEY && export BETTERTOKEN_API_KEY

curl -sS -i 'https://www.bettertoken.ai/v1/chat/completions' \
  -H "Authorization: Bearer ${BETTERTOKEN_API_KEY}" \
  -H 'Content-Type: application/json' \
  --data '{
    "model": "kimi-k3",
    "messages": [
      {
        "role": "user",
        "content": "Reply with OK."
      }
    ]
  }'

첫 번째 명령이 입력을 기다리면 콘솔에서 생성한 API Key를 붙여 넣고 Enter를 누릅니다. 입력값은 화면에 표시되지 않으며 명령문에 키를 직접 적을 필요도 없습니다.

요청이 성공하면 HTTP 200을 반환하며 모델의 답변은 choices[0].message.content에 들어 있습니다.

표의 다른 Model ID도 현재 OpenAI-compatible Chat Completions를 지원한다면 같은 요청 형식을 사용할 수 있습니다.

오류가 발생하면 다음 사항부터 확인합니다.

결과우선 확인할 항목
400요청 JSON, 모델 매개변수, 메시지 구조
401API Key와 Bearer 인증
402계정의 사용 가능 잔액
404/v1/chat/completions가 포함된 전체 요청 URL
429요청 빈도, 동시 실행 한도, 상위 서비스 부하
Model not found최신 카탈로그의 정확한 Model ID

BetterToken Chat Completions API 문서는 직접 HTTP 요청에 사용하는 URL과 SDK Base URL을 구분합니다.

직접 호출할 때는 https://www.bettertoken.ai/v1/chat/completions를 사용합니다. SDK가 리소스 경로를 자동으로 붙인다면 https://www.bettertoken.ai/v1을 사용합니다.

짧은 텍스트 요청이 성공해도 스트리밍, 도구 호출, 최대 컨텍스트까지 정상 작동한다는 뜻은 아닙니다. 실제 사용할 코딩 클라이언트에서 별도로 테스트해야 합니다.

GitHub Copilot BYOK로 사용자 지정 API를 연결할 수 있나요?

지원되는 클라이언트에서는 가능합니다. GitHub의 Bring Your Own Key(BYOK) 설명서는 사용자가 설정한 모델을 호환 클라우드 또는 로컬 제공업체에 직접 연결하는 방식을 설명합니다.

2026년 11월 17일 기준 GitHub의 BYOK 지원 클라이언트 목록에는 VS Code, JetBrains, Xcode, Copilot CLI, GitHub Copilot app, Copilot SDK가 포함되어 있습니다.

각 클라이언트의 설정 방식과 지원 기능은 다릅니다. 목록에 있다고 해서 모든 API 프로토콜이나 모델을 지원하는 것은 아닙니다.

사용자 지정 모델을 추가하더라도 GitHub 호스팅 목록에서 종료된 모델이 다시 제공되는 것은 아닙니다.

VS Code에서 Custom Endpoint 설정하기

VS Code의 Custom Endpoint는 Chat Completions, Responses, Anthropic Messages API를 지원합니다. BetterToken의 Chat Completions에 연결할 때는 전체 요청 URL을 사용해야 합니다.

호환되는 VS Code 설치 환경과 정확한 Model ID, 본인의 제공업체 API Key가 필요합니다.

VS Code Custom Endpoint 설정 안내에 따라 진행합니다.

  1. Command Palette에서 Chat: Manage Language Models를 실행합니다.
  2. Add Models를 선택한 다음 Custom Endpoint를 엽니다.
  3. BetterToken과 같은 그룹 이름을 입력합니다.
  4. 표시할 이름과 API Key를 입력합니다. VS Code가 생성한 비밀 키 참조를 유지해야 합니다.
  5. API 유형으로 Chat Completions를 선택합니다.
  6. 자동으로 생성된 chatLanguageModels.json을 열고 모델 속성을 설정합니다.
  7. 파일을 저장한 다음 Chat 모델 선택 메뉴에서 추가한 모델을 선택합니다.

다음은 kimi-k3에 대한 chatLanguageModels.json 설정 예시입니다. apiKey의 참조 ID는 예시입니다. 실제로는 VS Code가 생성한 비밀 키 참조를 그대로 사용해야 합니다.

[
  {
    "name": "BetterToken",
    "vendor": "customendpoint",
    "apiKey": "${input:chat.lm.secret.xxxxx}",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "kimi-k3",
        "name": "Kimi K3",
        "url": "https://www.bettertoken.ai/v1/chat/completions",
        "toolCalling": false,
        "vision": false,
        "maxInputTokens": 8192,
        "maxOutputTokens": 2048
      }
    ]
  }
]

8192와 2048은 처음에 작은 텍스트 요청을 테스트하기 위해 정한 클라이언트 설정값입니다. Kimi K3의 공식 최대 컨텍스트 또는 출력 한도를 나타내지 않습니다.

실제 작업에 사용하기 전 모델의 최신 문서를 확인하고 적절한 값으로 바꿉니다. maxInputTokens와 maxOutputTokens의 합은 모델의 컨텍스트 창 크기를 초과하면 안 됩니다.

예시에서는 도구 호출과 이미지 입력을 비활성화했습니다. 모델, endpoint, 클라이언트가 모두 지원하는지 확인한 후 활성화해야 합니다. Agent 모드에서는 도구 호출이 필요합니다.

vendor 값은 반드시 customendpoint여야 합니다. id는 API로 전송되는 모델 식별자이며 name은 모델 선택 메뉴에 표시되는 이름입니다.

apiType은 요청 프로토콜을 결정합니다. url에는 SDK Base URL이 아니라 Chat Completions의 전체 endpoint가 지정되어 있습니다.

짧은 URL을 입력하면 VS Code가 API 유형에 맞는 리소스 경로를 추가할 수 있습니다. Custom Endpoint URL 처리 규칙은 혼동을 피하기 위해 전체 API 경로 사용을 권장합니다.

VS Code에서는 apiKey에 ${input:chat.lm.secret...} 형식의 비밀 키 참조를 사용할 수 있습니다. 입력한 인증 정보는 로컬에 저장되고 JSON에는 참조만 남습니다. 이를 실제 키 값으로 바꾸면 안 됩니다.

저장한 모델이 목록에 나타나지 않으면 VS Code 창을 다시 시작합니다. kimi-k3를 선택하고 짧은 텍스트 요청을 보냅니다.

텍스트 응답이 정상이라면 파일 수정을 맡기기 전에 도구 호출 기능을 별도로 테스트합니다.

BYOK로 복구되지 않는 Copilot 기능

VS Code에서 BYOK는 Chat과 보조 작업에 적용됩니다. 인라인 코드 제안, 의미 기반 검색, 임베딩에 의존하는 일부 기능에는 여전히 GitHub 계정이 필요합니다.

Copilot harness 세션에서 지원되는 BYOK 모델을 사용하려면 VS Code의 실험적 설정 chat.agentHost.byokModels.enabled를 켜야 합니다. 이 설정을 켜도 모든 외부 모델이 모든 에이전트 기능을 지원하는 것은 아닙니다.

Business 및 Enterprise 관리자는 조직이나 기업 정책을 통해 사용자 개인의 BYOK 설정을 제한할 수 있습니다.

Copilot CLI에서는 사용자 지정 제공업체를 ~/.copilot/providers.json에 설정합니다. openai 유형은 OpenAI-compatible 서비스에, anthropic 유형은 Anthropic 방식의 서비스에 사용됩니다.

GitHub는 이 JSON 파일의 인증 정보가 평문으로 저장된다고 경고합니다. 환경 변수 문자열도 자동으로 해석되지 않습니다. 사용 전 Copilot CLI에 LLM 모델을 추가하는 방법을 확인하고 해당 파일을 공유하거나 저장소에 커밋하지 마세요.

Enterprise가 중앙에서 관리하는 사용자 지정 모델

GitHub는 Enterprise 관리자가 추가하는 사용자 지정 모델도 지원합니다. 이 기능은 2026년 11월 기준 public preview 상태입니다.

Enterprise 소유자는 기업 설정에 제공업체 API Key를 추가할 수 있습니다. Enable custom models 정책을 사용해 조직 관리자에게 설정 권한을 위임할 수도 있습니다.

GitHub의 지원 제공업체 범주에는 OpenAI-compatible providers가 포함됩니다. 조건을 충족하는 Copilot Business 또는 Enterprise 사용자는 Copilot Chat, Copilot CLI, 지원되는 IDE에서 사용자 지정 모델을 사용할 수 있습니다.

개인이 설정하는 BYOK와 달리, 이러한 모델 요청은 GitHub Copilot API를 거칩니다. 사용자에게는 Copilot 라이선스와 인터넷 연결이 필요하지만 제공업체 키를 각자 설정할 필요는 없습니다.

GitHub Enterprise 사용자 지정 모델 설정 문서에서 인증 정보 추가 및 조직별 접근 권한 설정 절차를 확인할 수 있습니다.

공개 미리보기 기능이므로 조직 전체의 전환 수단으로 사용하기 전에 모델과 필요한 Copilot 클라이언트의 호환성을 검증해야 합니다.

12월 14일 전에 무엇을 최종 확인해야 하나요?

모델 종료 전에 개발자가 실제 사용하는 클라이언트에서 권장 대체 모델을 테스트해야 합니다.

개인 사용자는 대체 모델이 목록에 나타나고 평소의 코딩 작업을 완료하는지 확인합니다. Claude Haiku 4.5 예외를 적용받으려면 적격한 개인 연간 구독이 있어야 합니다.

Business와 Enterprise 관리자는 영향을 받는 사용자 계정에서 정책이 적용됐는지 확인합니다. Fable 5.2는 명시적인 활성화와 데이터 보관 요구사항에 특히 주의해야 합니다.

연동 도구 담당자는 코드에 고정된 기존 Model ID를 바꾸고 실제 파일 작업과 도구 호출을 검증합니다. 텍스트 응답만 확인해서는 충분하지 않습니다.

Kimi K3 또는 다른 이전 모델을 계속 사용해야 한다면 종료일 전에 독립 API에서 실제 접근할 수 있는지 확인합니다. 외부 API의 모델 제공 여부, BYOK 설정, GitHub 호스팅 Copilot 모델 목록은 서로 다른 조건으로 운영됩니다.

LLM 워크플로를 최적화할 준비가 되셨나요?

하나의 API로 모델을 연결하고 키와 AI 비용을 관리하세요.

무료로 시작하기