Zum Hauptinhalt springen
Die Bring Your Own Key-Einstellung (BYOK) von GitHub Copilot in VS Code akzeptiert „jeden Endpunkt, der mit der OpenAI Chat Completions API kompatibel ist.” Tokios ist einer dieser Endpunkte: Richten Sie Copilot auf https://api.tokios.com/v1 mit einem sk-tok-…-Schlüssel aus, und Copilot Chat und Agentenmodus können Ihr lokales Modell ohne Tunnel aufrufen. BYOK wurde in VS Code im April 2026 allgemein verfügbar (GA). Die Copilot-Einstellungs-Oberfläche ändert sich über Releases, also bestätigen Sie den genauen Menüpfad und die Feldbezeichnungen anhand Ihrer installierten Version.

Voraussetzungen

  • Ein laufender Tokios-Connector, der mit Ihrem lokalen Modell gekoppelt ist — siehe Connector-Installation
  • Ein registrierter Modell-Deployment-Name — siehe Ein Modell registrieren
  • Ein Tokios API-Schlüssel (sk-tok-…) — siehe API-Schlüssel
  • VS Code mit installierten und angemeldeten GitHub Copilot- und Copilot Chat-Erweiterungen
BYOK ist auf Copilot Business- und Enterprise-Plänen verfügbar. GitHubs Seite Copilot-Pläne und -Funktionen listet auf, welche Stufen BYOK enthalten — bestätigen Sie Ihr Konto, bevor Sie eine fehlende Einstellung troubleshooten.
BYOK gilt nur für Copilot Chat- und Agentenmodus. Es ändert nichts an den Inline-Code-Vervollständigungen — diese verwenden weiterhin die eigenen Vervollständigungsmodelle von GitHub, unabhängig von jedem BYOK-Modell, das Sie hinzufügen.

Copilot auf Tokios ausrichten

1

Open the model picker

Führen Sie Chat: Manage Language Models aus der Befehlspalette aus, oder öffnen Sie Copilot Chat und klicken Sie auf den Modell-Picker über dem Chat-Eingabefeld, dann wählen Sie Manage Models…. Die genaue Bezeichnung variiert je nach Copilot Chat-Version, also prüfen Sie Ihre.
2

Choose the OpenAI-compatible provider

Wählen Sie die Option zum Hinzufügen eines benutzerdefinierten OpenAI-kompatiblen Endpunkts (BYOK). GitHubs Dokumentation beschreibt dies allgemein als das Hinzufügen von „jedem anderen Endpunkt, der mit der OpenAI Chat Completions API kompatibel ist,” neben benannten Anbietern wie Ollama, vLLM und Foundry Local — die genaue Bezeichnung in Ihrer Version kann leicht abweichen.
3

Enter the base URL

Setzen Sie die Endpunkt-URL auf:
4

Add your deployment as the model

Geben Sie den öffentlichen Deployment-Namen ein, den Sie auf dem Tab Models registriert haben — zum Beispiel gemma-tunnel. Dies ist der Wert, den Copilot im model-Feld sendet; es ist nicht die lokale Modell-ID von Ollama, llama.cpp, vLLM oder LM Studio.
5

Paste your Tokios API key

Fügen Sie Ihren sk-tok-…-Schlüssel in das API-Schlüsselfeld für das benutzerdefinierte Modell ein. Copilot sendet ihn bei jeder Anfrage als Bearer-Token.
Ersetzen Sie gemma-tunnel durch den von Ihnen registrierten Deployment-Namen und sk-tok-YOUR_KEY durch Ihren eigenen Schlüssel. Übergeben Sie niemals einen davon in eine gemeinsam genutzte Einstellungsdatei.

Warum dies einen öffentlichen HTTPS-Endpunkt benötigt

Copilots BYOK-Anfragen werden von VS Code aus an den von Ihnen konfigurierten Endpunkt gesendet — aber dieser Endpunkt muss weiterhin erreichbar sein, überall dort, wo Copilots clientseitige Erweiterung läuft, und ein reines http://localhost:11434 funktioniert nur, wenn VS Code und Ihr Modell auf exakt derselben Maschine laufen. Sobald Sie auf einem anderen Laptop, einem Devcontainer oder einem Remote-Workspace sind, zeigt localhost nicht mehr auf Ihr Modell. Tokios’ Connector ist nur ausgehend, sodass Ihr Modell niemals einen eingehenden Port öffnet, und jede Anfrage trägt einen eingegrenzten sk-tok-…-Schlüssel statt gar nichts:
  • Keine unauthentifizierte Exposition — der Connector wählt ausgehend zu Tokios; er hört niemals auf einem Port, und Anfragen benötigen einen gültigen Schlüssel.
  • Stabile URL — https://api.tokios.com/v1 ändert sich nicht zwischen Neustarts, also richten Sie es einmal in Copilot ein und es funktioniert von jeder Maschine weiter.
  • Eingegrenzte Schlüssel — ein Schlüssel kann auf bestimmte Deployments begrenzt und im Falle eines Lecks sofort widerrufen werden, ohne Ihr lokales Modell oder den Connector zu berühren.

Fehlerbehebung

Ihr Copilot-Plan enthält möglicherweise kein BYOK. Bestätigen Sie, ob Ihr Konto auf einer Stufe ist, die es unterstützt (siehe die Voraussetzungen-Notiz oben).
Der von Copilot gesendete API-Schlüssel fehlt, ist fehlerhaft oder wurde widerrufen. Bestätigen Sie, dass Sie den vollständigen sk-tok-…-Schlüssel ohne zusätzliche Leerzeichen eingefügt haben, und prüfen Sie seinen Status auf dem Tab Keys.
Der von Copilot gesendete model-Wert stimmt nicht mit einem registrierten Deployment überein. Bestätigen Sie, dass der benutzerdefinierte Modellname in Copilot exakt dem öffentlichen Namen auf dem Tab Models entspricht — nicht Ihrer lokalen Ollama/llama.cpp/vLLM/LM Studio-Modell-ID.
Der Connector für dieses Deployment ist offline oder hat sein Gleichzeitigkeitslimit erreicht. Prüfen Sie den Tab Connectors — der Connector muss als Online angezeigt werden, und die Maschine, die ihn betreibt, muss weiterhin aktiv und erreichbar sein.
Dies ist erwartet. BYOK betrifft nur Copilot Chat und Agentenmodus — Inline-Vervollständigungen sind nicht über BYOK konfigurierbar.

Nächste Schritte

Schnellstart

Einen Connector koppeln, ein Modell registrieren und einen API-Schlüssel von Grund auf erstellen.

Kompatible Clients

Siehe Basis-URL und Schlüssel-Einrichtung für andere OpenAI- und Anthropic-kompatible Clients.