Accueil / Guides / Cline, Roo Code et Kilo Code avec une API gratuite

Cline, Roo Code et Kilo Code avec une API gratuite

Cline, Roo Code et Kilo Code sont des agents de programmation pour VS Code. Chacun peut utiliser une API compatible OpenAI. Ce guide les connecte à des modèles gratuits grâce à FreeLLMAPI. Il indique aussi quels modèles gratuits gèrent les longs prompts riches en appels d'outils que ces agents envoient.

Le code, les noms de modèles et les libellés du catalogue en direct sont affichés en anglais.

Avant de commencer

FreeLLMAPI est une passerelle open source qui s'exécute sur votre ordinateur. Elle regroupe les offres gratuites de 45 fournisseurs derrière une seule clé. Installez-la avec Docker, puis ajoutez au moins deux clés de fournisseurs gratuits sur la page Keys.

Installer sur macOS ou Linux

curl -fsSL https://freellmapi.co/install.sh | bash

Copiez votre clé unifiée depuis la page Keys. Les trois agents utilisent les mêmes valeurs :

ChampValeur
Base URLhttp://localhost:3001/v1
API key<unified-key>
Model IDauto, ou un ID du catalogue issu de GET /v1/models
État de Roo Code : le README de Roo Code indique que l'extension a été arrêtée le 15 mai 2026. Le dépôt est archivé et en lecture seule. Les étapes ci-dessous s'appliquent toujours à une installation existante, mais les nouveaux utilisateurs doivent choisir Cline ou Kilo Code.

Cline

La méthode la plus rapide est la commande d'installation. Elle lit votre catalogue en direct, sauvegarde les paramètres existants de Cline et ajoute un fournisseur OpenAI Compatible.

Une commande

npx freellmapi setup-cline --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-cline --url http://localhost:3001 --api-key <unified-key>

La première ligne affiche les différences et n'écrit rien. La seconde ligne écrit la modification. Pour configurer Cline manuellement, suivez ces étapes :

  1. Ouvrez le panneau Cline dans VS Code. Cliquez sur l'icône des paramètres (engrenage).
  2. Réglez API Provider sur OpenAI Compatible.
  3. Réglez Base URL sur http://localhost:3001/v1.
  4. Réglez API Key sur votre clé unifiée.
  5. Réglez Model ID sur auto ou sur un modèle du tableau ci-dessous.
  6. Ouvrez Model Configuration. Réglez Context Window sur le contexte de votre modèle. Activez Image Support uniquement pour un modèle de vision.

Cline affiche cette note pour les fournisseurs OpenAI Compatible : « Cline uses complex prompts, so behavior can vary across models. » Pour les modèles plus petits, la documentation de Cline recommande Use Compact Prompt dans Cline Settings, Features.

Kilo Code

Exécutez la commande d'installation. Elle écrit une configuration Kilo globale avec un fournisseur openai-compatible et le définit comme modèle par défaut.

Une commande

export FREELLMAPI_API_KEY=<unified-key>
npx freellmapi setup-kilo --url http://localhost:3001 --dry-run
npx freellmapi setup-kilo --url http://localhost:3001
kilo run "Say hello"

La configuration désigne la clé par {env:FREELLMAPI_API_KEY}. Exportez donc la variable avant de lancer Kilo. Kilo développe {env:...} uniquement dans une configuration de confiance, par exemple le dossier global ~/.config/kilo. Dans une configuration de projet, Kilo l'ignore et journalise un avertissement. La configuration générée a cette forme :

Configuration globale de Kilo (forme)

{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "openai-compatible/auto",
  "provider": {
    "openai-compatible": {
      "options": {
        "apiKey": "{env:FREELLMAPI_API_KEY}",
        "baseURL": "http://localhost:3001/v1"
      },
      "models": {
        "auto": {
          "name": "Auto",
          "tool_call": true,
          "limit": { "context": 128000, "output": 8192 }
        }
      }
    }
  }
}

Dans l'extension VS Code, vous pouvez aussi ajouter le fournisseur manuellement. Ouvrez Settings, puis l'onglet Providers, puis cliquez sur Custom provider. Réglez Provider API sur OpenAI Compatible. Saisissez l'URL de base et la clé, puis cliquez sur Fetch models pour lire la liste des modèles.

Roo Code (installations existantes)

La commande d'installation écrit un fichier d'import pour l'extension VS Code. Elle écrit aussi un profil pour la CLI Roo.

Une commande

npx freellmapi setup-roo --url http://localhost:3001 --api-key <unified-key>

Demandez ensuite à Roo Code de charger le fichier d'import. Ajoutez cette ligne à votre settings.json de VS Code, puis rechargez la fenêtre. Le profil freellmapi devient le profil actif.

settings.json de VS Code

"roo-cline.autoImportSettingsPath": "~/.roo/freellmapi.json"

Pour une configuration manuelle, ouvrez les paramètres de Roo Code et réglez API Provider sur OpenAI Compatible. Saisissez l'URL de base, la clé et le modèle. Roo Code utilise uniquement l'appel d'outils natif. Sa documentation indique qu'un modèle sans appel d'outils natif ne peut pas être utilisé avec Roo Code.

