BYOK · Einrichtung & Tarife

GitHub Copilot BYOK: eigener Key für Claude, GPT und chinesische Modelle

Stand 2026-10-07 beschreibt die QCode-Dokumentation zwei Stellen, an denen GitHub Copilot Claude mit Ihrem eigenen API-Key (BYOK) nutzen kann: den Custom Endpoint in VS Code Chat (apiType messages) und Copilot CLI (COPILOT_PROVIDER_TYPE=anthropic). Der benutzerdefinierte Endpunkt in JetBrains ist offiziell nur als OpenAI-kompatibel beschrieben; über QCode sind dort nur GPT und chinesische Modelle bestätigt. Laut VS-Code-Dokumentation brauchen BYOK-Modelle keinen Copilot-Tarif; Inline-Vorschläge laufen nicht über BYOK.

Aktualisiert 2026-10-08

#VS Code Custom Endpoint#Copilot CLI BYOK#Anthropic Messages#OpenAI-kompatibler Endpunkt

Vier Werte, auf die es ankommt

messages

apiType für Claude in VS Code

Der Custom Endpoint in VS Code unterstützt drei APIs: Chat Completions, Responses und Anthropic Messages. Die QCode-Dokumentation hält fest, dass Claude-Modelle nur mit messages funktionieren.

anthropic

Provider-Typ für Claude in Copilot CLI

COPILOT_PROVIDER_TYPE kennt offiziell nur openai (Standard), azure und anthropic. Für Claude setzen Sie anthropic, für GPT und chinesische Modelle openai.

Voller Pfad / Root-URL

Die beiden URL-Formen sind gegensätzlich

In VS Code reicht die url bis zum Anfragepfad, etwa https://api.qcode.cc/api/v1/messages; in der CLI enthält COPILOT_PROVIDER_BASE_URL nur https://api.qcode.cc/api. Die QCode-Dokumentation warnt: Die Formen sind gegensätzlich, wer eine in die andere kopiert, scheitert.

Nicht nötig

Copilot-Tarif für BYOK in VS Code

Laut VS-Code-Dokumentation funktionieren BYOK-Modelle ohne GitHub-Anmeldung und ohne Copilot-Tarif; Admins bei Copilot Business und Enterprise können das per Richtlinie abschalten.

Was Copilot BYOK ist und wo es gilt

Stand 2026-10-07 bedeutet Copilot BYOK, dass Sie in einem Copilot-Client die URL und den API-Key Ihres eigenen Modellanbieters eintragen, sodass Chat- und Agent-Anfragen an den von Ihnen konfigurierten Endpunkt gehen statt an von GitHub gehostete Modelle. Die GitHub-Dokumentation unterscheidet zwei Arten. Lokales BYOK verarbeitet Keys nur im Client und speichert sie lokal; unterstützt wird es in VS Code, JetBrains, Xcode, Copilot CLI, der GitHub Copilot app und dem Copilot SDK. Beim Enterprise-BYOK hinterlegen Enterprise- oder Organisationsinhaber die Keys zentral für Nutzer von Copilot Business und Enterprise; das ist derzeit eine öffentliche Vorschau. Laut GitHub hängt lokales BYOK nicht von der Copilot API ab und eignet sich daher für abgeschottete Netze und Nutzer ohne Copilot-Abo. Es betrifft nur den Chat: Laut VS-Code-Dokumentation brauchen Inline-Vorschläge (Code-Vervollständigung) und semantische Suche weiterhin ein GitHub-Konto.

Warum BYOK gerade gefragt ist

GitHub hat in gut einem Monat drei Runden von Abkündigungen für die eingebauten Copilot-Modelle angekündigt. Laut GitHub-Changelog wurden am 2026-09-01 unter anderem Claude Opus 4.5, Opus 4.6, Sonnet 4.5 und Sonnet 4.6 in den meisten Copilot-Umgebungen abgekündigt (Sonnet 4.6 bleibt für Einzelabonnenten mit Jahresplan); am 2026-10-02 verschwanden Claude Opus 4.7 und drei weitere Modelle aus allen Copilot-Umgebungen; am 2026-10-19 sollen sechs weitere folgen: GPT-5.5, GPT-5.4, GPT-5.4 mini, GPT-5 mini, Gemini 3.7 Flash und Grok 4.5. Mit BYOK legen Sie das Modell selbst in der Konfiguration fest (die models-Liste in VS Code, COPILOT_MODEL in der CLI). Die Release Notes von Copilot CLI sagen außerdem, dass eine ungültige Konfiguration eine klare Fehlermeldung liefert und die CLI nie stillschweigend auf GitHub-Modelle zurückfällt.

