OpenCode + Claude : connexion par abonnement Claude Agent ou API Key, quelle voie choisir (2.2.3+)

OpenCode 2.2.3 ajoute un provider Claude Agent intégré. Installez Claude Code 2.1.248+, lancez claude auth login, puis choisissez Claude Agent dans /connect pour utiliser votre connexion Claude Code et ses modèles. L'autre voie est le provider Anthropic avec un baseURL et une API Key. Ce guide compare les deux, détaille chaque configuration, explique comment passer de CLAUDE.md à AGENTS.md, liste les erreurs courantes et montre la sortie réelle de la voie API Key.

9 分钟阅读
OpenCode + Claude : connexion par abonnement Claude Agent ou API Key, quelle voie choisir (2.2.3+)

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 un baseURL et une Key pour le provider anthropic dans opencode.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)
VersionsOpenCode 2.2.3+, Claude Code 2.1.248+ installé en localToute version d'OpenCode
Connexionclaude auth login dans un terminalColler une API Key (ou la lire depuis une variable d'environnement)
Qui envoie les requêtesVotre programme claude local, via le Claude Agent SDK officielOpenCode lui-même
Outils, permissions, historiqueTout côté OpenCodeTout côté OpenCode
CLAUDE.mdLe chargement de CLAUDE.md par Claude Code est désactivé ; les règles passent par AGENTS.mdChargement des règles d'OpenCode (AGENTS.md d'abord)
Espaces de travail distants / hébergésNon pris en charge ; claude doit tourner sur la même machinePris en charge
Température et autres paramètres d'échantillonnageNon pris en chargePris 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

bash
opencode --version   # 2.2.3+
claude --version     # 2.1.248+

Mettre à jour si besoin :

bash
# 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

bash
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

text
/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 :

bash
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 ~/.claude et du dossier .claude du 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 : /usage du forfait Claude, sessions cloud et /teleport, /loop, auto mode, computer use, entre autres. /usage dans OpenCode affiche l'usage d'OpenCode Console.
  • Chaque session garde un processus claude permanent. 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

bash
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 :

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 baseURL d'OpenCode inclut /v1 : https://api.aicodewith.ai/v1. Claude Code est différent : son ANTHROPIC_BASE_URL est https://api.aicodewith.ai, sans /v1.
  • apiKey lit {env:AICODEWITH_API_KEY} dans l'environnement : la Key n'atterrit ni dans les fichiers du projet ni dans git.
  • Vous pouvez aussi omettre apiKey et coller la Key via /connect → Anthropic.
  • /models liste les modèles Claude disponibles ; écrivez model sous la forme anthropic/<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 :

python
# 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 :

bash
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 :

text
> 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é :

python
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.md passe 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 :

bash
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 :

text
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 :

text
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.

Sources

相关文章

C'est quoi le UI SDK, et comment l'utiliser ? La bibliothèque de comportements Vercel et shadcn pour les agents, installée et testée dans Claude Code / Codex / Cursor (0.1.0-beta.1)

C'est quoi le UI SDK, et comment l'utiliser ? La bibliothèque de comportements Vercel et shadcn pour les agents, installée et testée dans Claude Code / Codex / Cursor (0.1.0-beta.1)

Le UI SDK est la bibliothèque de comportements de Vercel pour les agents, publiée le 12 novembre 2026 en version 0.1.0-beta.1. Les comportements vivent dans le paquet indépendant du framework @ui-sdk/core, puis sont rendus par les adaptateurs React, Vue, Svelte, Solid et Web Components. Ce guide suit la documentation officielle sur ce que c'est, comment l'installer et comment ajouter le skill pour Claude Code, Codex et Cursor, et consigne les commandes, durées et sorties relevées sur notre machine de test.

AWS Emulator, c'est quoi et comment l'installer ? Tester des applications AWS en local avec Claude Code et Codex (testé sur 1.0.322)

AWS Emulator, c'est quoi et comment l'installer ? Tester des applications AWS en local avec Claude Code et Codex (testé sur 1.0.322)

AWS Emulator est l'émulateur local officiel des API AWS, disponible en version GA depuis le 11 novembre 2026 (heure des États-Unis). Il n'entraîne aucuns frais de service supplémentaires, son code source est ouvert, il ne demande aucun compte AWS et couvre plus de 200 services. Nous avons testé la version 1.0.322 sous Debian 13 : commandes d'installation, AWS CLI pointé vers l'endpoint local pour créer un bucket S3 et une table DynamoDB, erreurs rencontrées, et comment laisser Claude Code, Codex et Cursor écrire et tester du code contre l'émulateur.

T3 Code, c'est quoi et comment l'installer ? Connecter Claude Code et Codex, utiliser une clé API tierce, corriger les erreurs courantes (testé sur 0.1.9)

T3 Code, c'est quoi et comment l'installer ? Connecter Claude Code et Codex, utiliser une clé API tierce, corriger les erreurs courantes (testé sur 0.1.9)

T3 Code est la console open source de pingdotgg pour piloter des agents de code. Elle n'embarque aucun modèle et pilote les CLI Claude Code, Codex, Cursor et autres déjà installés sur votre machine. Nous avons testé T3 Code 0.1.9 sous Linux. Ce guide couvre les commandes d'installation, la configuration de Claude Code et de Codex avec une clé API AICodeWith pour que T3 Code les pilote, un essai complet des deux agents avec la commande t3 thread, puis les erreurs rencontrées et leurs solutions.