Zum Hauptinhalt springen
Kilo Code ist ein quelloffener KI-Coding-Agent, verfügbar in VS Code, JetBrains, CLI, Slack und Cloud. Er verbindet sich mit OrcaRouter über seinen Custom provider (benutzerdefinierten Provider) — einen OpenAI-kompatiblen Endpunkt. Diese Anleitung behandelt sowohl die VS-Code-Erweiterung (die gängigste Art, Kilo Code zu nutzen) als auch die CLI (@kilocode/cli, für den Headless-Einsatz).
Protokoll: OpenAI-kompatibel
  • Basis-URL: https://api.orcarouter.ai/v1 (enthält /v1)
  • Modell-IDs verwenden das Format vendor/model — am einfachsten ist orcarouter/auto

​
VS-Code-Erweiterung

  1. Installiere Kilo Code aus dem VS Code Marketplace (öffne das Erweiterungen-Panel und suche nach „Kilo Code”), und öffne es anschließend über das Kilo-Code-Symbol in der Activity Bar (die linke Symbolleiste). Klicke im Panel oben rechts auf das ⚙ Zahnrad, um die Einstellungen zu öffnen.
Das Kilo-Code-Panel mit hervorgehobenem Einstellungs-Zahnrad
  1. Gehe zu Providers (Provider). Suche unter Popular providers (beliebte Provider) den Eintrag Custom provider (benutzerdefinierter Provider) („Add an OpenAI-compatible provider by base URL”) und klicke auf + Connect.
Der Eintrag Custom provider in den Providers-Einstellungen von Kilo Code
  1. Fülle die Provider-Felder aus:
    • Provider ID: orcarouter (nur Kleinbuchstaben, Ziffern, Bindestriche oder Unterstriche — keine Schrägstriche; orcarouter/auto wird hier abgelehnt).
    • Display name (Anzeigename): OrcaRouter (beliebig wählbar).
    • Base URL (Basis-URL): https://api.orcarouter.ai/v1
    • API key (API-Schlüssel): dein OrcaRouter-Schlüssel (sk-orca-...).
OrcaRouter-Provider-ID, Basis-URL und API-Schlüssel in Kilo Code
  1. Wähle deine Modelle. Sobald Schlüssel und Basis-URL gültig sind, ruft Kilo Code die aktuelle Modellliste von OrcaRouter ab — hake die gewünschten an (oder Select all (Alle auswählen)) und klicke dann auf Submit (Absenden). Um das Auto-Routing zu nutzen, füge zusätzlich mit + Add model (Modell hinzufügen) die Modell-ID orcarouter/auto hinzu (es ist ein Routing-Alias und erscheint daher nicht in der abgerufenen Liste).
Modellauswahl von Kilo Code mit von OrcaRouter abgerufenen Modellen
  1. Der Provider erscheint nun unter Connected providers (verbundene Provider) als OrcaRouter (CUSTOM).
OrcaRouter unter Connected providers in Kilo Code aufgelistet
  1. Wähle im Modell-Picker des Chat-Panels das OrcaRouter-Modell aus und sende eine Testnachricht — eine Antwort bestätigt die Verbindung.
Kilo Code antwortet über OrcaRouter
Bei einem großen Repository fragt Kilo Code möglicherweise zunächst, ob es auf die Initialisierung seines Snapshot-Systems warten soll — wähle Disable for this project (Für dieses Projekt deaktivieren), um dies zu überspringen (git erfasst weiterhin alles), damit die Anfrage durchgeht.
Das JetBrains-Plugin verwendet denselben Custom provider (benutzerdefinierten Provider) mit identischen Werten für Basis-URL, Schlüssel und Modell.

​
CLI

Für den Headless-/Skript-Einsatz installiere die CLI.

​
Installation

npm install -g @kilocode/cli
Der Befehl lautet kilo.

​
Konfigurieren

Konfigurationsdatei: ~/.config/kilo/kilo.jsonc (akzeptiert auch kilo.json; eine projektbezogene ./kilo.jsonc hat Vorrang). 
{
  "$schema": "https://app.kilo.ai/config.json",
  "provider": {
    "orcarouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OrcaRouter",
      "options": { "baseURL": "https://api.orcarouter.ai/v1", "apiKey": "sk-orca-..." },
      "models": { "orcarouter/auto": { "name": "OrcaRouter Auto" } }
    }
  },
  "model": "orcarouter/orcarouter/auto"
}
Setze bei Bedarf ein bestimmtes Modell ein, z. B. anthropic/claude-opus-4.8 oder google/gemini-2.5-flash. Modell-IDs verwenden das Format vendor/model.

​
Ausführen

echo "Reply with exactly: OK" | kilo run --auto --format json
Erwartet: ein JSON-Ereignis mit "type":"text" und "text":"OK".

​
Hinweise

  • Die base_url enthält /v1.
  • Modellreferenzen verwenden provider/model. Da der Provider orcarouter heißt und die Modell-ID ebenfalls ein vendor-Präfix trägt, besteht die Referenz aus drei Segmenten: orcarouter/orcarouter/auto (oder orcarouter/anthropic/claude-opus-4.8).
  • Der Headless-Modus ist kilo run "<prompt>" --auto (oder gib den Prompt über stdin ein). --format json liefert einen maschinenlesbaren Ereignisstrom.
  • Reasoning/Thinking: Verwende das Flag --variant <name> für anbieterspezifischen Reasoning-Aufwand (z. B. high, max, minimal) und --thinking, um Thinking-Blöcke anzuzeigen.
Bekanntes Problem: Bei --auto wurden Fälle gemeldet, in denen es nach Abschluss / bei fehlendem Schlüssel hängen bleibt (kilocode issues). Umschließe es in CI mit einem timeout und stelle sicher, dass der Schlüssel geladen ist.