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 | bashCopiez votre clé unifiée depuis la page Keys. Les trois agents utilisent les mêmes valeurs :
| Champ | Valeur |
|---|---|
| Base URL | http://localhost:3001/v1 |
| API key | <unified-key> |
| Model ID | auto, ou un ID du catalogue issu de GET /v1/models |
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 :
- Ouvrez le panneau Cline dans VS Code. Cliquez sur l'icône des paramètres (engrenage).
- Réglez API Provider sur OpenAI Compatible.
- Réglez Base URL sur
http://localhost:3001/v1. - Réglez API Key sur votre clé unifiée.
- Réglez Model ID sur
autoou sur un modèle du tableau ci-dessous. - 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èle | Gratuit sur | Contexte | Limites gratuites (meilleure offre) | Outils | Vision |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 req/min 1 req/min per model | Oui | Non |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 req/min 40 RPM | Oui | Oui |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Oui | Oui |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Oui | Non |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Oui | Oui |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Oui | Oui |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 req/min 50 req/jour 50 req/day account-wide (1,000 after a $10 purchase) | Oui | Oui |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 req/min 50 req/jour Shared rate limit | Oui | Non |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 req/min 250 req/jour 70,000 jetons/min ~6M | Oui | Oui |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 req/min 20 req/jour 250,000 jetons/min ~3M | Oui | Oui |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Oui | Oui |
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
autopour 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:smartpour 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ème | Cause | Solution |
|---|---|---|
| "Invalid API Key" | La clé n'est pas votre clé unifiée FreeLLMAPI | Copiez à nouveau la clé unifiée depuis la page Keys |
| "Model Not Found" | L'ID du modèle ne figure pas dans votre catalogue | Utilisez auto ou un ID issu de GET /v1/models |
| L'agent s'arrête après une étape, ou les appels d'outils échouent | Le modèle gère mal l'appel d'outils, ou ne le gère pas | Choisissez un modèle du tableau ci-dessus |
| Erreurs de fenêtre de contexte sur les longues tâches | Le réglage de contexte dépasse le contexte réel du modèle | Ré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 limite | Ajoutez des clés d'autres fournisseurs, ou attendez la fin des délais d'attente |
Kilo : Model not found: openai-compatible/auto | Le modèle par défaut ne figure pas dans la table des modèles du fournisseur | Relancez setup-kilo, qui place le modèle par défaut en premier |
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
- Modèles d'IA gratuits dans VS Code
- Continue avec une API LLM gratuite
- Meilleures API gratuites de modèles de code
- API LLM gratuite avec appel de fonctions
- Utiliser Claude Code gratuitement
Sources
- Cline docs: OpenAI Compatible provider (vérifié le 20 November 2026)
- Cline docs: running models locally (vérifié le 20 November 2026)
- Kilo docs: custom models (vérifié le 20 November 2026)
- Kilo docs: OpenAI Compatible provider (vérifié le 20 November 2026)
- Roo Code repository (archived) (vérifié le 20 November 2026)
- Roo Code docs: settings management (vérifié le 20 November 2026)
- FreeLLMAPI docs: clients and coding agents (vérifié le 20 November 2026)