Dokumentation

Kimi Code

Kimi Code verwaltet seine Anbieter in einer TOML-Datei. Für einen Drittanbieter-Endpunkt sind darin drei Schlüssel erforderlich: type, base_url, api_key. Verweisen Sie einen Eintrag auf Kunavo, und die CLI kommuniziert über das bereits unterstützte Protokoll mit Claude- und GPT-IDs.

Kimi Code verwaltet Anbieter in ~/.kimi-code/config.toml — providers.<name>.base_url auf https://api.kunavo.com/v1 setzen, type = "openai" verwenden, und die CLI führt Claude- und GPT-IDs mit einem Schlüssel aus.

~/.kimi-code/config.toml

default_model = "kunavo/claude-sonnet-5"

[providers.kunavo]
type = "openai"
base_url = "https://api.kunavo.com/v1"
api_key = "sk-kn-..."

[models."kunavo/claude-sonnet-5"]
provider = "kunavo"
model = "claude-sonnet-5"
max_context_size = 200000

base_url behält das Suffix /v1 bei. Die Anbieterseite klärt es eindeutig: Der dokumentierte Standardwert für type = "openai" ist https://api.openai.com/v1, und das durchgearbeitete Beispiel für einen Drittanbieter-Endpunkt auf der Umgebungsvariablen-Seite lautet KIMI_MODEL_BASE_URL="https://api.example.com/v1". Kimi Code hängt nur die Route an, daher führt ein bloßer Basis-Host hier zu einem 404 statt zu einem Authentifizierungsfehler. Bei Clients mit Anthropic-Protokoll ist es genau umgekehrt: Sie benötigen https://api.kunavo.com ohne Suffix.

Das Exportieren einer Shell-Variablen weist dem Anbieter keinen Schlüssel zu. Die Dokumentation zu den Konfigurationsdateien von Kimi Code stellt klar: Wenn Sie im Terminal export KIMI_API_KEY ausführen, erhält dadurch kein Anbieter seinen Schlüssel. Die dokumentierte Priorität lautet api_key oder api_key_env – setzen Sie genau eine der beiden Variablen, sie schließen sich gegenseitig aus. Falls keine davon vorhanden ist, wird der Schlüssel aus einer [providers.kunavo.env]-Untertabelle verwendet; fehlen alle, schlägt der Start mit einer Fehlermeldung fehl. Damit der Schlüssel nicht in der Datei steht, schreiben Sie stattdessen api_key_env = "KUNAVO_API_KEY" anstelle von api_key. Ist die Variable nicht gesetzt oder leer, schlägt die Anfrage mit einer Fehlermeldung fehl, die den Variablennamen nennt.

Kunavo hat diesen Client nicht mit dem eigenen Endpunkt getestet. Der obige Block stammt aus der aktuellen Dokumentation von Kimi Code, nicht aus einer Sitzung: Hier wurde keine Streaming- oder Tool-Aufruf-Ausführung mit Kimi Code aufgezeichnet. Betrachten Sie daher die erste echte Anfrage als Test, nicht als Bestätigung. Die veröffentlichte Seite beschreibt die Einrichtung, nicht deren Abnahme.

type bezeichnet das Protokoll, nicht den Anbieter. Die dokumentierte Auswahl umfasst kimi, anthropic, openai, openai_responses, google-genai und vertexai – in der aktuellen Tabelle gibt es keine veraltete OpenAI-Variante. Eine Anleitung, die Sie auffordert, diese festzulegen, ist daher älter als die aktuelle Tabelle. openai auszuwählen und dann eine Claude-Modell-ID einzugeben, ist die vorgesehene Kombination: Die ID wird an der Basis-URL aufgelöst, nicht in der CLI.

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 Kimi Code-Einrichtung.

Schritt für Schritt

Erstellen Sie unter /app/keys einen Schlüssel und kopieren Sie ihn — er wird nur einmal angezeigt.
Öffnen Sie ~/.kimi-code/config.toml, die Datei wird beim ersten Start angelegt. Wenn Sie das Datenverzeichnis mit KIMI_CODE_HOME verschoben haben, liegt die Datei unter $KIMI_CODE_HOME/config.toml; der Dateiname lautet immer config.toml.
Fügen Sie die obige Tabelle [providers.kunavo] hinzu. Die Dokumentation nennt für diesen Typ in dieser Reihenfolge drei Schlüssel: type, base_url und api_key.
Definieren Sie unter [models."..."] einen Modellalias mit provider, model und max_context_size – alle drei Felder sind erforderlich. Der Alias ist der Name, den Sie an -m und default_model übergeben; der Wert model ist die ID, die über die Leitung gesendet wird. Setzen Sie Aliase mit einem Punkt in Anführungszeichen.
Lassen Sie capabilities beim ersten Versuch weg. Laut Anbieterseite werden Fähigkeiten automatisch anhand des Modellnamenspräfixes zugeordnet. In der Modelltabelle steht außerdem, dass das Array nur erweitert, aber niemals verkleinert wird. Ein falsches Tag lässt sich daher später nicht durch Bearbeiten der Konfiguration zurücksetzen.
Führen Sie kimi aus oder verwenden Sie kimi -m kunavo/claude-sonnet-5, um den Alias für eine Sitzung auszuwählen. Wenn Sie den Endpunkt testen möchten, ohne die Konfiguration anzufassen, setzen Sie KIMI_MODEL_NAME, KIMI_MODEL_API_KEY, KIMI_MODEL_PROVIDER_TYPE=openai und KIMI_MODEL_BASE_URL – die CLI erzeugt im Arbeitsspeicher einen Anbieter und schreibt nichts zurück.

