OpenCode : corriger l’erreur « OpenCode's free tier can only be used from within OpenCode »
Depuis quelques jours, OpenCode Desktop peut afficher un message particulièrement déroutant : Error from provider (Console): OpenCode's free tier can only be used from within OpenCode. Le problème : l’erreur peut apparaître alors que l’on utilise déjà OpenCode lui-même. Je l’ai rencontrée sur mon projet, avec le modèle gratuit Muse Spark 1.3 Free. Dans mon cas, la solution a été nette : désinstaller complètement OpenCode puis installer la nouvelle version. Après la réinstallation, les modèles gratuits ont de nouveau fonctionné normalement.
Quel est le message d’erreur OpenCode ?
Le message complet est :Error from provider (Console): OpenCode's free tier can only be used from within OpenCode
Il concerne le free tier d’OpenCode, c’est-à-dire les modèles accessibles gratuitement via le provider Console. Le message laisse entendre que la requête vient d’un client externe, alors que plusieurs utilisateurs l’ont reproduit directement dans l’application officielle OpenCode Desktop.
Un ticket GitHub ouvert le 17 septembre 2026 décrit exactement ce comportement sur Windows avec OpenCode Desktop 1.18.31. D’autres rapports concernent macOS, la CLI et certaines opérations internes comme la génération de titre ou la compaction automatique.
Pourquoi OpenCode affiche-t-il cette erreur alors qu’on est déjà dans OpenCode ?
Le 18 septembre, un collaborateur du projet a expliqué sur GitHub que l’équipe avait renforcé sa logique de protection contre les abus du free tier. Une régression avait alors provoqué le rejet de certaines requêtes internes, notamment celles utilisées pour la compaction, comme si elles ne provenaient pas d’OpenCode.
Le problème n’était donc pas nécessairement lié au projet ouvert, aux fichiers du dépôt ou à une mauvaise configuration locale. Plusieurs tickets montrent que des requêtes normales pouvaient fonctionner tandis que des opérations internes échouaient avec exactement le même message.
Le bug a évolué rapidement. Certaines régressions ont été annoncées comme corrigées, mais des signalements très proches existaient encore le 23 septembre, notamment avec des agents personnalisés. Le symptôme peut donc avoir plusieurs causes selon la version et la manière dont OpenCode envoie la requête.
La solution qui a fonctionné pour moi
Une mise à jour classique ne m’avait pas sortie de cette situation. J’ai finalement désinstallé OpenCode, puis installé proprement la nouvelle version.
Après cette réinstallation, le free tier a recommencé à fonctionner immédiatement. J’ai pu ouvrir mon dépôt, demander à OpenCode de l’analyser et utiliser Muse Spark 1.3 Free sans revoir l’erreur.
Si vous êtes bloqué avec le même message après une mise à jour, la réinstallation complète vaut donc le test avant de toucher à la configuration de votre projet, à vos fichiers ou à vos intégrations.
Faut-il modifier son projet ou sa configuration OpenCode ?
Pas en premier réflexe. Les tickets GitHub montrent que l’erreur a touché des utilisateurs de l’application officielle avec différentes configurations et différents systèmes. Supprimer ses agents, modifier ses providers ou reconstruire son projet risque surtout d’ajouter de nouvelles variables au diagnostic.
Commencez par vérifier la version installée. Si le problème persiste sur une installation ancienne ou après une mise à jour, testez une désinstallation suivie d’une installation propre de la version actuelle. Si l’erreur ne touche qu’un agent personnalisé ou une opération précise, le problème peut encore venir de la gestion des sessions du free tier plutôt que de votre dépôt.
Pourquoi le message continue-t-il d’apparaître chez certains utilisateurs ?
Le message est utilisé côté service pour refuser les requêtes qui ne sont pas reconnues comme provenant correctement d’OpenCode. Cela concerne volontairement certains clients tiers, mais les tickets de septembre montrent aussi des faux positifs dans l’application officielle.
Un ticket encore ouvert signale par exemple qu’un agent personnalisé peut être rejeté alors qu’un agent intégré fonctionne avec le même modèle et dans la même session. Un autre rapport du 23 septembre mentionne une erreur de type MissingSessionID pour des agents personnalisés.
La réinstallation a corrigé mon cas, mais elle ne constitue donc pas une garantie pour toutes les variantes du bug. Si le problème revient uniquement avec un sous-agent, un agent personnalisé ou la compaction, il faut vérifier les tickets récents du dépôt OpenCode.
Sources
- GitHub #49588 : rapport du 17 septembre 2026 reproduisant l’erreur dans OpenCode Desktop 1.18.31 sous Windows.
- GitHub #49610 : discussion où un collaborateur OpenCode explique le durcissement de la logique anti-abus et la régression ayant touché la compaction.
- GitHub #49592 : exemple où les requêtes normales fonctionnent mais où les agents internes
titleetcompactionéchouent. - GitHub #50943 : rapport du 23 septembre 2026 sur des agents personnalisés rejetés par le free tier avec une erreur
MissingSessionID.
Comment corriger « OpenCode's free tier can only be used from within OpenCode » ?
Dans mon cas, désinstaller complètement OpenCode puis installer la nouvelle version a corrigé l’erreur. Si elle persiste, vérifiez si elle concerne uniquement un agent personnalisé, un sous-agent ou la compaction.
Cette erreur signifie-t-elle que j’utilise un client OpenCode non officiel ?
Non. Plusieurs utilisateurs ont rencontré exactement ce message dans OpenCode Desktop et dans la CLI officielle. Le contrôle destiné au free tier a également provoqué des faux positifs.
Faut-il modifier les fichiers ou la configuration de son projet ?
Pas nécessairement. Le bug a été reproduit indépendamment des projets ouverts. Vérifiez d’abord la version d’OpenCode et testez une réinstallation propre avant de modifier votre dépôt.
Muse Spark 1.3 Free fonctionne-t-il encore dans OpenCode ?
Oui dans mon installation après réinstallation de la version récente d’OpenCode. Des tickets montrent toutefois que certaines requêtes liées aux agents personnalisés ou aux sessions peuvent encore être rejetées selon la version.
