Dokumentation

GitHub Copilot CLI

Der BYOK-Weg von Copilot CLI umfasst vier Umgebungsvariablen und erfordert laut GitHubs eigener Dokumentation keinerlei GitHub-Anmeldung. Richten Sie ihn auf Kunavo aus, läuft der Agent über ein vorausbezahltes Guthaben statt über AI Credits — /delegate, der GitHub-MCP-Server und GitHub Code Search bleiben an die Anmeldung gebunden.

Vier Umgebungsvariablen — COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_TYPE, COPILOT_PROVIDER_API_KEY und COPILOT_MODEL — stellen Copilot CLI auf deinen eigenen Endpunkt um; GitHub dokumentiert, dass BYOK keine GitHub-Anmeldung benötigt.

die Shell, aus der Sie Copilot starten

# 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

GitHub gibt nicht an, welchen Pfad Copilot CLI anhängt. Das obige /v1 ist daher ein durchgespieltes Beispiel und keine Regel. Auf der BYOK-Seite wird das Feld lediglich als „Die Basis-URL des API-Endpoints Ihres Modellanbieters“ definiert. Auch die dortigen Beispiele lassen beide Möglichkeiten offen: Der entfernte OpenAI-kompatible Endpoint lautet https://api.openai.com/v1, während Ollama- und Anthropic-Endpoints nur den Basis-Host enthalten. Auf dieser Seite wird die Form für einen entfernten OpenAI-kompatiblen Endpoint verwendet, da sie auf Kunavo zutrifft. Wenn Anfragen mit 404 zurückkommen, wird das Suffix doppelt angehängt — entfernen Sie es und verwenden Sie https://api.kunavo.com. Ein 401 bezeichnet den Schlüssel, nicht die URL. Anhand des folgenden curl lassen sich die beiden unterscheiden, bevor Sie die Fehlersuche in der CLI beginnen.

Eine zurückgebliebene ~/.copilot/providers.json setzt sich unbemerkt über diese Exporte hinweg. Laut GitHubs Referenz zum Konfigurationsverzeichnis haben darin angegebene Provider oder Modelle Vorrang vor den Variablen COPILOT_PROVIDER_*, die dort als veraltet bezeichnet werden. Auch in GitHubs BYOK-Anleitung wird die Datei nicht erwähnt. Wenn die CLI die gerade exportierte Basis-URL ignoriert, sollten Sie zuerst dort nachsehen. Dieselbe Referenz beschreibt die Datei lediglich als JSON-Objekt mit den Schlüsseln providers und models und veröffentlicht kein Schema. Deshalb ist hier kein Beispiel dafür aufgeführt; GitHub verweist für weitere Informationen auf copilot help providers.

Diese Konfiguration wurde am unten angegebenen Datum aus GitHubs eigener Dokumentation übernommen. Kunavo hat Copilot CLI nicht mit seinem Endpoint ausgeführt — weder eine Sitzung noch einen gestreamten Durchlauf oder einen Tool-Roundtrip. Dasselbe gilt für alle anderen Clients dieser Familie. Eine veröffentlichte Einrichtungsseite ist kein Testergebnis. GitHub verlangt, dass ein BYOK-Modell Tool-Aufrufe und Streaming unterstützt, andernfalls wird ein Fehler zurückgegeben. Die erste Aufgabe, die Sie ihm geben, sollte daher eine Datei betreffen und nicht nur „Hallo“ sagen.

Kunavo bietet keine Modelle für Embeddings, Text-zu-Sprache oder Sprache-zu-Text an. Dieser Endpoint beantwortet daher ausschließlich Chat-Anfragen. GitHub Code Search, der GitHub-MCP-Server und /delegate sind GitHub-Funktionen, die ein BYOK-Provider nicht ersetzt. GitHub dokumentiert, dass sie ohne Anmeldung nicht verfügbar sind; wenn Sie sich anmelden und zusätzlich einen Provider konfigurieren, können Sie sie weiterhin verwenden.

Noch kein Schlüssel? Erstelle ein Kunavo-Konto, erstelle einen Schlüssel (er beginnt mit sk-kn-) und füge ab $10 Guthaben hinzu – Aufrufe werden aus diesem Guthaben bezahlt, fehlgeschlagene Aufrufe werden nicht berechnet. Das Dashboard öffnet anschließend die GitHub Copilot CLI-Einrichtung.

