https://api.tokios.com/v1로, sk-tok-… 키와 함께 지정하면, Copilot Chat과 에이전트 모드가 터널 없이 로컬 모델을 호출할 수 있습니다.
BYOK는 2026년 사월 VS Code에서 GA되었습니다. Copilot의 설정 UI는 릴리스마다 변경되므로, 설치된 버전에서 정확한 메뉴 경로와 필드 레이블을 확인하세요.
전제 조건
- 로컬 모델과 페어링된 실행 중인 Tokios 커넥터 — 참고: Connector install
- 등록된 모델 배포 이름 — 참고: Register a model
- Tokios API 키(
sk-tok-…) — 참고: API Keys - GitHub Copilot 및 Copilot Chat 확장 프로그램이 설치되고 로그인된 VS Code
BYOK는 Copilot Business 및 Enterprise 플랜에서 사용할 수 있습니다. GitHub의 Copilot plans and features 페이지에서 어떤 티어에 BYOK가 포함되어 있는지 확인하세요 — 누락된 설정을 문제 해결하기 전에 계정을 확인하세요.
Copilot을 Tokios로 지정
1
Open the model picker
명령 팔레트에서 Chat: Manage Language Models를 실행하거나, Copilot Chat을 열고 채팅 입력 위의 모델 피커를 클릭한 다음 Manage Models… 를 선택하세요. 정확한 문구는 Copilot Chat 버전에 따라 다르므로 해당 버전을 확인하세요.
2
Choose the OpenAI-compatible provider
커스텀 OpenAI 호환 엔드포인트(BYOK)를 추가하는 옵션을 선택하세요. GitHub의 문서는 이를 Ollama, vLLM, Foundry Local과 같은 이름 있는 프로바이더와 함께 “OpenAI Chat Completions API와 호환되는 다른 엔드포인트” 추가라고 일반적으로 설명합니다 — 해당 버전의 정확한 레이블은 약간 다를 수 있습니다.
3
Enter the base URL
엔드포인트 URL을 다음으로 설정합니다:
4
Add your deployment as the model
등록한 공개 배포 이름을 Models 탭에서 확인하세요 — 예:
gemma-tunnel. 이것은 Copilot이 model 필드에서 전송하는 값이며, Ollama, llama.cpp, vLLM, LM Studio의 로컬 모델 ID가 아닙니다.5
Paste your Tokios API key
사용자의
sk-tok-… 키를 커스텀 모델의 API 키 필드에 붙여넣습니다. Copilot은 모든 요청에서 이를 Bearer 토큰으로 전송합니다.대신
gemma-tunnel을 등록한 배포 이름으로, sk-tok-YOUR_KEY를 실제 키로 교체하세요. 둘 다 공유 설정 파일에 커밋하지 마세요.공개 HTTPS 엔드포인트가 필요한 이유
Copilot의 BYOK 요청은 구성한 엔드포인트를 대상으로 VS Code에서 전송됩니다 — 하지만 해당 엔드포인트는 Copilot의 클라이언트 측 확장 프로그램이 실행되는 곳에서 여전히 도달 가능해야 하며, 단순http://localhost:11434는 VS Code와 모델이 정확히 같은 머신에 있는 경우에만 작동합니다. 다른 노트북, devcontainer, 또는 원격 워크스페이스를 사용하는 순간 localhost는 더 이상 모델을 가리키지 않습니다.
Tokios의 커넥터는 아웃바운드 전용이므로 모델이 인바인드 포트를 열지 않으며, 모든 요청에 아무것도 아닌 범위 지정된 sk-tok-… 키가 포함됩니다:
- 인증 없는 노출 없음 — 커넥터는 Tokios로 외부 연결하며, 포트에서 수신하지 않고, 요청에는 유효한 키가 필요합니다.
- 안정적인 URL —
https://api.tokios.com/v1은 재시작 사이에 변경되지 않으므로 Copilot에서 한 번만 설정하면 어떤 머신에서든 계속 작동합니다. - 범위 지정된 키 — 키는 특정 배포로 제한될 수 있으며, 유출 시 로컬 모델이나 커넥터를 건드리지 않고 즉시 취소할 수 있습니다.
문제 해결
BYOK option is missing from the model picker
BYOK option is missing from the model picker
Copilot 플랜에 BYOK가 포함되지 않을 수 있습니다. 계정이 BYOK를 지원하는 티어에 있는지 확인하세요(위의 전제 조건 노트 참조).
401 error
401 error
Copilot이 전송한 API 키가 없거나, 형식이 잘못되었거나, 취소되었습니다. 여분의 공백 없이 전체
sk-tok-… 키를 붙여넣었는지 확인하고, Keys 탭에서 상태를 확인하세요.404 error
404 error
Copilot이 전송한
model 값이 등록된 배포와 일치하지 않습니다. Copilot의 커스텀 모델 이름이 Models 탭의 공개 이름과 정확히 일치하는지 확인하세요 — Ollama/llama.cpp/vLLM/LM Studio 로컬 모델 ID가 아닙니다.503 error
503 error
해당 배포의 커넥터가 오프라인이거나 동시성 한도에 도달했습니다. Connectors 탭을 확인하세요 — 커넥터가 Online으로 표시되어야 하며, 실행 중인 머신이 여전히 켜져 있고 도달 가능해야 합니다.
Inline completions still use GitHub's models
Inline completions still use GitHub's models
이것은 예상된 동작입니다. BYOK는 Copilot Chat과 에이전트 모드에만 영향을 줍니다 — 인라인 완성은 BYOK를 통해 구성할 수 없습니다.
다음 단계
Quickstart
커넥터를 페어링하고, 모델을 등록하고, 처음부터 API 키를 생성하세요.
Compatible clients
다른 OpenAI 및 Anthropic 호환 클라이언트의 Base URL 및 키 설정을 확인하세요.