GitHub Copilot CLI

환경 변수 네 개 — COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_TYPE, COPILOT_PROVIDER_API_KEY, COPILOT_MODEL — 로 Copilot CLI를 자체 엔드포인트로 전환합니다. GitHub 문서에 따르면 BYOK에는 GitHub 로그인이 필요하지 않습니다

# Set before you start Copilot CLI. Variable names and order are GitHub's;
# COPILOT_PROVIDER_BASE_URL and COPILOT_MODEL are the two marked Required.
export COPILOT_PROVIDER_BASE_URL=https://api.kunavo.com/v1   # see the note below
export COPILOT_PROVIDER_TYPE=openai                          # the default, shown for clarity
export COPILOT_PROVIDER_API_KEY=sk-kn-...
export COPILOT_MODEL=claude-sonnet-5

copilot

단계별 안내

1. /app/keys에서 키를 생성해 복사하세요. 키는 한 번만 표시됩니다.
2. 오래된 ~/.copilot/providers.json 파일(또는 COPILOT_PROVIDERS_CONFIG가 가리키는 파일)이 있는지 확인하세요. 여기에 제공업체나 모델이 선언되어 있다면 3단계의 모든 설정에 우선 적용됩니다.
3. 위와 같이 COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_API_KEY, COPILOT_MODEL를 내보내세요. COPILOT_PROVIDER_TYPE의 기본값은 openai이며, GitHub는 이를 “다른 모든 OpenAI Chat Completions API 호환 엔드포인트”를 포괄한다고 설명합니다.
4. 같은 셸에서 copilot를 시작하세요. 이 값은 시작할 때 읽으므로, 이전에 열어 둔 터미널에는 이전 값이 남아 있습니다.
5. 파일을 읽고 수정하는 작업을 시키세요. Copilot CLI가 사용하려면 모델이 도구 호출과 스트리밍을 지원해야 하며, 이 두 가지를 모두 시험하는 첫 실행이 인사말보다 더 많은 정보를 줍니다. 두 ID를 비교하려면 한 번의 실행에 --model를 사용해 COPILOT_MODEL를 재정의하세요.

GitHub의 “GitHub Copilot CLI에서 자체 LLM 모델 사용하기”에서 확인했습니다(2026년 9월 21일 기준). 서드파티 설정은 변경될 수 있으므로, 여기의 필드 이름이 실제 화면과 다르면 이 문서가 아니라 해당 페이지를 기준으로 삼으세요.

클라이언트를 디버깅하기 전에 확인할 사항

한 번의 요청으로 문제가 엔드포인트, 키 또는 구성 파일 중 어디에 있는지 판단할 수 있습니다. 이 요청에서 JSON이 반환되면 동일한 base URL과 키가 GitHub Copilot CLI에서 작동합니다.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

필드에 입력할 model id

모든 텍스트 모델은 model id로 접근할 수 있습니다. 현재 목록은 GET /v1/models이며, 가격이 포함된 카탈로그는 모델 페이지에서 확인할 수 있습니다. 요금은 토큰 100만 개당 USD 기준이며 입력 / 출력 순서입니다.

다른 경로: COPILOT_PROVIDER_TYPE=anthropic

GitHub는 제공업체 유형 세 가지를 문서화하며, Kunavo는 그중 두 가지 와이어 형식을 제공합니다. /v1/chat/completions는 openai용이고 /v1/messages는 anthropic용입니다. GitHub 페이지의 Anthropic 예시는 환경 변수 네 개를 설정하며, 기본 URL은 출처만 표시한 https://api.anthropic.com입니다.

1. COPILOT_PROVIDER_TYPE=anthropic
2. COPILOT_PROVIDER_BASE_URL — GitHub 예시의 형식으로 볼 때 접미사 없는 https://api.kunavo.com입니다. Anthropic 자체 경로가 해당 출처 아래의 /v1/messages에 있고 Kunavo도 이를 미러링하기 때문입니다. 앞서와 같은 주의사항이 적용됩니다. GitHub가 보여 주는 것은 예시이지 규칙이 아닙니다.
3. COPILOT_PROVIDER_API_KEY — 본인의 sk-kn- 키입니다. Kunavo의 Messages 엔드포인트는 이를 x-api-key 또는 Authorization: Bearer로 받을 수 있으므로, 여기서 CLI가 어떤 헤더를 선택하든 읽을 수 있습니다.
4. COPILOT_MODEL — 제공업체가 기대하는 ID입니다. GitHub 예시에는 하이픈이 있는 Anthropic 형식의 표기가 나오지만, 자체 지원 모델 목록에서는 같은 계열을 점으로 구분해 표기합니다. BYOK에서는 ID가 사용자 엔드포인트로 전달되므로 위 표에 나온 표기를 사용하세요.

이 페이지가 openai 유형을 먼저 다루는 이유는 다음과 같습니다. GitHub 문서 어디에도 Anthropic BYOK 경로가 cache_control, anthropic-beta 또는 특정 anthropic-version를 전달하는지 나와 있지 않습니다. 반복되는 컨텍스트는 청구액에 영향을 줍니다. 프롬프트 캐싱을 참조하세요. 문서에 없는 답을 이 페이지에서 가정할 수는 없습니다. openai 유형에는 그런 미해결 문제가 없으므로, 구성 블록을 채워 제공하는 유형으로 선택했습니다.