Passer au contenu principal
Kilo Code est un agent de codage IA open-source disponible dans VS Code, JetBrains, CLI, Slack et Cloud. Il se connecte à OrcaRouter via son Custom provider (provider personnalisé) (un endpoint compatible OpenAI). Ce guide couvre à la fois l’extension VS Code (la façon la plus courante d’utiliser Kilo Code) et le CLI (@kilocode/cli, pour un usage headless).
Protocole : compatible OpenAI
  • Base URL : https://api.orcarouter.ai/v1 (inclut /v1)
  • Les identifiants de modèles utilisent le format vendor/model — le plus simple est orcarouter/auto

​
Extension VS Code

  1. Installez Kilo Code depuis le VS Code Marketplace (ouvrez le panneau Extensions et recherchez « Kilo Code »), puis ouvrez-le via l’icône Kilo Code dans la barre d’activité (la bande d’icônes de gauche). Dans le panneau, cliquez sur la roue dentée ⚙ en haut à droite pour ouvrir les paramètres.
Le panneau Kilo Code avec la roue dentée des paramètres mise en évidence
  1. Allez dans Providers (providers). Sous Popular providers (providers populaires), trouvez Custom provider (provider personnalisé) (« Add an OpenAI-compatible provider by base URL ») et cliquez sur + Connect.
L'entrée Custom provider dans les paramètres Providers de Kilo Code
  1. Renseignez les champs du provider :
    • Provider ID : orcarouter (uniquement des lettres minuscules, chiffres, traits d’union ou tirets bas — pas de barres obliques ; orcarouter/auto est rejeté ici).
    • Display name : OrcaRouter (ce que vous voulez).
    • Base URL : https://api.orcarouter.ai/v1
    • API key : votre clé OrcaRouter (sk-orca-...).
Le provider ID, la base URL et l'API key OrcaRouter dans Kilo Code
  1. Choisissez vos modèles. Une fois la clé et la base URL valides, Kilo Code récupère la liste des modèles en direct depuis OrcaRouter — cochez ceux que vous voulez (ou Select all), puis cliquez sur Submit. Pour utiliser le routage automatique, faites aussi + Add model avec l’ID de modèle orcarouter/auto (c’est un alias de routage, il n’apparaît donc pas dans la liste récupérée).
Le sélecteur de modèles de Kilo Code affichant les modèles récupérés depuis OrcaRouter
  1. Le provider apparaît désormais sous Connected providers (providers connectés) en tant que OrcaRouter (CUSTOM).
OrcaRouter listé sous Connected providers dans Kilo Code
  1. Sélectionnez le modèle OrcaRouter dans le sélecteur de modèles du panneau de chat et envoyez un message de test — une réponse confirme la connexion.
Kilo Code répondant via OrcaRouter
Sur un dépôt volumineux, Kilo Code peut d’abord demander s’il faut attendre l’initialisation de son système de snapshots — choisissez Disable for this project pour passer cette étape (git suit toujours tout) afin que la requête aboutisse.
Le plugin JetBrains utilise le même Custom provider (provider personnalisé) avec des valeurs de base URL / clé / modèle identiques.

​
CLI

Pour un usage headless / scripté, installez le CLI.

​
Install

npm install -g @kilocode/cli
La commande est kilo.

​
Configure

Fichier de configuration : ~/.config/kilo/kilo.jsonc (accepte aussi kilo.json ; un ./kilo.jsonc au niveau du projet prévaut). 
{
  "$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"
}
Remplacez par un modèle spécifique si vous préférez, par ex. anthropic/claude-opus-4.8 ou google/gemini-2.5-flash. Les identifiants de modèles utilisent le format vendor/model.

​
Run

echo "Reply with exactly: OK" | kilo run --auto --format json
Attendu : un événement JSON avec "type":"text" et "text":"OK".

​
Notes

  • La base_url inclut /v1.
  • Les références de modèles utilisent provider/model. Comme le provider s’appelle orcarouter et que l’ID de modèle porte lui aussi un préfixe vendor, la référence comporte trois segments : orcarouter/orcarouter/auto (ou orcarouter/anthropic/claude-opus-4.8).
  • Le mode headless est kilo run "<prompt>" --auto (ou transmettez le prompt via stdin). --format json fournit un flux d’événements lisible par une machine.
  • Raisonnement / réflexion (reasoning/thinking) : utilisez le flag --variant <name> pour l’effort de raisonnement spécifique au provider (par ex. high, max, minimal), et --thinking pour afficher les blocs de réflexion.
Problème connu : --auto a fait l’objet de cas signalés de blocage après l’achèvement / lorsque la clé est absente (kilocode issues). Encadrez-le avec un timeout en CI et assurez-vous que la clé est bien chargée.