Utiliser OpenCode avec une API LLM gratuite
OpenCode est un agent de programmation open source pour le terminal et le bureau. Il accepte tout fournisseur compatible OpenAI. Ce guide connecte OpenCode à des modèles gratuits grâce à FreeLLMAPI. Une commande écrit la configuration et enregistre la clé.
Le code, les noms de modèles et les libellés du catalogue en direct sont affichés en anglais.
Étape 1 : installer FreeLLMAPI
FreeLLMAPI est une passerelle open source. Elle s'exécute sur votre ordinateur dans Docker et regroupe les offres gratuites de 45 fournisseurs derrière une seule clé.
Installer sur macOS ou Linux
curl -fsSL https://freellmapi.co/install.sh | bashOuvrez http://localhost:3001. Ajoutez au moins deux clés de fournisseurs gratuits sur la page Keys. Google AI Studio et Groq fournissent chacun une clé gratuite en quelques minutes. Copiez votre clé unifiée depuis la même page.
Étape 2 : connecter OpenCode avec une commande
Une commande
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key>
opencodeLa commande effectue trois actions :
- Elle ajoute un fournisseur
freellmapidans~/.config/opencode/opencode.json. Le fournisseur liste les modèles de votre catalogue en direct avec leurs limites de contexte. - Elle définit
freellmapi/autocomme modèle par défaut. - Elle enregistre la clé dans le fichier d'identifiants d'OpenCode,
~/.local/share/opencode/auth.json. Vous n'avez pas besoin de variable d'environnement, ni dans la CLI ni dans l'application de bureau.
La commande crée une sauvegarde avant d'écrire. Elle fusionne le nouveau fournisseur, donc vos autres fournisseurs restent en place. Si XDG_CONFIG_HOME ou XDG_DATA_HOME est défini, la commande utilise ces dossiers.
Avant de lancer une longue tâche, vérifiez que la passerelle peut répondre à une requête maintenant. Cet appel ne liste que les modèles qui ont une clé utilisable à ce moment :
Vérifier les modèles prêts
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"Un modèle au statut exhausted a des clés, mais toutes ont atteint une limite pour le moment. Ce statut disparaît à la fin des délais d'attente. Exécutez npx freellmapi doctor pour vérifier que les requêtes d'un client atteignent la passerelle. Le journal des requêtes du tableau de bord affiche chaque appel depuis OpenCode. L'en-tête de réponse X-Routed-Via indique le fournisseur et le modèle qui ont répondu à chaque requête. Si une requête a basculé, l'en-tête X-Fallback-Trail indique chaque saut en échec et la raison.
Configuration manuelle : le bloc de fournisseur opencode.json
Pour une configuration manuelle, ajoutez ce bloc dans ~/.config/opencode/opencode.json, ou dans opencode.json de votre projet. OpenCode utilise @ai-sdk/openai-compatible pour les points d'accès /v1/chat/completions.
opencode.json
{
"$schema": "https://opencode.ai/config.json",
"model": "freellmapi/auto",
"provider": {
"freellmapi": {
"npm": "@ai-sdk/openai-compatible",
"name": "FreeLLMAPI",
"options": {
"baseURL": "http://localhost:3001/v1"
},
"models": {
"auto": {
"name": "Auto",
"limit": { "context": 128000, "output": 8192 }
}
}
}
}
}Ajoutez ensuite la clé. Lancez OpenCode, exécutez /connect, sélectionnez le fournisseur freellmapi et collez votre clé unifiée. L'ID du fournisseur dans /connect doit correspondre à l'ID de la configuration. Exécutez /models pour sélectionner un modèle.
limit.contextest le nombre maximal de tokens d'entrée du modèle.limit.outputest le nombre maximal de tokens qu'il peut générer.- Le
modelde premier niveau utilise le formatprovider/model. Sans lui, OpenCode garde le modèle utilisé précédemment. - Chaque ID de modèle que vous voulez utiliser doit figurer dans la table
models. Ajoutez d'autres ID issus deGET /v1/models.
providers. Elle indique que le format V1 ci-dessus reste pris en charge. La commande d'installation de FreeLLMAPI écrit le format V1.Choisir des modèles pour OpenCode
OpenCode est un agent. Il lit des fichiers, les modifie et exécute des commandes par des appels d'outils. Chaque requête contient un 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.
| 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 freellmapi/auto pour laisser le routeur choisir un modèle pour chaque requête. Ajoutez auto:smart ou auto:fast à la table models pour orienter les requêtes selon l'intelligence ou la vitesse. Vous pouvez aussi ajouter un profil nommé, par exemple auto:coding, après l'avoir créé sur le tableau de bord.
Limites de débit et longues sessions
Une seule tâche d'agent peut envoyer des dizaines de requêtes. Une seule offre gratuite arrête vite une longue tâche. FreeLLMAPI compte les requêtes et les tokens de chaque clé. Lorsqu'un fournisseur renvoie une erreur 429, le routeur envoie la requête au modèle suivant de la chaîne, et la session continue.
- Ajoutez des clés de quatre fournisseurs ou plus. Plus de fournisseurs donnent plus de requêtes par jour.
- Activez le transfert de contexte avec
FREELLMAPI_CONTEXT_HANDOFF=on_model_switchdans le fichier.envde FreeLLMAPI. Quand le modèle change, le modèle suivant reçoit une courte note indiquant qu'il poursuit une tâche. - Les sessions persistantes gardent une conversation sur un même modèle pendant 30 minutes. Cela maintient la cohérence de l'agent.
- Démarrez une nouvelle session pour chaque tâche. Un contexte plus petit utilise moins de tokens par requête.
Dépannage
| Problème | Cause | Solution |
|---|---|---|
| "Invalid API key" avec une clé valide | Une valeur apiKey vide dans la configuration remplace la clé de /connect | Supprimez apiKey de options, ou relancez setup-opencode |
| OpenCode n'utilise pas le nouveau fournisseur | Le model de premier niveau n'est pas défini | Définissez "model": "freellmapi/auto" |
| Modèle introuvable | L'ID du modèle ne figure pas dans la table models du fournisseur | Ajoutez l'ID à la table, ou relancez setup-opencode |
La clé {env:VAR} est vide | OpenCode remplace une variable non définie par une chaîne vide | Exportez la variable dans le même shell, ou enregistrez la clé avec /connect |
| Les appels d'outils échouent | Le modèle gère mal l'appel d'outils | Choisissez un modèle du tableau ci-dessus |
| « Tous les modèles ont atteint leur limite après N tentatives » | Toutes les clés ont atteint leur limite | Ajoutez des clés d'autres fournisseurs, ou attendez la fin des délais d'attente |
Questions fréquentes
Puis-je utiliser OpenCode gratuitement ?
Oui. OpenCode est open source. Connectez-le à FreeLLMAPI comme fournisseur compatible OpenAI. La passerelle envoie chaque requête vers les offres gratuites des fournisseurs, donc l'inférence coûte $0.
Comment ajouter un fournisseur personnalisé compatible OpenAI à OpenCode ?
Ajoutez à opencode.json un fournisseur avec npm défini sur @ai-sdk/openai-compatible, options.baseURL et une table models. Lancez ensuite /connect pour enregistrer la clé, puis /models pour sélectionner un modèle.
Quel modèle gratuit convient le mieux à OpenCode ?
Utilisez un modèle avec appel d'outils et au moins 128K de contexte. Le tableau de cette page présente les modèles gratuits les plus performants qui respectent aujourd'hui ces deux règles. Utilisez freellmapi/auto pour laisser le routeur en choisir un.
Où OpenCode stocke-t-il les clés d'API ?
Les clés ajoutées avec /connect sont enregistrées dans ~/.local/share/opencode/auth.json. La commande d'installation de FreeLLMAPI y écrit la clé, afin que la CLI et l'application de bureau la trouvent toutes deux.
Guides associés
- Utiliser Aider avec une API LLM gratuite
- Utiliser Codex CLI avec des modèles gratuits
- Utiliser Claude Code gratuitement
- Meilleures API gratuites de modèles de code
- URL de base des API gratuites compatibles OpenAI
Sources
- OpenCode docs: providers (V1 config) (vérifié le 20 November 2026)
- OpenCode docs: config (vérifié le 20 November 2026)
- OpenCode docs: migrate from V1 (vérifié le 20 November 2026)
- FreeLLMAPI CLI generators (vérifié le 20 November 2026)
- FreeLLMAPI docs: context handoff (vérifié le 20 November 2026)