Wie BYOK in die einzelnen Copilot-Oberflächen kam

2026-04-07

Copilot CLI erhält BYOK und lokale Modelle: Ein paar Umgebungsvariablen vor dem Start genügen für Azure OpenAI, Anthropic oder jeden OpenAI-kompatiblen Endpunkt; mit eigenem Anbieter ist keine GitHub-Anmeldung nötig.

2026-05-28

VS Code 1.122 erscheint: Der Custom-Endpoint-Provider kommt in Stable an, mit Chat Completions, Responses und Messages, und BYOK funktioniert ab dieser Version ohne GitHub-Anmeldung.

2026-07-14

GitHub Copilot für JetBrains erweitert BYOK um OpenAI-kompatible benutzerdefinierte Endpunkte. Die Ankündigung nennt nur OpenAI-Kompatibilität, Claude über QCode geht auf diesem Weg also nicht.

Bestätigt und nicht geprüft

Bestätigt (wörtlich auf offiziellen Seiten)

Folgendes lässt sich wörtlich in der GitHub-Dokumentation, im GitHub-Changelog, in der VS-Code-Dokumentation oder in der QCode-Dokumentation nachlesen: Der Custom Endpoint in VS Code unterstützt Chat Completions, Responses und Anthropic Messages, vendor ist customendpoint; Copilot CLI kennt genau drei Provider-Typen, openai, azure und anthropic, wobei openai einen zu OpenAI Chat Completions kompatiblen Endpunkt meint; Modelle für die CLI müssen Tool Calling und Streaming beherrschen, empfohlen sind mindestens 128k Kontext; BYOK-Modelle in VS Code brauchen keinen Copilot-Tarif, Inline-Vorschläge und semantische Suche aber ein GitHub-Konto; JetBrains unterstützt seit 2026-07-14 OpenAI-kompatible benutzerdefinierte Endpunkte; BYOK in der GitHub Copilot app unterstützt Anthropic und jeden OpenAI-kompatiblen HTTP-Endpunkt und verlangt eine GitHub-Anmeldung, aber keinen Copilot-Tarif; Enterprise-BYOK ist eine öffentliche Vorschau. Auf QCode-Seite gilt: Claude-Modelle funktionieren nur am Endpunkt mit Anthropic-Protokoll.

Nicht geprüft oder nicht veröffentlicht

Zu drei Punkten zieht diese Seite kein Fazit. Erstens: Ob JetBrains eine eigene URL über das Anthropic-Protokoll ansprechen kann, steht auf keiner offiziellen Seite, und auch die QCode-Dokumentation nennt es unbestätigt; eine Claude-Einrichtung für JetBrains gibt es hier deshalb nicht. Zweitens: Die GitHub Copilot app und Enterprise-BYOK nennen offiziell beide Anthropic und OpenAI-kompatible Endpunkte, die QCode-Dokumentation beschreibt aber für keine der beiden eine Einrichtung, daher stehen hier keine konkreten Feldwerte. Drittens: Die QCode-Dokumentation wurde mit VS Code 1.138.0 und Copilot CLI v1.0.86 geprüft; bei neueren Versionen gelten die Bezeichnungen und Feldnamen in Ihrem Client.

VS Code oder Copilot CLI?

VS Code Chat (Custom Endpoint)

Ideal für Chat und Agents im Editor. Eine chatLanguageModels.json kann eine Claude-Gruppe (messages) neben einer Gruppe für GPT und chinesische Modelle (chat-completions) enthalten, beide erscheinen in der Modellauswahl; für Agents muss toolCalling auf true stehen. BYOK übernimmt nur den Chat, Inline-Vorschläge laufen weiter über GitHub.

Copilot CLI (BYOK-Umgebungsvariablen)

Ideal für Agent-Workflows im Terminal. Vier Umgebungsvariablen legen ein Modell fest, aktiv ist immer nur ein Satz; die eingebauten Sub-Agents (explore, task, code-review) übernehmen dieselbe Konfiguration. Mit eigenem Anbieter ist die GitHub-Anmeldung optional, und eine fehlerhafte Einstellung führt zu einer Fehlermeldung statt zu einem stillen Wechsel auf GitHub-Modelle.

Einrichtung Schritt für Schritt

