→ join waitlist

Utiliser votre abonnement Claude Pro/Max dans LibreChat

Guide 6 min read Updated May 2026 (Phase 9)

Cette page explique comment router les requêtes Claude depuis LibreChat à travers votre propre quota Claude Pro/Max au lieu de consommer la clé API de l'équipe. Tout passe par l'extension Chrome xbrain installée dans votre navigateur — qui détient déjà vos cookies claude.ai — et par le microservice session-bridge exposé sur bridge.grooveos.app.

Zone grise vis-à-vis des CGU Anthropic

Cette fonctionnalité automatise du trafic via votre abonnement Claude.ai personnel — ce qui est une grey-area au regard des Anthropic ToS (Terms of Service). Le risque de ban de votre compte Claude vous incombe entièrement. xbrain ne couvre pas cette responsabilité. Si vous préférez ne pas prendre ce risque, utilisez les endpoints "Anthropic" ou "Claude Reasoning" classiques (clé API team), pas "Claude (mon abonnement)".

Comment ça marche

Le chemin d'une requête, étape par étape :

  1. Dans LibreChat, vous choisissez l'endpoint "Claude (mon abonnement)" et collez votre xbt_ token comme API key.
  2. LibreChat envoie un POST /v1/chat/completions à bridge.grooveos.app avec votre Bearer token.
  3. Le service session-bridge valide le token contre memory-api, retrouve votre WebSocket persistante (ouverte par l'extension), et y pousse la requête.
  4. L'extension Chrome fait un fetch(api.claude.ai/.../completion, {credentials: 'include'}) — donc avec vos cookies claude.ai — et streame la réponse SSE chunk par chunk.
  5. Le bridge traduit le SSE claude.ai en SSE OpenAI-compat et le relaye à LibreChat, qui l'affiche progressivement.

Conséquence directe : la requête est facturée à votre quota Pro/Max (page claude.ai/settings/usage), pas à la clé API team. Le serveur xbrain ne voit jamais vos credentials Claude — ils restent dans vos cookies navigateur.

Mise en place (5 étapes)

1

Installer l'extension xbrain (Chrome)

Téléchargez le dossier chrome-extension/ depuis le repo xbrain (l'extension n'est pas publiée sur le Chrome Web Store). Ouvrez chrome://extensions/, activez le Mode développeur, cliquez Charger l'extension non empaquetée et sélectionnez le dossier. Vérifiez que la version est 1.1.0 ou supérieure (manifest requis pour le bridge WS).

2

Se connecter à xbrain

Ouvrez chat.grooveos.app, loggez-vous via Google. Votre xbt_ token (token API personnel scopé team) est automatiquement créé et stocké dans chrome.storage.session par l'extension. La WebSocket vers wss://bridge.grooveos.app/ws/{user_sub} s'ouvre dans la seconde — vous pouvez le vérifier dans les DevTools du service worker de l'extension.

3

Se connecter à claude.ai

Dans le même navigateur (sinon les cookies ne sont pas accessibles à l'extension), ouvrez claude.ai et loggez-vous avec votre compte Pro ou Max. L'extension vérifiera la présence du cookie de session — vous verrez un 🟢 dans la popup, section "Sessions".

Si vous utilisez plusieurs profils Chrome (perso vs pro), assurez-vous d'être sur le même profil pour xbrain ET claude.ai. Sinon l'extension verra 🔴 et LibreChat retournera l'erreur no_session.

4

Choisir l'endpoint dans LibreChat

Dans chat.grooveos.app, cliquez le sélecteur d'endpoint en haut. Vous devez voir "Claude (mon abonnement)" dans la liste (à côté des entrées Anthropic, OpenAI, xAI, Claude Reasoning existantes). Sélectionnez-le.

5

Coller votre xbt_ token comme API key

LibreChat va vous demander une API Key pour cet endpoint (BYOK pattern). Collez votre xbt_ token — celui de votre dashboard xbrain (Settings → API Tokens), pas une clé Anthropic. LibreChat l'enverra comme Authorization: Bearer xbt_... au bridge, qui le validera contre memory-api. 

xbt_a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4e5f6a1b2

Envoyez un premier message. La réponse arrive token par token (SSE streaming) — et apparaît dans votre dashboard claude.ai/settings/usage comme une conversation Pro/Max normale.

Limitations

Anthropic ToS & ban risk

Acheminer du trafic depuis un outil tiers (LibreChat → extension → claude.ai) en utilisant votre abonnement Pro/Max est une zone grise vis-à-vis des CGU Anthropic. Anthropic n'a pas publié de règle explicite contre ce pattern, mais leurs CGU interdisent l'usage "automated, scripted, or otherwise non-human" du service consommateur.

Le risque de ban de votre compte Claude personnel vous incombe entièrement. xbrain n'a pas de contrat avec Anthropic à ce sujet, ne peut pas garantir l'absence de sanctions, et ne couvre pas le coût de re-souscription si votre compte est suspendu. En activant le routing "Claude (mon abonnement)" vous acceptez ce risque.

Si vous préférez l'éviter, sélectionnez plutôt l'endpoint Anthropic dans LibreChat (clé API team officielle, sans grey-area).

Si CREDS_KEY ou BRIDGE_SHARED_SECRET est tournée

LibreChat chiffre les API keys que vous collez via user_provided (BYOK) avec sa clé CREDS_KEY côté serveur. Si l'admin tourne cette clé (incident de sécurité, rotation périodique, etc.), tous les xbt_ tokens stockés deviennent illisibles côté LibreChat.

Symptôme : vos messages "Claude (mon abonnement)" retournent 401 unauthorized au lieu de streamer.

Action requise : Re-aller dans LibreChat → endpoint "Claude (mon abonnement)" → re-coller votre xbt_ token comme API key (vous pouvez réutiliser le même — c'est uniquement le chiffrement côté LibreChat qui a changé, votre token reste valide).

De manière similaire, si l'admin tourne BRIDGE_SHARED_SECRET (le secret HS256 que session-bridge utilise pour signer ses appels memory-api), les WebSockets existantes peuvent rester ouvertes mais les nouveaux register handshakes échoueront silencieusement. Un rechargement de l'extension (chrome://extensions → reload) régénère la WS avec le nouveau secret côté serveur.

Cadence de casse estimée (~2-3 mois)

Anthropic peut changer le format interne de l'API api.claude.ai à tout moment — ce n'est pas une API publique versionnée. Quand ça arrive, l'extension cesse de fonctionner correctement (parsing SSE qui échoue, 404 sur l'URL, en-têtes nouveaux requis, etc.).

Sur la base de projets OSS similaires (par ex. claude-code-router), l'estimation est 2-3 mois entre événements de casse. Chaque casse demande 1-2 jours de dev xbrain pour patcher l'extension — mise à jour publiée sur GitHub puis rechargement manuel via chrome://extensions.

Pendant une période de casse : repassez sur l'endpoint Anthropic team (clé API officielle, jamais en panne), envoyez un message Discord/email pour signaler la rupture si elle n'a pas été détectée, et attendez le patch.

Troubleshooting

SymptômeCause probableSolution
LibreChat répond 503 no_session Extension non chargée OU WebSocket fermée OU vous n'êtes pas loggé sur xbrain dans ce navigateur Ouvrez chrome://extensions, rechargez la carte xbrain (↻), vérifiez la popup → Sessions → 🟢 active
Réponse vide / erreur "401 unauthorized" depuis claude.ai Cookie claude.ai expiré ou navigation privée Allez sur claude.ai, reloggez-vous, retournez sur LibreChat
Popup affiche 🔴 mais l'extension est bien chargée Pas de xbt_ token dans chrome.storage.session Ouvrez chat.grooveos.app, loggez-vous via Google — la WS s'ouvrira automatiquement
Erreur "anthropic-client-version required" ou format SSE inattendu Anthropic a changé le format interne (cadence ~2-3 mois) Repassez sur l'endpoint Anthropic team, signalez la casse à l'équipe xbrain, attendez le patch extension
Cloudflare 403 sur api.claude.ai Détection fingerprint navigateur (rare) Rechargez l'onglet claude.ai (un reload résout la grande majorité des cas), retentez
401 depuis LibreChat même avec un xbt_ token valide CREDS_KEY tournée côté serveur (voir section ci-dessus) Re-coller le xbt_ token dans LibreChat → endpoint "Claude (mon abonnement)" → API Key
Tout marche, mais le quota n'augmente pas sur claude.ai/settings/usage Vous êtes resté sur "Anthropic" classique au lieu de "Claude (mon abonnement)" Re-vérifier le sélecteur d'endpoint en haut de LibreChat

Pour signaler un bug ou demander de l'aide : ouvrez une issue sur github.com/mrboups/xbrain ou envoyez un mail à team@excalibur.game avec le label phase-9 / session-bridge.