Abgeglichen mit Die Seite zu Anbietern und Modellen von Kimi Code 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 Kimi Code oder Claude Code – welcher Client, welches Modell, welches Konto.

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 Kimi Code.

# 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 Kimi Code hineinpasst
`claude-sonnet-5`	$1.40 / $7.00	der Standardalias – das Arbeitsmodell für Bearbeiten-und-Ausführen-Schleifen
`claude-opus-5`	$3.50 / $17.50	ein zweiter Alias für Planungsschritte, bei denen ein falscher Plan teuer wird
`claude-haiku-4-5`	$0.70 / $3.50	der günstige Alias, der unter [secondary_model] für Subagenten festgelegt wird
`gpt-5-6-sol`	$2.00 / $12.00	eine zweite Meinung aus einer anderen Modellfamilie mit demselben Schlüssel und derselben Anbietertabelle

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.

Häufig gestellte Fragen

Wie richte ich Kimi Code auf einen benutzerdefinierten API-Endpunkt aus?

Fügen Sie ~/.kimi-code/config.toml eine Anbietertabelle mit type = "openai", der Basis-URL Ihres Endpunkts und Ihrem Schlüssel unter api_key hinzu. Definieren Sie anschließend unter [models."<alias>"] einen Modellalias mit provider, model und max_context_size. Auf der Anbieterseite von Kimi Code steht, dass type = "openai" für das OpenAI-Chat-Completions-Protokoll und alle damit kompatiblen Drittanbieterdienste gedacht ist. Passen Sie bei Bedarf base_url an. Sie können den Anbietermanager in der TUI auch mit /provider öffnen. Dessen Pfad für bekannte Anbieter importiert jedoch aus dem Katalog models.dev, weshalb sich ein dort nicht gelisteter Endpunkt schneller manuell hinzufügen lässt.

Muss Kimi Codes base_url mit /v1 enden?

Ja, bei einem OpenAI-kompatiblen Endpunkt. Kimi Code hängt nur die Route an, daher muss base_url der /v1-Stammpfad sein, zum Beispiel https://api.kunavo.com/v1. Die Dokumentation klärt das eindeutig: Der Standardwert für base_url bei type = "openai" lautet https://api.openai.com/v1, und das Beispiel für einen Drittanbieter auf der Umgebungsvariablen-Seite lautet https://api.example.com/v1. Fehlt /v1, erhalten Sie einen 404 statt eines 401.

Warum meldet Kimi Code, dass mein API-Schlüssel fehlt, obwohl die Variable exportiert ist?

Weil Kimi Code Shell-Umgebungsvariablen für Zugangsdaten nicht ausliest, sofern Sie nicht angeben, welche Variable es verwenden soll. Laut Dokumentation zu den Konfigurationsdateien erhält kein Anbieter seinen Schlüssel, wenn Sie export KIMI_API_KEY ausführen. Tragen Sie entweder api_key direkt in config.toml ein oder setzen Sie api_key_env auf den Namen der Variablen – die beiden Angaben schließen sich gegenseitig aus, setzen Sie also genau eine davon. Eine [providers.<name>.env]-Untertabelle wird nur berücksichtigt, wenn keine davon vorhanden ist. Fehlen alle drei, schlägt der Start mit einer Fehlermeldung fehl.

Kann Kimi Code Claude-Modelle über einen Drittanbieter verwenden?

Der Anbietertyp bezeichnet ein Protokoll, keinen Anbieter, und der Wert model wird an die konfigurierte base_url weitergegeben. Eine Claude-ID in einem Anbieter vom Typ openai wird daher an diesem Endpunkt aufgelöst, nicht in der CLI. Kimi Code bietet außerdem einen separaten Anbieter mit type = "anthropic" für das Anthropic-Messages-Protokoll; dessen Basis-URL besteht nur aus Schema, Host und gegebenenfalls Port, ohne /v1-Suffix. Kunavo hat keine Kimi Code-Sitzung mit dem eigenen Endpunkt über eines der beiden Protokolle ausgeführt. Überprüfen Sie es daher mit dem obigen curl-Aufruf und betrachten Sie Ihre erste Sitzung als Test.