Note de l’auteur : OpenCode 2.2.3 ajoute le fournisseur Claude Agent. Voici ce qui le distingue du plugin OAuth retiré en mars, comment le configurer en 3 étapes et les 5 limites à connaître avant de se lancer.
Le 30 octobre, OpenCode a publié sa version 2.2.3, qui intègre le fournisseur Claude Agent. Pour l’utiliser, il suffit d’installer Claude Code sur sa machine, d’exécuter une fois claude auth login, puis de sélectionner Claude Agent dans /connect d’OpenCode. Vous pouvez alors utiliser votre propre abonnement Claude pour accéder aux modèles Claude. Au 31 octobre, l’annonce officielle de @opencode avait été vue environ 510 000 fois.
Ce n’est pas le système OAuth retiré en mars. La nouvelle solution passe par le binaire officiel de Claude Code et le SDK Claude Agent. OpenCode ne lit ni ne stocke vos identifiants : les requêtes au modèle sont envoyées par le processus claude sur votre machine. L’équipe d’OpenCode affirme avoir obtenu l’autorisation d’Anthropic, mais Anthropic n’a pas publié d’annonce distincte.
Le développeur Chen Cheng (@chenchengpro) a décortiqué l’implémentation : au démarrage, tools: [] et settingSources: [] sont définis, et seuls les outils mcp__opencode__* sont autorisés. Comme le gestionnaire MCP n’a pas accès à tool_use_id, il faut passer par un hook PreToolUse qui ne peut en enregistrer qu’un à la fois. Résultat : les lectures de fichiers parallèles deviennent séquentielles. L’invite système reste celle intégrée à Claude Code. Selon lui, « le résultat sera forcément moins bon qu’en utilisant directement Claude Code ». Cet article présente la configuration en 3 étapes, 5 limites et les options à privilégier selon trois profils d’utilisateurs.
Précision : cet article s’appuie sur les notes de version d’OpenCode, le document de conception de la PR #58782, la documentation officielle de Claude Code et les retours de la communauté. Aucun test de bout en bout n’a été effectué.
Utiliser un abonnement Claude avec OpenCode : l’essentiel
En trois points : c’est possible, mais pas avec l’ancienne méthode, et il y a des compromis.
- Prérequis : OpenCode V2 en version 2.2.3 ou ultérieure ; Claude Code installé sur la même machine et connecté avec
claude auth login. - Comment ça marche : OpenCode utilise le Claude Agent SDK pour appeler le processus
claudesur votre machine. OpenCode n’implémente pas son propre système OAuth, ne lit aucun jeton et n’en stocke aucun. - Les compromis : les appels d’outils s’exécutent en série ; de nombreuses fonctions de Claude Code ne sont pas disponibles ; l’exécution est uniquement locale, sans prise en charge des environnements hébergés ou distants.
Un point à clarifier sur la gratuité : la version gratuite de Claude n’inclut pas Claude Code, donc cette méthode ne fonctionne pas avec elle. Il faut un abonnement Pro, Max, Ultra, Team ou Enterprise, ou un compte Console. Ce n’est pas non plus une utilisation gratuite et illimitée : votre consommation est déduite des limites de votre abonnement, sur 5 heures et par semaine. L’interface OpenCode affiche simplement $0, car les frais sont déjà couverts par l’abonnement.
Si vous n’avez pas d’abonnement ou si votre équipe a besoin d’un point d’accès partagé, vous pouvez utiliser une API facturée à l’usage. Par exemple, APIYI apiyi.com permet d’appeler les modèles Claude via une interface compatible avec OpenAI. Cette option n’est pas liée à une machine locale et n’est pas soumise aux limites d’un abonnement.
Pourquoi les abonnements Claude ont disparu d’OpenCode en mars avant de revenir en octobre
En 2026, quatre dates ont marqué cette affaire :
- 9 janvier : Anthropic durcit les restrictions applicables aux systèmes d’orchestration tiers. Le jour même, l’issue OpenCode #7410, « Broken Claude Max », signale des erreurs soudaines chez des utilisateurs de Claude Max.
- 20 février : des médias internationaux rapportent qu’Anthropic a modifié ses conditions pour interdire explicitement l’utilisation de jetons OAuth dans d’autres produits, y compris ceux construits avec l’Agent SDK.
- 19 mars : OpenCode fusionne la PR #18186, « anthropic legal requests », supprime le plugin intégré
opencode-anthropic-authet retire Anthropic de sa liste de fournisseurs. - 30 octobre : Claude fait son retour dans OpenCode 2.2.3 via Claude Agent. Le même jour, la version 2.2.4 ajoute une configuration guidée.
Le tournant apparaît dans le texte même des conditions. Dans l’archive Wayback du 21 février de la page de conformité juridique d’Anthropic, il était encore indiqué que l’utilisation des jetons OAuth des offres Free, Pro et Max dans tout autre produit, outil ou service, y compris l’Agent SDK, violait les conditions d’utilisation grand public. Dans l’archive du 30 septembre, cette phrase avait disparu et une exception avait été ajoutée : les utilisateurs finaux peuvent se connecter avec leur propre abonnement dans le binaire Claude Code non modifié, y compris lorsque Claude Code est hébergé par une plateforme. La page d’octobre conservait cette exception.
Claude Agent dans OpenCode a justement été conçu autour de cette exception. Dans les commentaires de la PR #58782, quelqu’un a demandé s’il y avait un risque de suspension de compte. L’auteur, Tarquinen, a répondu avoir obtenu l’autorisation d’Anthropic et respecter pleinement les conditions d’utilisation. Daniel Smolsky, membre d’OpenCode, a lui aussi publié « We got permission » sur X. Toutefois, au 31 octobre, aucune annonce distincte d’Anthropic à ce sujet n’avait été trouvée : l’autorisation reste donc, pour l’instant, une affirmation unilatérale d’OpenCode.
| Aspect | Plugin OAuth d’avant mars | Claude Agent d’octobre |
|---|---|---|
| Connexion | OpenCode utilise lui-même OAuth sur claude.ai pour obtenir un jeton | L’utilisateur exécute claude auth login dans Claude Code sur sa propre machine |
| Émission des requêtes | OpenCode appelle directement l’API Anthropic | Le processus local claude les émet via l’Agent SDK |
| Lecture ou stockage du jeton | Le plugin détient le jeton OAuth | Aucune lecture ni aucun stockage : /connect enregistre uniquement la méthode choisie |
| Position d’Anthropic | Interdiction explicite dans les conditions de février, retrait du plugin en mars | OpenCode affirme avoir obtenu une autorisation ; une exception a été ajoutée aux conditions en septembre, sans annonce distincte |
| Risque | Risque de suspension du compte et de retrait | Plus faible qu’en mars, mais les règles peuvent encore changer |
Il faut être clair sur les risques. Les conditions actuelles réservent à Anthropic le droit de les faire appliquer sans préavis et interdisent toujours aux tiers de collecter, stocker ou relayer les identifiants Claude. Pour vous connecter, retenez donc deux points : n’installez pas les anciens plugins OAuth qui circulent en ligne et ne confiez pas votre compte à une plateforme tierce pour qu’elle l’utilise à votre place.
Comment fonctionne l’agent Claude dans OpenCode : chaîne d’exécution et traitement séquentiel
La chaîne complète est la suivante : OpenCode → Claude Agent SDK → claude sur la machine locale → Anthropic. OpenCode ne s’intercale pas entre Claude Code et Anthropic et ne modifie pas les requêtes. Par défaut, l’exécutable claude est recherché dans le PATH. Vous pouvez aussi préciser son chemin avec la variable d’environnement OPENCODE_CLAUDE_PATH.
Au démarrage, plusieurs fonctions de Claude Code sont désactivées ou remplacées. On peut résumer le fonctionnement en trois désactivations, un remplacement et une exécution séquentielle :
- Désactivation des outils intégrés : avec
tools: [], les outils de lecture, d’écriture et Bash fournis par Claude Code ne sont pas utilisés. - Désactivation de la configuration utilisateur : avec
settingSources: [], ni~/.claudeni le dossier.claudedu projet ne sont lus. CLAUDE.md, les hooks, les skills et les serveurs MCP ne sont pas chargés non plus. - Autorisation des seuls outils OpenCode : seuls les outils dont le nom commence par
mcp__opencode__*sont autorisés. Si Claude appelle un outil portant un autre nom, il reçoitNo such tool availableet OpenCode n’exécute pas l’appel. - Remplacement de l’implémentation des outils : OpenCode expose ses propres outils dans un serveur MCP intégré au processus. Leur exécution passe par les fenêtres de demande d’autorisation d’OpenCode. L’invite système reste celle fournie par Claude Code, avec une phrase indiquant qu’il s’exécute dans opencode, à laquelle s’ajoutent l’invite de l’agent choisi et AGENTS.md.
- Exécution séquentielle des outils : le gestionnaire d’outils d’OpenCode n’a pas accès au
tool_use_idde Claude. Le hookPreToolUsedoit donc d’abord l’enregistrer pour qu’il puisse ensuite être récupéré. Comme le hook ne peut enregistrer qu’un seul ID à la fois, les outils ne peuvent pas être déclarés comme exécutables en parallèle. Ainsi, lorsque Claude lirait normalement plusieurs fichiers en même temps, il les lit ici un par un.
Cette conception a ses raisons. Quel que soit le modèle qui génère le contenu, l’historique des sessions garde le même format, ce qui évite les problèmes lorsqu’on change de modèle. Il n’y a aussi qu’un seul système d’autorisations pour l’ensemble. En contrepartie, Claude Code perd une bonne partie de ses capacités d’origine. Comme le résume Chen Cheng : « Avec tout ça, j’ai l’impression que le résultat sera forcément moins bon qu’en utilisant directement Claude Code. » C’est un point à prendre en compte avant de décider de l’intégrer ou non.
Quelques détails supplémentaires sur le fonctionnement : chaque session lance un processus claude qui reste actif, s’arrête après cinq minutes d’inactivité et reprend à l’arrivée du message suivant. Les requêtes qui échouent sont relancées par Claude Code lui-même ; OpenCode ne les relance pas une deuxième fois.
Connecter OpenCode à un abonnement Claude en 3 étapes
Avant de commencer, vérifiez ces 5 prérequis :
- OpenCode est en version V2 2.2.3 ou ultérieure, et non en V1.
- Claude Code est installé sur votre machine.
- Votre compte Claude dispose d’un forfait payant, ou vous avez un compte Console.
- OpenCode et Claude Code sont sur la même machine.
- Vous n’utilisez ni hosted opencode ni remote workspace.
Pour installer la V2, utilisez la commande curl -fsSL https://opencode.ai/v2/install | bash. Vous pouvez aussi télécharger la version de bureau.
Étape 1 : installer Claude Code
Ce que vous verrez : exécutez claude --version dans le terminal. Si la commande est introuvable, Claude Code n’est pas encore installé.
Que faire : sur macOS et Linux, installez-le avec le script officiel install.sh. Sous Windows, exécutez le script officiel install.ps1 dans PowerShell. Si Claude Code est déjà installé mais que sa version est ancienne, lancez claude update pour le mettre à jour.
Comment vérifier : claude --version doit afficher un numéro de version.
Étape 2 : se connecter à son compte Claude
Ce que vous verrez : après avoir exécuté claude auth login, le navigateur ouvre la page de connexion d’Anthropic.
Que faire : connectez-vous avec votre compte Claude payant, puis exécutez claude auth status pour vérifier l’état de la connexion.
Comment vérifier : la méthode d’authentification affichée doit correspondre à une connexion par abonnement, et non à api_key ou none.
Attention à un piège : si ANTHROPIC_API_KEY est défini dans votre shell, Claude Code peut utiliser la clé API en priorité et entraîner une facturation à l’usage. Avant de vous connecter, exécutez unset ANTHROPIC_API_KEY ; si Claude Code vous demande d’utiliser cette clé, refusez.
Étape 3 : connecter Claude Agent dans OpenCode
Ce que vous verrez : saisissez /connect dans OpenCode pour afficher la liste des fournisseurs.
Que faire : sélectionnez Claude Agent, et non « Anthropic ». Utilisez ensuite /models pour choisir un modèle Claude. À partir de la version 2.2.4, un parcours guidé vous aide à copier la commande de connexion, vérifie l’installation et teste la connexion avant de passer au choix du modèle. Si vous préférez la ligne de commande, vous pouvez aussi utiliser opencode auth login pour effectuer la même opération.
Comment vérifier : vous pouvez sélectionner un modèle Claude dans la liste, recevoir une réponse à une invite de test et voir apparaître normalement la fenêtre d’autorisation d’OpenCode lors de l’utilisation d’un outil.
Dépannage
- Claude Agent est absent de la liste : exécutez
opencode --versionpour vérifier la version. Si elle est antérieure à 2.2.3, mettez OpenCode à jour et vérifiez que vous avez bien installé la V2. - La commande claude est introuvable : vérifiez le
PATHou utilisezOPENCODE_CLAUDE_PATHpour indiquer le chemin absolu versclaude. - Retour répété à la page de connexion : certains utilisateurs des premières versions ont signalé une déconnexion après une ou deux utilisations, suivie d’un retour à la page de connexion lors de la reconnexion. La communauté travaille encore sur le correctif. En attendant, relancez
claude auth logindans le terminal, puis revenez à/connect. - Un message indique que la limite du forfait est atteinte : le quota de 5 heures ou le quota hebdomadaire de l’abonnement est épuisé. Il faut attendre sa réinitialisation.
- Impossible de se connecter depuis un environnement distant : ce cas n’est pas pris en charge. La connexion fonctionne uniquement sur la machine locale.
Enfin, la documentation des fournisseurs d’OpenCode V1 contient encore un ancien avertissement indiquant qu’Anthropic interdit les comptes Pro/Max. Cette information date d’avant mars. Inutile de chercher Claude Agent avec /connect dans la V1 : il est disponible uniquement dans la V2.
Les 5 limites de l’utilisation d’un abonnement Claude avec OpenCode
| Limite | Ce que cela implique | Les plus concernés |
|---|---|---|
| Outils exécutés en série | Le hook ne gère qu’un seul tool_use_id à la fois : les fichiers sont lus les uns après les autres |
Grands dépôts, refactorisation sur plusieurs fichiers |
| L’invite n’est pas celle d’OpenCode | L’invite système utilisée est celle de Claude Code ; l’invite intégrée d’OpenCode ne s’applique pas | Personnes qui comptent sur le comportement par défaut des agents OpenCode |
| Fonctionnalités de Claude Code absentes | Pas de /usage, de mode auto, de mémoire, de sessions cloud, d’équipes d’agents, etc. |
Utilisateurs intensifs de Claude Code |
| Utilisation uniquement en local | Les modes hébergé et distant ne sont pas pris en charge ; claude doit être sur la même machine |
Développement cloud, équipes à distance, CI |
| Paramètres et plugins limités | Les paramètres temperature, top-p, seed, stop, etc. ne sont pas pris en charge ; le hook http.request ne s’exécute pas |
Personnes qui ont besoin d’un réglage précis ou d’une passerelle |
Outils exécutés en série : sur un petit projet, la différence est peu perceptible. Mais si une tâche nécessite de parcourir des dizaines de fichiers, l’attente s’allonge nettement. Si vous faites souvent des refactorisations de grande ampleur, tenez compte de ce temps supplémentaire.
L’invite n’est pas celle d’OpenCode : les invites d’agent personnalisées fonctionnent toujours, mais l’invite de base est celle de Claude Code. Si vous êtes habitué au comportement des agents intégrés d’OpenCode, vous pourriez remarquer un changement dans le style du modèle après la transition.
Fonctionnalités absentes : c’est la limite qui a le plus d’impact. Le document de conception énumère les fonctionnalités présentes dans Claude Code mais absentes ici dans OpenCode : le mode auto, ultracode, la mémoire automatique, les résumés d’absence, les sessions cloud, /teleport, les équipes d’agents, /loop, l’utilisation d’un ordinateur, Bash en bac à sable, l’édition de notebooks, ainsi que les compétences intégrées comme /simplify et /verify.
Utilisation uniquement en local : le processus Claude s’arrête après 5 minutes d’inactivité, puis redémarre au message suivant. Cette approche ne fonctionne pas dans un environnement CI ou sur une machine de développement distante.
Paramètres et plugins limités : aucun paramètre d’échantillonnage n’est pris en charge. L’URL de base et les en-têtes ne peuvent être lus que depuis le fichier de configuration : les plugins ne peuvent pas les modifier pour chaque requête. Les hooks http.request et http.response ne s’exécutent pas non plus, car les requêtes sont envoyées par Claude Code.
Quelques points à surveiller côté consommation : la commande /usage de Claude n’est pas accessible dans OpenCode ; une fois la limite atteinte, l’utilisation ne reprend pas automatiquement ; et il n’est pas possible d’acheter de l’usage supplémentaire ici. La commande /usage d’OpenCode affiche la consommation d’OpenCode Console, sans rapport avec le quota de votre abonnement Claude. On entend aussi dire que les utilisateurs de claude -p et du SDK bénéficient d’un quota d’abonnement inférieur à celui d’une utilisation normale de Claude Code. Mais le document de conception précise que cette affirmation n’a « pas été vérifiée » : on ne peut donc pas la considérer comme un fait.
En résumé : si vous avez besoin du mode auto, de la mémoire, des sessions cloud, des équipes d’agents, de l’utilisation d’un ordinateur ou de l’édition de notebooks, utilisez directement Claude Code. Cette solution vaut la peine seulement si vous voulez associer le modèle Claude aux outils et au système d’autorisations d’OpenCode, et que l’exécution des outils en série vous convient.
Utiliser un abonnement Claude avec OpenCode : pour qui, et pour qui ce n’est pas adapté
On peut distinguer trois cas :
- Vous utilisez déjà OpenCode 2.x, vous avez un abonnement Claude et vous codez uniquement sur votre machine : ça vaut le coup d’essayer. Vous pouvez passer de Claude à d’autres modèles dans le même environnement, sans payer séparément pour l’API.
- Vous utilisez uniquement Claude Code : ne vous compliquez pas la vie. Restez sur Claude Code : les fonctionnalités sont plus complètes, les outils peuvent s’exécuter en parallèle et les invites sont celles d’origine.
- Vous travaillez en équipe, en CI ou à distance, ou vous dépendez du mode auto, de la mémoire ou du tableau de bord des quotas : passez votre chemin. Cette solution ne fonctionne que sur la machine locale, certaines fonctionnalités manquent et la facturation n’est pas transparente. Une clé API ou la facturation à l’usage d’APIYI apiyi.com sera plus adaptée.
| Solution | Prix (au 27 octobre) | Pour qui |
|---|---|---|
| Claude Pro | 20 $/mois | Usage individuel léger, avec des limites sur 5 heures et par semaine |
| Claude Max / Ultra | 100 $ / 200 $ par mois | Usage individuel intensif |
| Client OpenCode | Gratuit et open source | Tout le monde |
| OpenCode Go (facultatif) | 10 $/mois | Personnes ayant besoin de modèles hébergés par OpenCode ; non requis pour utiliser Claude Agent |
| APIYI Claude Opus 5.5 | Entrée : 4 $ / sortie : 20 $ | Usage partagé en équipe, CI, besoin d’une facturation claire |
| APIYI Claude Sonnet 5.5 / Haiku 5.5 | 2 $/10 $, 0,1 $/0,5 $ | Codage quotidien, tâches par lots |
Dans ce tableau, les prix APIYI sont indiqués par million de tokens. La lecture du cache est facturée séparément.
💰 Conseil pour la facturation à l’usage : si vous n’avez pas d’abonnement, si vous travaillez en équipe ou si vous voulez suivre précisément chaque dépense, vous pouvez utiliser APIYI apiyi.com. Le service propose à la fois le point de terminaison
messages(format natif Anthropic) et le point de terminaisonchat(format compatible OpenAI). Renseignezhttps://api.apiyi.com/v1comme base_url. Consultez la liste des modèles de la plateforme pour connaître les modèles et les tarifs à jour.
Questions fréquentes (FAQ)
Q1 : Utiliser un abonnement Claude avec OpenCode peut-il entraîner un bannissement ?
Le risque est plus faible qu’en mars : la nouvelle méthode utilise le binaire officiel, OpenCode ne lit pas le token et elle respecte l’exception ajoutée aux conditions en septembre. Mais c’est OpenCode qui affirme avoir obtenu une autorisation : Anthropic n’a pas fait d’annonce distincte et se réserve le droit de faire appliquer ses règles sans préavis. N’utilisez pas les anciens plugins OAuth.
Q2 : Pourquoi ne trouve-t-on pas Claude Agent dans /connect ?
C’est généralement un problème de version : soit elle est antérieure à la 2.2.3, soit vous utilisez encore la V1. Après avoir installé la dernière version de la V2, cherchez « Claude Agent » dans `/connect`, et non « Anthropic ».
Q3 : OpenCode affiche un coût de 0 $. Est-ce vraiment gratuit ?
Non. L’affichage de 0 $ signifie simplement que le coût est couvert par votre abonnement. Votre utilisation est toujours décomptée de vos quotas sur 5 heures et hebdomadaire. Si vous utilisez une clé API, OpenCode affiche le coût selon les tarifs indiqués sur models.dev.
Q4 : Peut-on l’utiliser sur une machine de développement distante ou dans le cloud ?
Non. `claude` doit être installé sur la même machine qu’OpenCode : les espaces de travail hébergés et distants ne sont pas pris en charge. Pour le cloud ou la CI, utilisez plutôt une clé API ou effectuez des appels facturés à l’usage via APIYI, sur apiyi.com.
Q5 : Comment choisir entre l’accès par abonnement et une clé API ?
L’accès par abonnement convient à une utilisation personnelle sur sa machine, à condition d’avoir déjà souscrit un abonnement. Une clé API n’est pas liée à une machine, peut être partagée entre plusieurs personnes, offre une facturation claire et n’est pas soumise aux limites de l’abonnement. Pour comparer Claude à d’autres modèles, APIYI, sur apiyi.com, permet de passer de l’un à l’autre avec une seule clé.
Q6 : Peut-on utiliser la version gratuite de Claude ?
Non. La version gratuite n’inclut pas Claude Code. Il faut au minimum un abonnement Pro ou un compte Team, Enterprise ou Console.
En résumé : utiliser un abonnement Claude avec OpenCode en 3 phrases
C’est possible : à partir de la version 2.2.3, OpenCode utilise le SDK Agent officiel pour invoquer claude en local ; OpenCode indique avoir obtenu l’autorisation d’Anthropic, mais cette politique peut encore changer. Comment faire : installez d’abord Claude Code, exécutez claude auth login, puis sélectionnez Claude Agent dans /connect. Quand choisir une autre solution : si vous avez besoin d’outils en parallèle, de toutes les fonctionnalités de Claude Code ou d’un accès à distance ou en équipe, utilisez directement Claude Code ou faites appel à Claude à l’usage via APIYI apiyi.com.
Auteur : équipe technique APIYI
Échanges techniques : pour toute question sur l’intégration des modèles Claude, contactez-nous depuis la page d’accueil d’APIYI apiyi.com. Vous trouverez plus de documentation sur docs.apiyi.com.