Schritt 1, VS Code 1.122 oder neuer: Führen Sie in der Befehlspalette Chat: Manage Language Models aus, wählen Sie Add Models und dann Custom Endpoint; VS Code öffnet chatLanguageModels.json. Schritt 2, eine Claude-Gruppe: vendor customendpoint, apiKey der in der QCode-Konsole erstellte cr_-Key, apiType messages, url die volle Adresse https://api.qcode.cc/api/v1/messages, toolCalling true, und unter models IDs wie claude-sonnet-5; den name wählen Sie frei, das Beispiel in der Dokumentation nutzt QCode Claude. Schritt 3, eine eigene Gruppe für GPT und chinesische Modelle: apiType chat-completions mit url https://api.qcode.cc/openai/v1/chat/completions; GPT kann auch responses mit url https://api.qcode.cc/openai/v1/responses nutzen (dieser Endpunkt bedient nur GPT-Modelle). Schritt 4, Copilot CLI mit Claude: Setzen Sie COPILOT_PROVIDER_TYPE=anthropic, COPILOT_PROVIDER_BASE_URL=https://api.qcode.cc/api, COPILOT_PROVIDER_API_KEY auf Ihren cr_-Key und COPILOT_MODEL auf die Modell-ID, dann starten Sie copilot. Schritt 5, CLI mit GPT oder chinesischen Modellen: Typ openai und BASE_URL https://api.qcode.cc/openai/v1 (nur bis /v1, ohne /chat/completions); nutzen Sie nur einen der beiden Sätze, der zuletzt gesetzte überschreibt den früheren. Schritt 6, Test: Senden Sie eine Nachricht an das eigene Modell; 401 heißt Key prüfen, 404 heißt URL-Form prüfen.

Mit QCode

Bei QCode funktioniert ein cr_-Key aus der Konsole für alle Protokolle, der Anfragepfad bestimmt das Protokoll: claude-sonnet-5, claude-sonnet-5-5 und claude-opus-5-5 nutzen den Anthropic-Endpunkt https://api.qcode.cc/api; gpt-6.1-sol, glm-5.3 und deepseek-v4.1-flash den OpenAI-kompatiblen Endpunkt https://api.qcode.cc/openai/v1. Ein Claude-Modell am OpenAI-kompatiblen Endpunkt wird abgelehnt (model_not_available_on_endpoint), daher erreicht eine Copilot-Oberfläche, die nur das OpenAI-kompatible Protokoll spricht, Claude nicht; nutzen Sie messages in VS Code, den Typ anthropic in der CLI oder direkt Claude Code. Claude Opus 4.7, in Copilot am 2026-10-02 abgekündigt, und GPT-5.5, das am 2026-10-19 wegfallen soll, sind bei QCode als claude-opus-4-7 und gpt-5.5 weiterhin aufrufbar; die aktuelle Liste steht unter /models. Abgerechnet wird pro Token, die Preise je Modell stehen unter /models, getrennt von einem Copilot-Abo; jede Anfrage lässt sich per Key auf probe.qcode.cc nachsehen.

Häufige Fragen

Kann GitHub Copilot meinen eigenen Claude-API-Key nutzen?

Ja, wenn Sie die richtige Stelle wählen. Stand 2026-10-07 unterstützt der Custom Endpoint in VS Code Chat die Anthropic Messages API, und Copilot CLI hat den Provider-Typ anthropic; beide nehmen also eine eigene URL für Claude an. Der benutzerdefinierte Endpunkt in JetBrains ist offiziell nur als OpenAI-kompatibel beschrieben, und ob dort ein Anthropic-Typ funktioniert, ist auf den offiziellen Seiten nicht bestätigt; da Claude-Modelle bei QCode nur am Endpunkt mit Anthropic-Protokoll funktionieren, deckt die bestätigte Einrichtung dort nur GPT und chinesische Modelle ab.

Brauche ich für BYOK trotzdem einen Copilot-Tarif?

Nicht immer: Für VS Code und die GitHub Copilot app ist offiziell kein Tarif nötig, JetBrains, Xcode und Enterprise-BYOK setzen eine Copilot-Lizenz voraus. Laut VS-Code-Dokumentation funktionieren BYOK-Modelle ohne GitHub-Anmeldung und ohne Copilot-Tarif; in Copilot CLI ist die GitHub-Anmeldung mit eigenem Anbieter optional; die GitHub Copilot app verlangt eine GitHub-Anmeldung, mit eigenem Anbieter aber keinen Copilot-Tarif. Die Ankündigung zu BYOK in JetBrains und Xcode vom 2025-09-11 nennt eine gültige Copilot-Lizenz als Voraussetzung. Enterprise-BYOK richtet sich an Copilot Business und Enterprise, die Nutzer brauchen eine Copilot-Lizenz und Internetzugang.

Nutzen Inline-Vorschläge mit BYOK auch mein Modell?

