Eine API für alleNutzungsanleitung
Website ↗
NutzungsanleitungWerkzeuge verbinden

Kimi Code

Kimi Code ist der Agent; das Modell bestimmt deine Anbieterkonfiguration. Diese Anleitung folgt der aktuellen CLI.

Diese drei Angaben bereithalten

Öffne bei bereits installierter App den Selbstbedienungsbereich dieser Website und melde dich an. Erstelle oder öffne deinen API-Schlüssel, kopiere die dort angezeigte API-Adresse und eine genaue Modell-ID aus Modelle und Preise. Verwende weder die Startseite noch dein Passwort oder einen Marketingnamen. Prüfe Kontoguthaben und Schlüssellimit.

API_HOST, YOUR_API_KEY und YOUR_MODEL_ID sind Platzhalter: Ersetze alle vor der Nutzung. Beachte die Angaben zu /v1; hänge weder /chat/completions noch /responses an. Die Beispiele verbinden sich nicht automatisch und enthalten keinen echten Schlüssel.

1. Version und Pfad prüfen

Führe kimi --version aus. Die aktuelle Datei ist ~/.kimi-code/config.toml oder %USERPROFILE%\.kimi-code\config.toml unter Windows. Ältere Versionen können ~/.kimi nutzen: Prüfe deren Dokumentation und ändere nicht beide Dateien.

2. Anbieter und Modell ergänzen

Füge das Beispiel passend ein. provider = "my_api" muss zu [providers.my_api] passen. my-model ist ein lokaler Alias, model die echte ID. Der Kontextwert 32768 ist ein Beispiel und muss zu bestätigten Modellgrenzen passen.

Feldschema · kein App-Screenshot
type
openai / openai_responses
base_url
https://API_HOST/v1
model
YOUR_MODEL_ID
api_key_env
MY_API_KEY
Konfigurationsbeispiel

Sichere zuerst die bestehende Datei. Ändere vorhandene Einträge ohne Duplikate und behalte andere Einstellungen bei. Teile keine Datei oder Aufnahme mit einem echten Schlüssel.

default_model = "my-model"

[providers.my_api]
type = "openai"
base_url = "https://API_HOST/v1"
api_key_env = "MY_API_KEY"

[models.my-model]
provider = "my_api"
model = "YOUR_MODEL_ID"
max_context_size = 32768

3. Schlüssel setzen und auswählen

api_key_env = "MY_API_KEY" liest ausdrücklich diese Variable. Setze sie, starte kimi und wähle my-model mit /model. /login meldet beim offiziellen Dienst an und richtet diese Plattform nicht ein.

Wenn die Konfiguration MY_API_KEY nutzt, setze die Variable im selben Terminal, aus dem du das Werkzeug startest. Trage deinen Schlüssel nur auf deinem Computer ein. Die Variable gilt bis zum Schließen dieses Terminals.

macOS-/Linux-Terminal
export MY_API_KEY="YOUR_API_KEY"
kimi
Windows PowerShell
$env:MY_API_KEY = "YOUR_API_KEY"
kimi

4. Format wählen

type = "openai" nutzt Chat Completions. Wechsle nur nach Bestätigung der Modellverbindung zu "openai_responses". Beide Beispiele behalten /v1.

5. Echte Denkstufen deklarieren

Bekannte Modelle erhalten meist automatisch Fähigkeiten. Ergänze bei einem unbekannten Alias capabilities = ["tool_use", "thinking"] unter [models.my-model] nur bei tatsächlicher Unterstützung. Trage support_efforts und default_effort passend ein: Bei low/high etwa support_efforts = ["low", "high"] und default_effort = "low". Eine Deklaration erzeugt keine Modellfähigkeit.

Wenn low für dieses Modell bestätigt ist, ergänze den separaten Abschnitt [thinking], um diese Stufe zu wählen. Ändere effort bei Bedarf auf einen anderen deklarierten Wert. Die globale Stufe hat Vorrang vor default_effort. Speichere, führe /reload in einer untätigen Sitzung aus und sende eine Testnachricht.

[thinking]
enabled = true
effort = "low"

Prüfung 1: eine Antwort erhalten

Erstelle einen leeren Testordner, wähle ihn als Arbeitsbereich und öffne einen neuen Chat. Prüfe den Anbieter und das Modell und sende die folgende Nachricht. Eine normale Antwort bestätigt die Grundverbindung, nicht alle Agentenfunktionen. Die Tests verursachen regulären API-Verbrauch.

Antworte nur: Verbindung erfolgreich.

Erwartet: „Verbindung erfolgreich“. Bei Anmeldeseite, Fehler oder endlosem Laden zuerst die Hinweise prüfen und nicht wiederholt senden.

Prüfung 2: eine echte Datei lesen

Erstelle im Testordner mit einem Texteditor hello.txt mit dem Inhalt „API connection test 27“. Speichere sie und sende den folgenden Auftrag. Erlaube bei einer Nachfrage nur das Lesen dieses Testordners.

Öffne hello.txt im aktuellen Arbeitsbereich mit dem Dateilesewerkzeug und nenne den Inhalt. Ändere keine Dateien.

Erwartet: ein sichtbarer Werkzeugaufruf zum Lesen von hello.txt und eine Antwort mit API connection test 27. Eine reine Textantwort belegt keinen Werkzeugaufruf. Danach kannst du den Testordner entfernen.

Nach dem Fehlerbild prüfen

401 / Invalid API key

Prüfe, ob Adresse und vollständiger Schlüssel zum selben Dienst gehören und der Schlüssel aktiv ist. Sende dem Support keinen vollständigen Schlüssel.

404 / model not found

Prüfe /v1, die genaue Modell-ID und das Format. Ein gelistetes Modell unterstützt nicht automatisch jedes Format.

429 / quota / balance

Prüfe Guthaben, Schlüssellimit und Anfragerate anhand der Fehlermeldung. Eine höhere Denkstufe löst kein Quotenproblem.

Chat funktioniert, Dateien nicht

Prüfe Modellwerkzeuge, Ordnerrechte und den Ausführungsfehler.

Keine Denkstufenauswahl

Prüfe deklarierte Fähigkeiten, Modell und Clientversion. Denkfähigkeit bedeutet nicht immer einstellbare Denkstufen.

Offizielle Quellen und Geltungsbereich

Konfiguration am 2026-11-08 abgeglichen. Menüs können sich ändern; nutze diese offiziellen Quellen. Maßgeblich sind die aktuellen Verbindungsangaben unserer Plattform.