Skip to main content
GitHub Copilot의 Bring Your Own Key (BYOK) 설정은 VS Code에서 “OpenAI Chat Completions API와 호환되는 모든 엔드포인트”를 허용합니다. Tokios는 그러한 엔드포인트 중 하나입니다. Copilot을 https://api.tokios.com/v1로 지정하고 sk-tok-… 키를 사용하면 Copilot Chat과 에이전트 모드가 터널 없이 로컬 모델을 호출할 수 있습니다. BYOK went GA in VS Code in April 2026. Copilot’s settings UI changes across releases, so confirm the exact menu path and field labels against your installed version.

​
사전 요구 사항

  • A running Tokios connector paired with your local model — see Connector Install
  • A registered model deployment name — see Register a Model
  • A Tokios API key (sk-tok-…) — see API Keys
  • GitHub Copilot 및 Copilot Chat 확장 프로그램이 설치되고 로그인된 VS Code
  • A Copilot plan that includes BYOK. GitHub’s changelog for the April 2026 GA describes BYOK as available on Business/Enterprise plans, while some app-support notes also mention Pro — confirm which tiers your account needs before troubleshooting a missing setting.
BYOK는 Copilot Chat and agent mode only 에 적용됩니다. 인라인 코드 완성은 변경하지 않으며, 추가한 BYOK 모델과 관계없이 계속 GitHub 자체 완성 모델을 사용합니다.

​
Copilot을 Tokios에 연결하세요.

1

모델 선택기를 엽니다

Run Chat: Manage Language Models from the command palette, or open Copilot Chat and click the model picker above the chat input, then select Manage Models…. The exact wording varies by Copilot Chat version, so check yours.
2

OpenAI 호환 제공자를 선택하세요.

사용자 지정 OpenAI 호환 엔드포인트(BYOK)를 추가하는 옵션을 선택하세요. GitHub 문서에서는 이를 Ollama, vLLM, Foundry Local과 같은 명명된 공급자와 함께 “OpenAI Chat Completions API와 호환되는 다른 모든 엔드포인트”를 추가하는 것으로 일반적으로 설명합니다. 정확한 라벨은 사용하는 버전에 따라 약간 다를 수 있습니다.
3

기본 URL을 입력하세요

엔드포인트 URL을 다음으로 설정하세요.
4

배포를 모델로 추가하세요

Enter the public deployment name you registered on the Models tab — for example, gemma-tunnel. This is the value Copilot sends in the model field; it is not Ollama’s, llama.cpp’s, vLLM’s, or LM Studio’s local model id.
5

Tokios API 키를 붙여넣으세요

당신의 sk-tok-… 키를 사용자 지정 모델의 API 키 필드에 붙여넣으세요. Copilot은 모든 요청에서 이를 Bearer 토큰으로 전송합니다.
Replace gemma-tunnel with the deployment name you registered, and sk-tok-YOUR_KEY with your own key. Never commit either into a shared settings file.

​
공개 HTTPS 엔드포인트가 필요한 이유

Copilot의 BYOK 요청은 사용자가 구성한 엔드포인트를 대상으로 VS Code에서 이루어집니다. 하지만 그 엔드포인트는 Copilot의 클라이언트 측 확장이 실행되는 어디에서나 도달 가능해야 하며, 단순한 http://localhost:11434는 VS Code와 모델이 정확히 같은 머신에 있을 때만 작동합니다. 다른 노트북, devcontainer 또는 원격 작업 공간에 있게 되면 localhost는 더 이상 모델을 가리키지 않습니다. Tokios의 커넥터는 아웃바운드 전용이므로 모델이 인바운드 포트를 열지 않으며, 모든 요청은 범위가 지정된 sk-tok-… 키를 전혀 없는 대신 지닙니다.
  • 인증되지 않은 노출 없음 — 커넥터는 Tokios로 아웃바운드 연결을 하며, 포트에서 수신 대기하지 않고, 요청에는 유효한 키가 필요합니다.
  • Stable URL — https://api.tokios.com/v1는 재시작 사이에 변경되지 않으므로 Copilot에서 한 번 설정하면 어떤 머신에서든 계속 작동합니다.
  • Scoped keys — 키는 특정 배포로 제한될 수 있으며, 유출 시 로컬 모델이나 커넥터를 건드리지 않고 즉시 폐기할 수 있습니다.

​
문제 해결

Copilot 플랜에는 BYOK가 포함되지 않을 수 있습니다. 계정이 이를 지원하는 등급인지 확인하십시오(위의 사전 요구 사항 참고).
Copilot이 보낸 API 키가 누락되었거나, 형식이 잘못되었거나, 해지되었습니다. 추가 공백 없이 전체 sk-tok-… 키를 붙여넣었는지 확인하고, Keys 탭에서 상태를 확인하세요.
Copilot이 보낸 model 값이 등록된 배포와 일치하지 않습니다. Copilot의 사용자 지정 모델 이름이 Models 탭의 공개 이름과 정확히 일치하는지 확인하세요. Ollama/llama.cpp/vLLM/LM Studio 로컬 모델 ID가 아닙니다.
해당 배포의 커넥터가 오프라인 상태이거나 동시 실행 한도에 도달했습니다. Connectors 탭을 확인하세요. 커넥터가 Online로 표시되어야 하며, 이를 실행 중인 머신이 계속 켜져 있고 연결 가능해야 합니다.
이는 예상된 동작입니다. BYOK는 Copilot Chat과 에이전트 모드에만 영향을 미칩니다. 인라인 완성은 BYOK로 구성할 수 없습니다.

​
다음 단계

빠른 시작

처음부터 커넥터를 페어링하고, 모델을 등록하고, API 키를 만드세요.

호환되는 클라이언트

다른 OpenAI 및 Anthropic 호환 클라이언트의 기본 URL 및 키 설정을 참조하세요.