Przejdź do głównej treści
Kilo Code to otwartoźródłowy agent kodujący AI dostępny w VS Code, JetBrains, CLI, Slack i Cloud. Łączy się z OrcaRouter poprzez Custom provider (dostawca niestandardowy) (endpoint zgodny z OpenAI). Ten przewodnik obejmuje zarówno rozszerzenie VS Code (najczęstszy sposób używania Kilo Code), jak i CLI (@kilocode/cli, do użycia bezgłowego).
Protokół: zgodny z OpenAI
  • Bazowy URL: https://api.orcarouter.ai/v1 (zawiera /v1)
  • Identyfikatory modeli używają formatu vendor/model — najprostszym jest orcarouter/auto

​
Rozszerzenie VS Code

  1. Zainstaluj Kilo Code z VS Code Marketplace (otwórz panel Extensions i wyszukaj „Kilo Code”), a następnie otwórz je za pomocą ikony Kilo Code na pasku Activity Bar (lewy pasek ikon). W panelu kliknij ⚙ koło zębate w prawym górnym rogu, aby otworzyć ustawienia.
Panel Kilo Code z podświetlonym kołem zębatym ustawień
  1. Przejdź do Providers (dostawcy). W sekcji Popular providers (popularni dostawcy) znajdź Custom provider (dostawca niestandardowy) („Add an OpenAI-compatible provider by base URL”) i kliknij + Connect.
Wpis Custom provider w ustawieniach Providers w Kilo Code
  1. Wypełnij pola dostawcy:
    • Provider ID: orcarouter (tylko małe litery, cyfry, myślniki lub podkreślenia — bez ukośników; orcarouter/auto jest tutaj odrzucane).
    • Display name: OrcaRouter (cokolwiek chcesz).
    • Base URL: https://api.orcarouter.ai/v1
    • API key: Twój klucz OrcaRouter (sk-orca-...).
OrcaRouter provider ID, base URL i API key w Kilo Code
  1. Wybierz swoje modele. Gdy klucz i bazowy URL są prawidłowe, Kilo Code pobiera z OrcaRouter aktualną listę modeli — zaznacz te, których chcesz (lub Select all), a następnie kliknij Submit. Aby używać automatycznego routingu, dodatkowo użyj + Add model z ID modelu orcarouter/auto (to alias routingu, więc nie pojawi się na pobranej liście).
Selektor modeli w Kilo Code pokazujący modele pobrane z OrcaRouter
  1. Dostawca pojawia się teraz w sekcji Connected providers (połączeni dostawcy) jako OrcaRouter (CUSTOM).
OrcaRouter widoczny w sekcji Connected providers w Kilo Code
  1. Wybierz model OrcaRouter w selektorze modeli w panelu czatu i wyślij wiadomość testową — odpowiedź potwierdza połączenie.
Kilo Code odpowiadające poprzez OrcaRouter
W przypadku dużego repozytorium Kilo Code może najpierw zapytać, czy zaczekać na zainicjowanie jego systemu migawek — wybierz Disable for this project, aby to pominąć (git nadal śledzi wszystko), aby żądanie przeszło.
Wtyczka JetBrains używa tego samego Custom provider (dostawcy niestandardowego) z identycznymi wartościami bazowego URL / klucza / modelu.

​
CLI

Do użycia bezgłowego / skryptowego zainstaluj CLI.

​
Instalacja

npm install -g @kilocode/cli
Polecenie to kilo.

​
Konfiguracja

Plik konfiguracyjny: ~/.config/kilo/kilo.jsonc (akceptuje także kilo.json; konfiguracja na poziomie projektu ./kilo.jsonc ma pierwszeństwo). 
{
  "$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"
}
Jeśli wolisz, wstaw konkretny model, np. anthropic/claude-opus-4.8 lub google/gemini-2.5-flash. Identyfikatory modeli używają formatu vendor/model.

​
Uruchamianie

echo "Reply with exactly: OK" | kilo run --auto --format json
Oczekiwane: zdarzenie JSON z "type":"text" i "text":"OK".

​
Uwagi

  • base_url zawiera /v1.
  • Odwołania do modeli używają formatu provider/model. Ponieważ dostawca nosi nazwę orcarouter, a identyfikator modelu również niesie prefiks vendor, odwołanie składa się z trzech segmentów: orcarouter/orcarouter/auto (lub orcarouter/anthropic/claude-opus-4.8).
  • Tryb bezgłowy to kilo run "<prompt>" --auto (lub przekaż prompt przez stdin). --format json daje strumień zdarzeń czytelny maszynowo.
  • Rozumowanie/myślenie: użyj flagi --variant <name> dla wysiłku rozumowania zależnego od dostawcy (np. high, max, minimal) oraz --thinking, aby wyświetlać bloki myślenia.
Znany problem: --auto ma zgłaszane przypadki zawieszania się po zakończeniu / gdy brakuje klucza (kilocode issues). W CI opakuj to poleceniem timeout i upewnij się, że klucz jest załadowany.