Coding Agents einrichten

Kilo Code einrichten: API Key, Base URL und Modelle

Installiere Kilo Code, konfiguriere die BetterToken Base URL und API Key, wähle ein verfügbares Modell und behebe häufige Fehler. Mit Beispielen.

Um Kilo Code 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.

Die Einrichtung besteht aus drei Schritten: Füge unter Providers in den Kilo-Code-Einstellungen einen Custom provider hinzu, wähle OpenAI Compatible, trage BetterToken API Key und Base URL ein und wähle eine aktuelle Model ID. Sende danach eine kurze erste Anfrage, um die Verbindung zu prüfen.

Wichtige Einstellungen

Feld	Wert
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
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

VS Code installiert

Installation

Wenn Kilo Code bereits installiert ist, gehe direkt zur manuellen Einrichtung, um deinen BetterToken API Key, die Base URL und die Model ID einzutragen.

Wenn du die Erweiterung noch installieren musst oder Hintergrund zur Installation und regionalen Nutzung suchst, lies den englischen Leitfaden zur Kilo-Code-Installation und benutzerdefinierten API und kehre anschließend für die aktuellen Konfigurationsfelder auf diese Seite zurück.

Manuelle Einrichtung

Führe diese Einrichtung in der Kilo-Code-Einstellungsoberfläche durch. Du musst keine Konfigurationsdatei bearbeiten.

Feld	Wert
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Eine aktuelle Model ID aus der model plaza

Einrichtung

Konfliktierende Umgebungsvariablen löschen

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Kilo-Code-Einstellungen öffnen

Öffne Settings (Zahnradsymbol), wähle Providers und klicke unten in der Liste auf Custom provider.

API Provider konfigurieren

Gib Folgendes ein:

Provider ID → bettertoken
Display name → BetterToken
Provider API → OpenAI Compatible
Base URL → https://bettertoken.ai/v1
API Key → dein BetterToken API Key
Models → füge manuell eine Model ID aus der model plaza hinzu und verwende dieselbe ID als Anzeigenamen

Klicke auf Submit, um den Provider zu speichern. Dies sind die Felder der VS-Code-Erweiterung aus der offiziellen Anleitung für Custom Models.

Zusätzliche Header nur bei ausdrücklicher Anforderung der offiziellen Dokumentation konfigurieren

Die geprüften offiziellen Kilo-Code-Unterlagen erwähnen optionale eigene Header für OpenAI-kompatible Provider, behandeln User-Agent jedoch nicht als erforderlichen BetterToken-Einrichtungsschritt.

Wenn du zusätzlich ein eigenes Gateway, Tenant-Routing, Observability oder eine Caching-Schicht verwendest, füge Header nur gemäß der offiziellen Dokumentation dieses Upstream-Dienstes hinzu.

Kilo Code neu starten

Starte nach der Konfigurationsänderung VS Code neu oder lade die Kilo-Code-Extension erneut, damit die neuen Einstellungen wirksam werden.

Verbindung überprüfen

Sende eine kurze erste Anfrage wie Antworte nur mit: OK. Antwortet das Tool ohne Authentifizierungs- oder Model-ID-Fehler, funktioniert die Verbindung. Starte das Tool nach einer Konfigurationsänderung vollständig neu. Prüfe bei Problemen die häufigen Fehler.

Kilo CLI

Installiere das offizielle Kilo CLI getrennt von der Erweiterung. Im macOS-Test mit einem GPT-Modell verarbeitete Kilo CLI 7.8.17 Textanfragen und Datei-Leseaufrufe über /v1/chat/completions.

Lege deinen BetterToken API Key im Terminal fest:

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Erstelle kilo.json in deinem Projekt. Ersetze jedes YOUR_MODEL_ID durch die exakte ID aus der model plaza:

{
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {
        "baseURL": "https://bettertoken.ai/v1",
        "apiKey": "{env:BETTERTOKEN_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": { "name": "YOUR_MODEL_ID" }
      }
    }
  },
  "model": "bettertoken/YOUR_MODEL_ID",
  "permission": { "read": "allow", "edit": "deny", "bash": "deny" },
  "agent": { "build": { "steps": 4 } }
}

Setze KILO_CONFIG auf den Pfad dieser Datei und führe einen nicht-interaktiven Texttest aus:

export KILO_CONFIG="$PWD/kilo.json"
kilo run --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

Prüfe, ob die finale Antwort OK enthält. Diese Konfiguration erlaubt das Lesen von Dateien und sperrt Änderungen und Shell-Befehle. Über KILO_CONFIG wird die Datei zu einer vertrauenswürdigen Quelle, in der {env:...}-Verweise aufgelöst werden. Eine nur aus dem Repository geladene Projektkonfiguration löst Umgebungsvariablen nicht auf. Verwende daher weiterhin die explizite Auswahl über KILO_CONFIG oben.

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

Fehler	Prüfen
`401` oder `Unauthorized`	Prüfe den BetterToken API Key und entferne führende oder nachgestellte Leerzeichen.
`404`	Prüfe die Base URL und hänge keinen spezifischen Endpunktpfad an.
`model not found`	Kopiere eine aktuelle Model ID aus der model plaza.
Änderungen werden nicht angewendet	Speichere die Konfiguration und starte das Tool vollständig neu.

Technische Details

Protokoll, Endpunkt und interne Provider-Felder

Diese Einrichtung verwendet https://bettertoken.ai/v1. Das Tool hängt den OpenAI-kompatiblen Endpunktpfad an. Füge /chat/completions oder /responses nicht hinzu, sofern ein bestimmtes Feld dies nicht ausdrücklich verlangt.