Copilot이 할 수 있다는 것을 아직 모르는 사람이 많습니다. 2026년 기준으로 GitHub Copilot은 자체 키 가져오기(Bring Your Own Key, BYOK) 기능을 GA(General Availability) 했습니다. 이제 Copilot Chat (VS Code에서), Copilot CLI, Copilot 앱, 그리고 Copilot SDK를 어떤 OpenAI 호환 엔드포인트, Anthropic 또는 Azure에도 연결할 수 있습니다. 여기에는 로컬 런타임과 타사 게이트웨이도 포함됩니다.

이는 이미 Copilot에 비용을 지불하고 있지만, 채팅 및 에이전트 기능을 사용자가 선택한 모델이나 게이트웨이에서 실행하고 싶은 경우 큰 장점입니다. 이 가이드에서는 네 가지 영역 모두를 다루며, 정확한 단계와 사람들이 어려워하는 하나의 솔직한 주의사항을 알려드립니다.

공개 고지: 저는 OpenAI 호환 게이트웨이인 daoxe와 Anthropic Messages 프로토콜도 지원하는 곳에서 작업하고 있습니다. 이 서비스가 Copilot의 세 가지 와이어 프로토콜과 깔끔하게 맞아떨어지기 때문에 예시로 사용하지만, 여기에 있는 모든 것은 호환되는 어떤 엔드포인트에서도 작동합니다. 사용자 본인의 기본 URL로 대체하십시오.

주의사항부터 말씀드립니다 (누구도 오해하지 않도록)

BYOK은 Copilot Chat과 에이전트 세션에 영향을 미칩니다. 인라인 완성(inline completions)에는 변화를 주지 않습니다. 회색으로 표시되는

export COPILOT_PROVIDER_BASE_URL=https://daoxe.com/v1
export COPILOT_PROVIDER_API_KEY=$DAOXE_API_KEY     # 환경 변수에서 가져온 게이트웨이 키
export COPILOT_MODEL=gpt-5.5                        # GET /v1/models에서 확인 가능한 정확한 ID
...