Choisir des modèles pour le travail d'agent

Ces agents envoient à chaque requête un long prompt système, des définitions d'outils et le contenu de fichiers. Utilisez des modèles avec appel d'outils et une grande fenêtre de contexte. Le tableau présente, par niveau d'intelligence, les modèles gratuits avec appel d'outils et au moins 128K de contexte à ce jour.

Modèles gratuits pour Cline, Roo Code et Kilo Code : appel d'outils et contexte de 128K+
ModèleGratuit surContexteLimites gratuites (meilleure offre)OutilsVision
GLM 5.3UnoRouter1M1 req/min
1 req/min per model
OuiNon
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 req/min
40 RPM
OuiOui
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaOuiOui
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceOuiNon
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditOuiOui
Gemini 3.7 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditOuiOui
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 req/min
50 req/jour
50 req/day account-wide (1,000 after a $10 purchase)
OuiOui
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 req/min
50 req/jour
Shared rate limit
OuiNon
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 req/min
250 req/jour
70,000 jetons/min
~6M
OuiOui
Gemini 3.6 FlashGoogle AI Studio1M10 req/min
20 req/jour
250,000 jetons/min
~3M
OuiOui
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayOuiOui

Affichage de 12 modèles gratuits sur 109 correspondants. Voir tous les modèles.

Données en direct du catalogue FreeLLMAPI (version 2026.11.19, vérifié le 2026-11-19). Les limites gratuites changent souvent. Le catalogue est vérifié chaque jour.

  • Utilisez auto pour laisser le routeur choisir un modèle pour chaque requête. Lorsqu'un fournisseur renvoie une erreur 429, le routeur essaie le modèle suivant.
  • Utilisez auto:smart pour la planification et les bogues difficiles.
  • Réglez la fenêtre de contexte de l'agent sur le contexte réel du modèle. Si la valeur est trop élevée, l'agent envoie des prompts que le modèle refuse.
  • Démarrez une nouvelle tâche lorsque le contexte devient grand. Un contexte plus petit utilise moins de tokens par requête.

Dépannage

ProblèmeCauseSolution
"Invalid API Key"La clé n'est pas votre clé unifiée FreeLLMAPICopiez à nouveau la clé unifiée depuis la page Keys
"Model Not Found"L'ID du modèle ne figure pas dans votre catalogueUtilisez auto ou un ID issu de GET /v1/models
L'agent s'arrête après une étape, ou les appels d'outils échouentLe modèle gère mal l'appel d'outils, ou ne le gère pasChoisissez un modèle du tableau ci-dessus
Erreurs de fenêtre de contexte sur les longues tâchesLe réglage de contexte dépasse le contexte réel du modèleRéglez la bonne fenêtre de contexte, ou démarrez une nouvelle tâche
« Tous les modèles ont atteint leur limite après N tentatives »Chaque clé de la chaîne a atteint sa limiteAjoutez des clés d'autres fournisseurs, ou attendez la fin des délais d'attente
Kilo : Model not found: openai-compatible/autoLe modèle par défaut ne figure pas dans la table des modèles du fournisseurRelancez setup-kilo, qui place le modèle par défaut en premier
Utilisez chacun de ces modèles avec une seule clé. FreeLLMAPI est un routeur open source auto-hébergé. Il place toutes ces offres gratuites derrière un seul point de terminaison compatible OpenAI, et bascule vers une autre offre lorsqu'une limite de débit est atteinte. Parcourir le catalogue ou passer en production.

Questions fréquentes

Puis-je utiliser Cline gratuitement ?

Oui. Cline est gratuit et open source. Réglez son API provider sur OpenAI Compatible et pointez-le vers FreeLLMAPI. La passerelle envoie chaque requête vers les offres gratuites des fournisseurs, donc l'inférence coûte $0.

Quel modèle gratuit convient le mieux à Cline ?

Utilisez un modèle avec appel d'outils et au moins 128K de contexte. Cline envoie des prompts complexes avec des définitions d'outils. Le tableau de cette page présente les modèles gratuits les plus performants qui respectent aujourd'hui ces deux règles.

Roo Code est-il toujours maintenu ?

Non. Le README de Roo Code indique que l'extension a été arrêtée le 15 mai 2026, et le dépôt est archivé. Les installations existantes fonctionnent toujours avec un fournisseur OpenAI Compatible.

Comment utiliser Kilo Code avec une API personnalisée compatible OpenAI ?

Ajoutez un fournisseur openai-compatible avec un baseURL et un apiKey dans la configuration globale de Kilo, ou exécutez npx freellmapi setup-kilo. Dans l'extension VS Code, utilisez Settings, Providers, Custom provider.

Pourquoi Cline échoue-t-il avec des modèles gratuits ?

La plupart des échecs viennent de modèles qui gèrent mal l'appel d'outils ou qui ont une petite fenêtre de contexte. Choisissez un modèle avec appel d'outils et 128K de contexte, et activez Use Compact Prompt pour les modèles plus petits.

Guides associés

Sources

Tous les guides · Parcourir tous les modèles gratuits