Nein. Laut VS-Code-Dokumentation brauchen semantische Suche, Inline-Vorschläge (Code-Vervollständigung) und Funktionen auf Basis von Embeddings weiterhin ein GitHub-Konto, BYOK gilt nur für den Chat und Hilfsaufgaben; auch die Release Notes zu 1.122 sagen, dass Inline-Vorschläge und next edit suggestions eine GitHub-Anmeldung brauchen.

Gehört in VS Code die Root-URL oder der volle Pfad in url?

Der volle Pfad. VS Code empfiehlt die vollständige Endpunkt-URL samt API-Pfad, sonst fügt es selbst /v1 und den Pfad an. Die QCode-Dokumentation nennt https://api.qcode.cc/api/v1/messages, https://api.qcode.cc/openai/v1/chat/completions und https://api.qcode.cc/openai/v1/responses. Bei Copilot CLI ist es umgekehrt: COPILOT_PROVIDER_BASE_URL enthält nur https://api.qcode.cc/api oder https://api.qcode.cc/openai/v1. Ein 404 bedeutet meist, dass diese beiden Formen vertauscht sind.

Im Firmenkonto erscheinen keine eigenen Modelle. Was tun?

Lassen Sie zuerst die Richtlinie vom Admin prüfen. Laut VS-Code-Dokumentation können Admins von Copilot-Business- oder Enterprise-Nutzern Bring Your Own Language Model Key in VS Code in den Copilot-Richtlinien auf GitHub.com abschalten, und laut GitHub-Dokumentation lässt sich lokales BYOK in IDEs per Enterprise- oder Organisationsrichtlinie sperren. Außerdem erscheint ein Modell für Agents nur, wenn es Tool Calling unterstützt (toolCalling auf true).

Kann ich das mit einem QCode-Key einrichten?

Ja. Erstellen Sie in der Konsole einen cr_-Key. In VS Code nutzen Sie messages mit url https://api.qcode.cc/api/v1/messages für claude-sonnet-5, claude-sonnet-5-5 oder claude-opus-5-5 und chat-completions mit url https://api.qcode.cc/openai/v1/chat/completions für gpt-6.1-sol, glm-5.3 und weitere. In Copilot CLI nutzen Sie den Typ anthropic mit https://api.qcode.cc/api. Abgerechnet wird pro Token; Preise und aktuelle Modellliste stehen unter /models.

Quellen

BYOK in Copilot CLI: das GitHub-Dokument Adding LLM models to GitHub Copilot CLI sowie GitHub-Changelog-Einträge vom 2026-04-07 (Copilot CLI now supports BYOK and local models) und 2026-06-17 (Enterprise-BYOK-Modelle in der CLI). VS Code: das Dokument AI language models in VS Code (BYOK und Custom-Endpoint-Referenz) und die Release Notes zu VS Code 1.122. Die zwei BYOK-Arten und unterstützte Clients: die GitHub-Dokumente Bring your own key for GitHub Copilot, Enabling custom models for GitHub Copilot in your enterprise und Adding LLM models to the GitHub Copilot app sowie Changelog-Einträge vom 2026-06-23 (Copilot app), 2026-07-14 und 2025-09-11 (JetBrains). Modell-Abkündigungen: GitHub-Changelog-Einträge vom 2026-08-31, 2026-09-18 und 2026-10-02. Einrichtung bei QCode: die QCode-Dokumentationsseite zu GitHub Copilot (aktualisiert 2026-09-18) und die Seite zu Endpunkten und API-Pfaden. Alles abgerufen am 2026-10-07.

Ein Key für Copilot

VS Code und Copilot CLI nehmen beide die QCode-Endpunkte an: Claude über das Anthropic-Protokoll, GPT und chinesische Modelle über den OpenAI-kompatiblen Endpunkt, abgerechnet pro Token.

Weiterlesen

Schritte und Zitate auf dieser Seite wurden am 2026-10-07 mit der offiziellen Dokumentation von GitHub und VS Code sowie der QCode-Dokumentation abgeglichen; Änderungen bei vorgelagerten Diensten erfolgen ohne Ankündigung. Bezeichnungen und Feldnamen im Client ändern sich je nach Version, maßgeblich ist Ihre; die Verfügbarkeit von Modellen richtet sich nach /models.

Erst testen, dann entscheiden

Unsicher bei der Tarifwahl? Beginnen Sie mit Starter ($8.57/Monat) und wechseln Sie auf einen höheren Tarif, wenn Sie zufrieden sind — der ungenutzte Wert des alten Tarifs geht auf Ihr Guthaben zurück.