Schritt für Schritt

Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
Prüfen Sie, ob eine veraltete ~/.copilot/providers.json (oder der Pfad, auf den COPILOT_PROVIDERS_CONFIG verweist) vorhanden ist. Wenn darin ein Provider oder Modell angegeben ist, hat sie Vorrang vor allem aus Schritt 3.
Exportieren Sie COPILOT_PROVIDER_BASE_URL, COPILOT_PROVIDER_API_KEY und COPILOT_MODEL wie oben beschrieben. Der Standardwert für COPILOT_PROVIDER_TYPE ist openai. Laut GitHub umfasst dieser Wert „jeden anderen OpenAI-Chat-Completions-API-kompatiblen Endpoint“.
Starten Sie copilot in derselben Shell — diese Werte werden beim Start ausgelesen. Ein bereits zuvor geöffnetes Terminal enthält noch die alten Werte.
Geben Sie dem Agenten eine Aufgabe, bei der er eine Datei liest und bearbeitet. Copilot CLI benötigt ein Modell, das Tool-Aufrufe und Streaming unterstützt. Ein erster Durchlauf, der beides nutzt, verrät mehr als eine Begrüßung. Mit --model können Sie COPILOT_MODEL für einen einzelnen Durchlauf überschreiben, wenn Sie zwei IDs vergleichen möchten.

Abgeglichen mit GitHubs „Eigene LLM-Modelle in GitHub Copilot CLI verwenden“ am 21. September 2026. Einstellungen von Drittanbietern können sich ändern; wenn ein Feldname hier nicht mehr mit deiner Ansicht übereinstimmt, ist diese Seite maßgeblich, nicht diese hier.

Dies ist die Kurzfassung. Die vollständige Anleitung – Modellauswahl, Kosten einer tatsächlichen Sitzung und Fehlerszenarien – findest du in Copilot CLI und Claude Code — die BYOK-Grenze und die zwei Rechnungen.

Vor dem Debugging des Clients prüfen

Eine Anfrage klärt, ob der Fehler am Endpunkt, am Schlüssel oder an der Konfigurationsdatei liegt. Wenn diese Anfrage JSON zurückgibt, funktionieren dieselbe Basis-URL und derselbe Schlüssel in 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-..."

Welche Modell-ID in das Feld gehört

Jedes Textmodell ist über eine Modell-ID erreichbar – die aktuelle Liste findest du unter GET /v1/models, den Katalog mit Preisen auf der Modellseite. Die Tarife sind USD pro 1 Mio. Token, Eingabe / Ausgabe.

Modell-ID	Kunavo: Ein- und Ausgabe	Wo es in GitHub Copilot CLI hineinpasst
`claude-sonnet-5`	$1.40 / $7.00	das Standardmodell für Sitzungen, in denen Dateien bearbeitet werden
`claude-opus-5`	$3.50 / $17.50	Planung einer Änderung, bei der ein Fehler teuer wäre
`claude-haiku-4-5`	$0.70 / $3.50	günstige Durchläufe — Triage, Zusammenfassungen und die Schleife, die den ganzen Tag läuft
`gpt-5-6-sol`	$2.00 / $12.00	eine zweite Modellfamilie mit demselben Schlüssel und derselben Basis-URL

Die Abrechnung erfolgt pro Token aus einem vorausbezahlten Guthaben ohne Monatsgebühr – siehe Abrechnung. Bei wiederholtem Kontext – dem Großteil dessen, was ein Editor oder Chat-Client sendet – verändert Prompt-Caching die Rechnung stärker als die Modellwahl.

Der andere Weg: `COPILOT_PROVIDER_TYPE=anthropic`

GitHub dokumentiert drei Providertypen. Kunavo unterstützt zwei der zugrunde liegenden Drahtformate: /v1/chat/completions für openai und /v1/messages für anthropic. Das Anthropic-Beispiel auf GitHubs Seite enthält vier Exporte; als Basis-URL dient der reine Ursprung https://api.anthropic.com:

COPILOT_PROVIDER_TYPE=anthropic
COPILOT_PROVIDER_BASE_URL — der Form des GitHub-Beispiels nach https://api.kunavo.com ohne Suffix, da Anthropic über diesen Ursprung seine eigene Route unter /v1/messages bereitstellt und Kunavo sie nachbildet. Es gilt derselbe Vorbehalt wie oben: GitHub zeigt ein Beispiel, keine Regel.
COPILOT_PROVIDER_API_KEY — Ihr sk-kn--Schlüssel. Kunavos Messages-Schnittstelle akzeptiert ihn sowohl als x-api-key als auch als Authorization: Bearer. Daher wird der CLI-Schlüssel unabhängig davon gelesen, welchen Header sie hier auswählt.
COPILOT_MODEL — die vom Provider erwartete ID. GitHubs Beispiel verwendet eine Schreibweise im Anthropic-Stil mit Bindestrichen, während die Liste der unterstützten Modelle von GitHub dieselben Familien mit Punkten aufführt. Bei BYOK wird die ID an Ihren Endpoint übergeben. Verwenden Sie daher die Schreibweise aus der obigen Tabelle.