Claude의 네이티브 프로토콜 (native protocol)을 사용하려면, COPILOT_PROVIDER_TYPE=anthropic으로 설정하고 게이트웨이의 Anthropic 엔드포인트를 사용하세요. 먼저 curl을 통해 정확한 경로를 확인하세요 — 많은 게이트웨이가 호스트 루트(https://daoxe.com)를 사용하고 클라이언트가 /v1/messages를 추가하도록 허용하지만, 일부는 /v1을 요구합니다. 추측하지 말고 본인의 계정을 확인하세요.

2. Copilot Chat (VS Code)

1. 명령 팔레트 (Command Palette) → Chat: Manage Language Models.
2. OpenAI Compatible / Custom Endpoint를 선택합니다.
3. Base URL: https://daoxe.com/v1 (/chat/completions를 서빙해야 합니다). VS Code는 모델 드롭다운을 채우기 위해 GET /models를 탐색합니다. 게이트웨이가 이를 지원하면 모델이 자동으로 채워지며, 그렇지 않으면 모델 ID (Model ID)를 직접 입력하세요.
4. API Key를 붙여넣고, Model ID (예: claude-sonnet-4-6)를 선택한 후 → 모델 추가 (Add Model)를 클릭합니다.

이제 모델이 기본 내장 모델들과 함께 Copilot Chat 모델 선택기 (model picker)에 나타납니다.

3. Copilot App (데스크톱)

설정 (Settings) → 모델 제공자 (Model Providers) → 제공자 추가 (Add provider). 엔드포인트 https://daoxe.com/v1와 API 키를 입력하세요 (Claude 네이티브의 경우 anthropic 유형을 선택). 그러면 모델이 Copilot의 호스팅 모델 옆의 모델 선택기에 나타나며, 키는 운영체제(OS) 키체인에 저장됩니다.

4. Copilot SDK (통합 개발자용)

provider: {
  type: "openai",                    // 또는 "anthropic"
  baseUrl: "https://daoxe.com/v1",   // 전체 경로; anthropic의 경우 계정의 경로를 사용
...

모델 ID 정확하게 설정하기

Copilot은 사용자가 지정한 것만 호출하므로, 엔드포인트가 노출하는 정확한 ID를 사용하세요:

curl https://daoxe.com/v1/models -H "Authorization: Bearer $DAOXE_API_KEY"

추측한 이름은 조용히 실패하거나 기본값으로 되돌아갑니다. **계정 범위(account-scoped)**의 /v1/models를 제공하는 게이트웨이가 이 상황에 이상적입니다. 왜냐하면 당신이 보는 목록이 곧 당신이 호출할 수 있는 정확한 목록이기 때문입니다.

문제 해결 (Troubleshooting)

• VS Code에서 모델 드롭다운이 비어 있나요? 엔드포인트가 GET /models를 노출하지 않거나, 키에 권한이 부족할 수 있습니다. ID를 수동으로 입력하고 위의 curl 명령어로 키를 확인하세요.
• 401 / 인증(auth) 오류가 발생하나요? 제공업체가 Authorization: Bearer (OpenAI 방식)를 요구하는지, 아니면 x-api-key (일부 Anthropic 설정)를 요구하는지 확인하세요. 제공업체 유형에 맞춰 프로토콜을 일치시켜야 합니다.
• Anthropic 유형에서 404 오류가 발생하나요? 거의 항상 베이스 URL (base URL) 형태 문제입니다 — 루트(root)인지 /v1인지 확인하세요. 게이트웨이의 문서를 통해 검증하십시오.
• 채팅은 작동하지만 인라인 완성(inline completions)은 "변하지 않았나요"? 예상된 결과입니다 — 주의사항을 참조하세요. 인라인 완성은 Copilot의 모델을 그대로 사용합니다.

BYOK 대상을 선택할 때 살펴봐야 할 점

이제 백엔드를 선택하는 단계이므로, 다음 조건을 충족하는 것을 선택하세요:

• 멀티 프로토콜 (Multi-protocol). OpenAI Chat Completions 및 Responses, 그리고 Anthropic Messages를 모두 지원하여, Copilot의 모든 제공업체 유형이 작동하고 Claude가 네이티브 프로토콜에서 실행될 수 있어야 합니다.
• 하나의 키로 여러 모델 사용 가능, 계정 범위의 /v1/models를 제공해야 합니다.
• 검증 가능 (Verifiable). 벤치마킹을 통해 성능을 확인하고, 시스템이 조용히 성능을 낮추고(downgrading) 있지는 않은지 확인할 수 있어야 합니다 (이를 위한 전용 오픈 소스 도구들이 있습니다).
• 공식 결제가 불가능한 곳에서도 접근 가능할 것. 공식 결제 단계에서 카드가 계속 거절된다면, 다른 결제 경로를 허용하는 게이트웨이가 프로젝트 진행 여부를 결정짓는 차이를 만듭니다.

daoxe는 이러한 조건들을 충족합니다 — OpenAI 호환 베이스 URL (https://daoxe.com/v1), 네이티브 Anthropic Messages, 여러 모델에 걸친 하나의 키 — 그리고 중국 본토에서는 사용할 수 없습니다. 하지만 BYOK의 핵심은 이것입니다: 당신은 종속되지 않으며, 따라서 당신이 신뢰하고 검증할 수 있는 어떤 엔드포인트로든 Copilot을 연결하면 됩니다.

요약 (TL;DR)

• Copilot BYOK는 Chat, CLI, App, 그리고 SDK에서 작동하며, 베이스 URL(base URL)과 키(key)를 설정하면 됩니다.
• 멀티 프로토콜 게이트웨이(multi-protocol gateway)가 세 가지 Copilot 제공자 유형(openai / responses / anthropic)을 모두 지원합니다.
• /v1/models에서 제공하는 **정확한 모델 ID (model ids)**를 사용하세요.
• 인라인 완성 (Inline completions)은 변경되지 않습니다 — BYOK는 채팅/에이전트(chat/agent) 전용입니다.