Coding Agents einrichten

GitHub Copilot einrichten: API Key, Base URL und Modelle

Installiere GitHub Copilot, konfiguriere die BetterToken Base URL und API Key, wähle ein verfügbares Modell und behebe typische Einrichtungsfehler.

Um GitHub Copilot mit BetterToken zu verbinden, bereite einen API Key vor, trage die unten angezeigte Base URL ein und wähle eine aktuelle Model ID aus der model plaza.

Wichtige Einstellungen

Feld	Wert
API Key	BetterToken API Key
Vollständige Request-URL	`https://bettertoken.ai/v1/chat/completions`
Model	Eine aktuelle Model ID aus der model plaza

Voraussetzungen

Die aktuelle Version des Tools ist installiert
Ein BetterToken API Key: Registriere dich und erhalte einen
Eine Model ID aus der model plaza

Registrieren und BetterToken API Key erhalten

Du hast bereits ein Konto? Melde dich an, lade Guthaben auf und erstelle dann einen Schlüssel in der Konsole.

Zusätzliche Anforderungen

Neueste Version von VS Code installiert
GitHub Copilot / Copilot Chat installiert und angemeldet
Kopieren Sie die genaue Model ID aus der model plaza.
Eine Model ID ist verfügbar, zum Beispiel YOUR_MODEL_ID

Installation

Installiere oder öffne GitHub Copilot und fahre dann mit der manuellen Einrichtung unten fort.

Manuelle Einrichtung

Feld	Wert
API Key	BetterToken API Key
Vollständige Request-URL	`https://bettertoken.ai/v1/chat/completions`
Model	Eine aktuelle Model ID aus der model plaza

Einrichtungsschritte

Modellverwaltung öffnen

Klicke im Eingabebereich von Copilot Chat auf die Modellauswahl und wähle Manage Language Models (Zahnradsymbol). Alternativ kannst du in der Befehlspalette Chat: Manage Language Models ausführen.

Manage Models über die Modellauswahl von Copilot Chat öffnen.

Custom Endpoint hinzufügen

Klicke in Language Models auf Add Models und wähle dann Custom Endpoint.

In Language Models auf Add Models klicken und Custom Endpoint auswählen.

Gruppennamen eingeben

Gib in Group Name Folgendes ein:

BetterToken

Drücke anschließend Enter.

BetterToken in das Eingabefeld Group Name eingeben.

API Key eingeben

VS Code fordert den API Key an. Füge deinen BetterToken API Key ein und drücke Enter.

Dieser Wert wird nicht direkt in der Konfigurationsdatei angezeigt. VS Code speichert ihn als lokales Secret und erzeugt eine Referenz wie diese:

"apiKey": "${input:chat.lm.secret.xxxxx}"

API-Typ auswählen

Wähle in Custom Endpoint: API Type Chat Completions aus.

Chat Completions in Custom Endpoint API Type auswählen.

JSON-Konfiguration bearbeiten

VS Code öffnet chatLanguageModels.json. Bestätige oder aktualisiere die Konfiguration:

Ersetze vor dem Speichern die Beispielwerte für Token-Limits durch die bestätigten Limits des gewählten Modells. Ihre Summe darf das Kontextfenster nicht überschreiten. Im Beispiel sind Tool-Aufrufe und Bildeingaben deaktiviert. Aktiviere sie nur, wenn Modell und Endpunkt die jeweilige Funktion unterstützen. Der Agent-Modus erfordert Tool-Aufrufe. Siehe die offizielle Feldreferenz.

BetterToken-Modell-URL, toolCalling, vision und Token-Limits in chatLanguageModels.json konfigurieren.

[
  {
    "name": "BetterToken",
    "vendor": "customendpoint",
    "apiKey": "${input:chat.lm.secret.xxxxx}",
    "apiType": "chat-completions",
    "models": [
      {
        "id": "YOUR_MODEL_ID",
        "name": "YOUR_MODEL_ID",
        "url": "https://bettertoken.ai/v1/chat/completions",
        "toolCalling": false,
        "vision": false,
        "maxInputTokens": 1000000,
        "maxOutputTokens": 64000
      }
    ]
  }
]

Prüfe diese Felder:

Feld	Einzustellender Wert
`name`	`BetterToken`
`apiType`	`chat-completions`
`id`	`YOUR_MODEL_ID` oder eine andere Model ID aus der model plaza
`name`	Gleich der Model ID
`url`	`https://bettertoken.ai/v1/chat/completions`
`toolCalling`	Nur bei bestätigter Tool-Unterstützung auf `true` setzen; für den Agent-Modus erforderlich
`vision`	Nur bei bestätigter Unterstützung für Bildeingaben auf `true` setzen
`maxInputTokens`	Beispiel durch das bestätigte Eingabelimit ersetzen
`maxOutputTokens`	Beispiel durch das bestätigte Ausgabelimit ersetzen; Eingabe + Ausgabe müssen innerhalb des Kontextfensters bleiben

VS Code speichern und neu laden

Speichere chatLanguageModels.json und führe dann Folgendes aus:

Developer: Reload Window

Kehre nach dem Neuladen zur Modellauswahl von Copilot Chat zurück und wähle YOUR_MODEL_ID.

Testnachricht senden

Sende eine einfache Nachricht in Copilot Chat:

Describe the model you are using in one sentence.

Wenn Copilot Chat normal antwortet, ist der BetterToken Custom Endpoint erfolgreich konfiguriert.

Verbindung überprüfen

Sende eine kurze Testanweisung. Wenn das Tool ohne Authentifizierungs- oder Model-ID-Fehler antwortet, funktioniert die Verbindung. Starte das Tool nach einer Konfigurationsänderung vollständig neu.

Modelle wechseln

Öffne die Modellauswahl oder ändere das Feld Model in der Konfiguration. Verwende die genaue Model ID aus der model plaza und starte dann die aktuelle Sitzung neu.

Häufige Fehler

Warum soll ich den API Key in der Abfrage eingeben?

VS Code speichert den API Key im lokalen Secret-Speicher und referenziert ihn in JSON mit ${input:chat.lm.secret...}. Das ist sicherer als den echten API Key in die JSON-Datei zu schreiben.

Warum Chat Completions verwenden?

Die verifizierte funktionierende Konfiguration verwendet Chat Completions. Die URL lautet:

https://bettertoken.ai/v1/chat/completions

Für dieses Chat-Completions-Beispiel müssen apiType und die vollständige URL wie gezeigt bleiben. Verwende nicht nur /v1.

Ersetzt dies die GitHub-Copilot-Inline-Vervollständigung?

Nein. Dieser Custom Endpoint wird hauptsächlich für Sprachmodellaufrufe von Copilot Chat verwendet. Die GitHub-Copilot-Inline-Vervollständigung wird weiterhin von GitHub Copilot selbst bereitgestellt.

Was soll ich bei Invalid token tun?

Prüfe diese Punkte der Reihe nach:

Der API Key wurde in der VS-Code-Abfrage eingegeben
JSON behält die Referenz ${input:chat.lm.secret...} bei
Kopieren Sie die genaue Model ID aus der model plaza.
url ist https://bettertoken.ai/v1/chat/completions
apiType ist chat-completions
Die Model ID ist ein Modell aus der model plaza

Technische Details

Protokoll, Endpunkt und interne Provider-Felder

In diesem Chat-Completions-Beispiel erfordert das Feld url des Modells die vollständige Adresse https://bettertoken.ai/v1/chat/completions. VS Code hängt für dieses Feld nicht /chat/completions an.