Warum auf dieser Seite trotzdem der Typ openai an erster Stelle steht: GitHubs Dokumentation sagt nicht, ob der Anthropic-BYOK-Pfad cache_control, anthropic-beta oder ein bestimmtes anthropic-version weiterleitet. Bei wiederholtem Kontext wirkt sich das auf die Rechnung aus — siehe Prompt-Caching. Eine undokumentierte Antwort wollen wir auf dieser Seite nicht einfach voraussetzen. Beim Typ openai gibt es diese offene Frage nicht. Daher enthält nur dafür der Konfigurationsblock konkrete Werte.

Häufig gestellte Fragen

Wie richte ich GitHub Copilot CLI auf einen benutzerdefinierten API-Endpoint aus?

Legen Sie die Umgebungsvariablen fest, bevor Sie die CLI starten. Auf GitHubs BYOK-Seite sind zwei Variablen als erforderlich gekennzeichnet — COPILOT_PROVIDER_BASE_URL und COPILOT_MODEL. Für Endpoints mit Authentifizierung kommt COPILOT_PROVIDER_API_KEY hinzu. Der Standardwert für COPILOT_PROVIDER_TYPE ist openai. Laut GitHub umfasst dieser Typ OpenAI, Ollama, vLLM, Foundry Local und jeden anderen OpenAI-Chat-Completions-API-kompatiblen Endpoint; die übrigen Werte sind azure und anthropic. GitHub dokumentiert noch einen Haken: Wenn in ~/.copilot/providers.json ein Provider oder Modell angegeben ist, hat die Datei Vorrang vor allen diesen Variablen.

Muss die Basis-URL von Copilot CLI mit /v1 enden?

GitHubs Dokumentation klärt diese Frage nicht. Das Feld wird lediglich als „Die Basis-URL des API-Endpoints Ihres Modellanbieters“ definiert. Auch die Beispiele auf der Seite lassen beide Möglichkeiten offen: Das Beispiel für einen entfernten OpenAI-kompatiblen Endpoint lautet https://api.openai.com/v1, während Ollama- und Anthropic-Endpoints nur den Basis-Host enthalten. Beginnen Sie bei einem OpenAI-kompatiblen Endpoint mit der Form, die GitHub für diesen Fall zeigt — https://api.kunavo.com/v1. Wenn Anfragen mit 404 statt 401 fehlschlagen, wird das Suffix doppelt angehängt; entfernen Sie es. Ein 404 weist auf die URL hin, ein 401 auf den Schlüssel. Ein einfacher curl-Aufruf mit derselben Basis-URL unterscheidet die beiden Fälle, bevor Sie die Fehlersuche in der CLI beginnen.

Erfordert GitHub Copilot CLI BYOK ein GitHub-Konto?

Nein. Laut GitHubs Authentifizierungsdokumentation ist keine GitHub-Authentifizierung erforderlich, wenn Copilot CLI mit dem API-Schlüssel eines eigenen LLM-Providers konfiguriert ist. Die CLI verbindet sich dann direkt mit dem konfigurierten Provider. Drei Funktionen sind in diesem Fall nicht verfügbar: /delegate, der GitHub-MCP-Server und GitHub Code Search. Sie können sich auch anmelden und gleichzeitig einen Provider konfigurieren, um beides weiter zu nutzen. GitHub dokumentiert außerdem COPILOT_OFFLINE=true für Umgebungen, in denen die CLI überhaupt keine Verbindung zu GitHubs Servern aufnehmen soll. Das isoliert die Netzwerkverbindung allerdings nur, wenn der Provider lokal läuft, denn eine entfernte Basis-URL erhält weiterhin Ihre Prompts und den Codekontext.

Hat Kunavo GitHub Copilot CLI mit seinem Endpoint getestet?

Nein. Die Konfiguration auf dieser Seite stammt zum unten angegebenen Datum aus GitHubs eigener BYOK-Dokumentation. Nichts davon ist ein Laufzeitergebnis — weder eine Sitzung noch ein gestreamter Durchlauf oder ein Tool-Roundtrip. Dasselbe gilt für alle anderen hier dokumentierten Clients. GitHub verlangt, dass ein BYOK-Modell Tool-Aufrufe und Streaming unterstützt; andernfalls wird ein Fehler zurückgegeben. Der ehrliche erste Test liegt daher bei Ihnen: Führen Sie eine Aufgabe aus, bei der eine Datei gelesen und bearbeitet wird, und werten Sie die protokollierte Abrechnung und das Verhalten der CLI als Belege aus, nicht diese Seite.