En bref : depuis OpenCode 2.2.3, OpenCode intègre un provider appelé Claude Agent. Installez Claude Code (2.1.248 ou plus récent), lancez claude auth login dans un terminal, puis choisissez Claude Agent dans /connect : vous retrouvez votre connexion Claude Code et ses modèles dans OpenCode. Le post de @opencode qui l'annonce (« you can now use your claude subscription in OpenCode ») a dépassé 620 000 vues en une journée.
Ce n'est pas la seule voie. Il y a toujours eu deux façons d'utiliser Claude dans OpenCode :
- Connexion par abonnement :
/connect→ Claude Agent. L'usage est décompté sur votre compte Claude. - API Key :
/connect→ Anthropic, ou unbaseURLet une Key pour le provideranthropicdansopencode.json. L'usage est mesuré par Key.
Voici en quoi elles diffèrent, comment configurer chacune, et pourquoi votre CLAUDE.md semble ne plus marcher après le changement.
Créer une API Key et l'utiliser dans OpenCode, Claude Code, Codex et Cursor →
Les deux voies côte à côte
| Claude Agent (abonnement) | Anthropic (API Key) | |
|---|---|---|
| Versions | OpenCode 2.2.3+, Claude Code 2.1.248+ installé en local | Toute version d'OpenCode |
| Connexion | claude auth login dans un terminal | Coller une API Key (ou la lire depuis une variable d'environnement) |
| Qui envoie les requêtes | Votre programme claude local, via le Claude Agent SDK officiel | OpenCode lui-même |
| Outils, permissions, historique | Tout côté OpenCode | Tout côté OpenCode |
| CLAUDE.md | Le chargement de CLAUDE.md par Claude Code est désactivé ; les règles passent par AGENTS.md | Chargement des règles d'OpenCode (AGENTS.md d'abord) |
| Espaces de travail distants / hébergés | Non pris en charge ; claude doit tourner sur la même machine | Pris en charge |
| Température et autres paramètres d'échantillonnage | Non pris en charge | Pris en charge |
Tout ce tableau vient du document de conception claude-agent-provider.md et de la PR #58782 du dépôt OpenCode.
Laquelle choisir :
- Vous avez déjà un forfait Claude et n'utilisez OpenCode que sur votre ordinateur : Claude Agent.
- Vous lancez OpenCode sur des serveurs, des espaces distants ou en CI, ou vous voulez qu'OpenCode, Claude Code, Codex et Cursor partagent une seule Key avec un seul endroit où consulter l'historique d'appels : API Key.
- Vous pouvez configurer les deux et basculer dans
/models. Selon le document de conception, l'historique d'OpenCode fait foi : quand vous revenez à Claude Agent, tout ce qu'il n'a pas vu lui est envoyé en un seul message.
Voie 1 : connexion par abonnement avec Claude Agent (OpenCode 2.2.3+)
Étape 1 : vérifier les versions
opencode --version # 2.2.3+
claude --version # 2.1.248+
Mettre à jour si besoin :
# OpenCode
opencode upgrade
# or: curl -fsSL https://opencode.ai/v2/install | bash
# or: npm i -g @opencode/cli@latest
# Claude Code
claude update
# or: curl -fsSL https://claude.ai/install.sh | bash
Claude Code doit être en 2.1.248 ou plus. Selon le document de conception, OpenCode demande à Claude Code de ne pas ajouter le contexte qu'il insère à chaque tour (CLAUDE.md imbriqués, listes de skills, rappels), une option qui n'existe qu'à partir de la 2.1.248.
Étape 2 : se connecter à Claude Code dans un terminal
claude auth login
claude --version
opencode
Lancez claude auth login dans un terminal, pas /login dans Claude Code. Les notes de version 2.2.4 ont justement remplacé une indication /login trompeuse par claude auth login.
Selon le document de conception, OpenCode ne lit jamais la connexion enregistrée par Claude Code. /connect note seulement que vous avez choisi cette méthode, et c'est votre claude local qui envoie les requêtes. Toute connexion acceptée par claude fonctionne : abonnement, API key ou compte cloud.
Étape 3 : /connect dans OpenCode, puis Claude Agent
/connect
→ Claude Agent (Claude Code login)
→ Anthropic (API Key)
/models
Choisissez Claude Agent, pas Anthropic. Anthropic est l'entrée API Key et n'affiche qu'un champ pour saisir une Key. Depuis la 2.2.4, choisir Claude Agent lance une configuration guidée : copier la commande claude auth login, installer Claude Code, vérifier la connexion, puis choisir un modèle. Dans l'application de bureau, c'est aussi là qu'on se sort de l'état Needs sign-in.
Si claude n'est pas dans votre PATH, ou si plusieurs versions sont installées, indiquez la bonne :
export OPENCODE_CLAUDE_PATH="$HOME/.local/bin/claude"
opencode
Ce qui change après le passage
Selon le document de conception :
- Les outils intégrés de Claude Code sont désactivés. Claude utilise les outils d'OpenCode, et chaque appel passe par les demandes de permission d'OpenCode. Il n'y a qu'un seul système de permissions.
- La configuration de Claude Code n'est pas lue : réglages de
~/.claudeet du dossier.claudedu projet, fichiers CLAUDE.md, hooks, serveurs MCP et skills sont désactivés ; OpenCode utilise les siens. La compaction automatique et la mémoire automatique aussi ; OpenCode gère la compaction. - Le prompt système est celui de Claude Code, plus les instructions d'OpenCode : AGENTS.md, skills, instructions MCP, prompt de l'agent choisi, etc.
- Non pris en charge :
/usagedu forfait Claude, sessions cloud et/teleport,/loop, auto mode, computer use, entre autres./usagedans OpenCode affiche l'usage d'OpenCode Console. - Chaque session garde un processus
claudepermanent. Il s'arrête après 5 minutes d'inactivité, et le message suivant reprend la session Claude enregistrée.
La question des conditions d'utilisation
Sous l'annonce, beaucoup demandent si cela enfreint les conditions d'Anthropic :
- La page de présentation officielle du Claude Agent SDK indique que, sauf approbation préalable, Anthropic n'autorise pas les développeurs tiers à proposer la connexion claude.ai ou les limites de forfait dans leurs produits, y compris les agents construits sur le Claude Agent SDK, et renvoie vers l'authentification par API key.
- Le document de conception d'OpenCode pose lui-même la question, dans « Open Questions », d'un échange ou d'une approbation avec Anthropic.
- D'après @grok, Anthropic n'a ni confirmé ni approuvé publiquement cet usage ; d'après @schulzfel, il repose sur le SDK Agent officiel ; d'après @jimmyyangrz, comme il dépend de la connexion Claude, c'est bien pour tester mais risqué pour bâtir un flux de travail.
À la publication, Anthropic ne s'est pas exprimé publiquement sur ce provider. Pour les risques de compte liés aux connexions par abonnement, voir Pourquoi des comptes Claude sont bannis et comment passer Claude Code à une API Key.
Voie 2 : provider Anthropic + API Key
Cette voie n'a pas besoin de Claude Code ; OpenCode envoie les requêtes directement. Voici la configuration avec une Key AICodeWith.
Étape 1 : mettre la Key dans une variable d'environnement
export AICODEWITH_API_KEY="VOTRE_API_KEY"
Étape 2 : renseigner baseURL dans opencode.json
opencode.json à la racine du projet, ou le fichier global ~/.config/opencode/opencode.json :
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"anthropic": {
"options": {
"baseURL": "https://api.aicodewith.ai/v1",
"apiKey": "{env:AICODEWITH_API_KEY}"
}
}
},
"model": "anthropic/claude-sonnet-5-5"
}
À retenir :
- Le
baseURLd'OpenCode inclut/v1:https://api.aicodewith.ai/v1. Claude Code est différent : sonANTHROPIC_BASE_URLesthttps://api.aicodewith.ai, sans/v1. apiKeylit{env:AICODEWITH_API_KEY}dans l'environnement : la Key n'atterrit ni dans les fichiers du projet ni dans git.- Vous pouvez aussi omettre
apiKeyet coller la Key via/connect→ Anthropic. /modelsliste les modèles Claude disponibles ; écrivezmodelsous la formeanthropic/<id du modèle>.
Pour séparer Keys et adresses quand plusieurs clients partagent un compte, voir Configuration multi-outils Codex, OpenCode et WorkBuddy. Côté Claude Code, voir Connecter Claude Code à une API tierce.
Test : OpenCode 2.2.5 corrige un petit bug avec une Key AICodeWith
Nous avons installé OpenCode 2.2.5 sur une machine Linux, avec la configuration ci-dessus, et lui avons demandé de corriger une fonction slugify. Le projet contenait un AGENTS.md demandant de lancer les tests après chaque modification d'un fichier .py :
# slug.py
def slugify(title):
return title.lower().replace(" ", "-")
# test_slug.py
def test_basic(self): self.assertEqual(slugify("Hello World"), "hello-world")
def test_punct(self): self.assertEqual(slugify("OpenCode + Claude: Setup!"), "opencode-claude-setup")
def test_spaces(self): self.assertEqual(slugify(" a b "), "a-b")
Commande :
opencode run -m anthropic/claude-sonnet-5-5 \
"Fix slugify in slug.py so all tests in test_slug.py pass. Follow AGENTS.md. Reply with one short summary line."
Environ 11 secondes entre Entrée et la fin. OpenCode a lu les deux fichiers, réécrit slug.py, lancé les tests comme le demandait AGENTS.md, et les 3 tests passent. Sortie réelle :
> build · claude-sonnet-5-5
→ Read slug.py
→ Read test_slug.py
← Write slug.py
Wrote file successfully: slug.py
$ python3 -m unittest 2>&1 | tail -5
...
Ran 3 tests in 0.000s
OK
I rewrote `slugify` in `slug.py` to turn each run of non-alphanumeric characters into one hyphen and strip hyphens from both ends, and `python3 -m unittest` now passes all 3 tests.
Le code corrigé :
import re
def slugify(title):
# Collapse every run of non-alphanumeric characters into a single hyphen
return re.sub(r"[^a-z0-9]+", "-", title.lower()).strip("-")
Nous n'avons pas de compte avec abonnement Claude pour tester, donc les étapes de la voie 1 suivent les notes de version et le document de conception d'OpenCode.
Créer une API Key et lancer vous-même l'opencode.json ci-dessus →
Passer de CLAUDE.md à AGENTS.md
Avec Claude Agent, le chargement de CLAUDE.md par Claude Code est désactivé : les règles du projet doivent passer par OpenCode. Ordre des règles d'OpenCode (voir la doc Rules d'OpenCode) :
- Si un projet a AGENTS.md et CLAUDE.md, seul AGENTS.md est utilisé.
- CLAUDE.md ne sert de repli que s'il n'y a pas d'AGENTS.md.
- Le fichier global
~/.config/opencode/AGENTS.mdpasse avant~/.claude/CLAUDE.md.
Le plus simple : déplacer les règles dans AGENTS.md et laisser une ligne d'import dans CLAUDE.md, pour qu'OpenCode, Claude Code et Codex lisent le même fichier :
git mv CLAUDE.md AGENTS.md
printf '@AGENTS.md\n' > CLAUDE.md
git add AGENTS.md CLAUDE.md
Claude Code importe le contenu via @AGENTS.md. Pour une configuration partagée plus complète, voir Partager AGENTS.md entre Claude Code et Codex.
Erreurs courantes
/connect n'affiche qu'un champ pour l'API Key
Vous avez choisi Anthropic, l'entrée API Key. Pour la connexion par abonnement, revenez en arrière et choisissez Claude Agent. S'il n'apparaît pas, OpenCode est antérieur à la 2.2.3 : lancez opencode upgrade.
Claude Agent ne se connecte pas ou demande une connexion
Vérifiez dans l'ordre : claude --version en 2.1.248+ ; claude auth login lancé dans un terminal ; claude présent dans le PATH (sinon, réglez OPENCODE_CLAUDE_PATH). Le provider n'est pas disponible dans les espaces distants ni dans OpenCode hébergé.
« 不支持的请求路径 » (chemin de requête non pris en charge)
Sur la voie API Key, il manque /v1 au baseURL. En le réglant volontairement sur https://api.aicodewith.ai, voici ce que nous avons obtenu :
Error: 不支持的请求路径,请检查 API 地址是否正确
Remplacez-le par https://api.aicodewith.ai/v1.
« 请在请求中提供有效的 API Key » (aucune API Key valide)
{env:AICODEWITH_API_KEY} est vide, souvent parce que la variable a été exportée dans un autre terminal ou que son nom est mal orthographié. L'erreur obtenue après avoir vidé la variable :
Error: 请在请求中提供有效的 API Key。
Modifier CLAUDE.md n'a aucun effet
Si le projet a déjà un AGENTS.md, OpenCode n'utilise que celui-ci, et avec Claude Agent le chargement de CLAUDE.md par Claude Code est aussi désactivé. Déplacez les règles dans AGENTS.md comme ci-dessus.
Limite du forfait atteinte
Selon le document de conception, Claude Code relance lui-même les requêtes et OpenCode ne relance pas pour ce provider : l'erreur de limite s'affiche une fois. Attendez la réinitialisation, ou passez sur la voie API Key dans /models.



