Kilo Code API-Schlüssel einrichten

Kilo Code API-Schlüssel: Eigenen Schlüssel in kilo.json festlegen

Fügen Sie den folgenden Block in kilo.json ein, setzen Sie Ihren eigenen API-Schlüssel ein, und Kilo Code kann Claude- und GPT-Modelle verwenden. Sie zahlen nur, was Sie nutzen.

~/.config/kilo/kilo.jsonjson
config
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "aicodewith/claude-haiku-4-5-20251001",
  "provider": {
    "aicodewith": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI Code With",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "sk-***"
      },
      "models": {
        "claude-haiku-4-5-20251001": {
          "name": "Claude Haiku 4.5"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  }
}

Einrichtungsschritte

Diesen Schlüssel für spätere Terminals speichern

Sobald Sie angemeldet sind, enthält dieser Befehl Ihren eigenen Schlüssel. Kopieren Sie ihn, führen Sie ihn einmal aus, und das Tool behält den Schlüssel an der von uns getesteten Stelle.

bash
mkdir -p "$(dirname "$HOME/.config/kilo/kilo.json")"
cat > "$HOME/.config/kilo/kilo.json" << 'EOF'
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "aicodewith/claude-haiku-4-5-20251001",
  "provider": {
    "aicodewith": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI Code With",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "sk-***"
      },
      "models": {
        "claude-haiku-4-5-20251001": {
          "name": "Claude Haiku 4.5"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  }
}
EOF

Nicht angemeldete Besucher sehen nur einen Platzhalter. Melden Sie sich an, dann tragen wir Ihren Schlüssel ein. Sign in · Einen Schlüssel in der Konsole abrufen

Durch das Kopieren wird der Befehl nur in die Zwischenablage gelegt. Sie müssen ihn weiterhin in einem Terminal ausführen oder den Schlüssel in die Tool-Einstellungen einfügen. So erhalten Sie einen API-Schlüssel

Diese Schritte wurden unter Linux (bash) getestet. macOS und Windows wurden noch nicht getestet, daher sind sie nicht aufgeführt.

  1. Noch kein Kilo Code? Installiere es (überspringen, falls installiert)

    Führe npm i -g @kilocode/cli aus, dann kilo --version. Eine Versionsnummer bedeutet, dass es installiert ist.

    Installiere die Kilo Code CLI mit npm i -g @kilocode/cli, dann gibt kilo --version 7.8.8 aus, um zu bestätigen, dass es funktioniert
  2. Füge die Konfiguration in kilo.json ein und füge deinen API-Schlüssel hinzu

    Öffne ~/.config/kilo/kilo.json, füge den Block von oben auf dieser Seite ein und ersetze sk-*** durch deinen API-Schlüssel (API-Schlüssel erhalten). Nach dem Speichern enthält die Datei eine Zeile "apiKey": "sk-…", und ein neues Terminal oder ein Neustart behält sie bei.

    Setze den Schlüssel direkt in provider.aicodewith.options.apiKey in ~/.config/kilo/kilo.json (hier als sk-*** maskiert)
  3. Öffne ein neues Terminal und teste Kilo Code

    Öffne ein neues Terminal und führe kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK" aus. OK bedeutet, dass Kilo Code deinen API-Schlüssel verwendet.

    Überprüfen: Schließe das Terminal, öffne ein neues (kein export), führe kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK" aus; eine OK-Antwort bedeutet, dass es eingerichtet ist
  4. Kein OK? Ordne deinen Fehler zu

    Vergleiche den Fehler in deinem Terminal mit den Häufigen Fehlern unten. Jeder listet die Ursache und die Lösung auf.

  5. Wechsle Kilo Code-Modelle: Ändere den Namen nach -m

    Schreibe nach -m aicodewith/ plus ein Modell, das unter models in kilo.json aufgeführt ist, zum Beispiel aicodewith/gpt-5.5. Um ein Modell hinzuzufügen, liste zuerst seine Model ID unter models auf; siehe Modelle und Preise.

Häufige Fehler

Kein Schlüssel gesetzt: Error: Unauthorized: 请在请求中提供有效的 API Key。

Was du siehst

Error: Unauthorized: 请在请求中提供有效的 API Key。
(Englisch: "Bitte gib einen gültigen API-Schlüssel in der Anfrage an.")
Ursache
apiKey in kilo.json ist {env:AICODEWITH_API_KEY}, und das neue Terminal hat keine solche Variable
So behebst du es
Schreibe deinen Schlüssel direkt in apiKey, wie in Schritt 2

Zurück zu Schritt 2: Konfiguration in kilo.json einfügen →

Kein Schlüssel gesetzt: apiKey ist weiterhin {env:AICODEWITH_API_KEY} und das neue Terminal hat keine solche Variable. Der Aufruf kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK" gibt aus: Error: Unauthorized: 请在请求中提供有效的 API Key。 (Englisch: "Bitte gib einen gültigen API-Schlüssel in der Anfrage an.")

Falscher Schlüssel: Error: Unauthorized: 请在请求中提供有效的 API Key。

Was du siehst

Error: Unauthorized: 请在请求中提供有效的 API Key。
(Englisch: "Bitte gib einen gültigen API-Schlüssel in der Anfrage an.")
Ursache
apiKey ist falsch; der Fehler ist derselbe wie ohne Schlüssel
So behebst du es
Kopiere den Schlüssel erneut aus der Konsole und ersetze den Wert in den Anführungszeichen bei apiKey

Zurück zu Schritt 2: Konfiguration in kilo.json einfügen →

Falscher Schlüssel: grep -n sk-wrong ~/.config/kilo/kilo.json zeigt, dass Zeile 10 "apiKey": "sk-wrong" ist. Der Aufruf kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK" gibt aus: Error: Unauthorized: 请在请求中提供有效的 API Key。 (Englisch: "Bitte gib einen gültigen API-Schlüssel in der Anfrage an.") — identisch mit dem Fehler ohne Schlüssel

Error: Model not found

Was du siehst

Error: Model not found
Ursache
Das Modell nach -m ist nicht unter models in kilo.json aufgeführt (zum Beispiel aicodewith/no-such-model), daher stoppt Kilo Code, bevor eine Anfrage gesendet wird
So behebst du es
Verwende ein unter models aufgeführtes Modell, zum Beispiel aicodewith/gpt-5.5

Zurück zu Schritt 3: Neues Terminal öffnen und Kilo Code testen →

Häufiger Fehler: Wenn der Modellname falsch ist (hier aicodewith/no-such-model), gibt kilo Error: Model not found zurück. Kilo löst dies selbst aus (das Modell ist nicht in kilo.json aufgeführt), bevor eine Anfrage gesendet wird. Verwende ein in der Konfiguration aufgeführtes Modell, zum Beispiel aicodewith/gpt-5.5

FAQ

Wie verwende ich meinen eigenen API-Schlüssel in Kilo Code?

Füge in ~/.config/kilo/kilo.json einen aicodewith-Provider mit baseURL https://api.aicodewith.ai/v1 hinzu und schreibe deinen Schlüssel in apiKey. Ein neues Terminal behält ihn.

Sollte die Basis-URL von Kilo Code /v1 enthalten?

Ja. Verwende https://api.aicodewith.ai/v1.

Wo ist die kilo.json von Kilo Code?

Die globale Konfiguration ist ~/.config/kilo/kilo.json.

Kilo Code meldet Unauthorized. Was nun?

apiKey in kilo.json fehlt oder ist falsch. Siehe Häufige Fehler oben für die Lösung.

Quellen

Verwandte Links