claude-mem Configuration du backend personnalisé

Acheminez le travailleur d'arrière-plan claude-mem vers un backend compatible TokenHub Anthropic sans modifier les sessions Claude Code.

Créer une clé API TokenHub

Qu'est-ce que Claude-mem ?

claude-mem est un système de mémoire persistante qui exécute un travailleur en arrière-plan aux côtés de Claude Code et des outils de codage pris en charge.

Ce guide claude-mem écrit le point de terminaison personnalisé compatible Anthropic dans le fichier d'environnement spécifique au travailleur, épingle le modèle exact dans les paramètres et redémarre le travailleur afin que la configuration soit réellement chargée. Le travailleur lit son propre environnement et ses propres fichiers de paramètres, donc la modification d'une exportation de terminal ou de la configuration principale de Claude Code peut n'avoir aucun effet. Conservez les informations d'identification de la passerelle dans le fichier de travail documenté, sélectionnez un modèle compatible Anthropic, redémarrez le travail et comparez les journaux des travailleurs avec les requêtes TokenHub après le prochain cycle de traitement.

Le fournisseur claude de claude-mem envoie des requêtes via l'agent Claude SDK. Son flux officiel de backends personnalisés compatibles avec Anthropic ne modifie que le travailleur d'observation en arrière-plan ; cela ne change rien à la séance interactive Claude Code. Placez cette configuration dans le propre répertoire de claude-mem au lieu de vous fier aux exportations shell.

Étape 1 : modifier ~/.claude-mem/.env

Pour une passerelle TokenHub Anthropic-compatible qui utilise un jeton Bearer, ajoutez :

ANTHROPIC_AUTH_TOKEN=YOUR_TOKENHUB_API_KEY
ANTHROPIC_BASE_URL=__API_BASE_URL__

Le guide officiel nécessite les autorisations 0600 sur ce fichier et 0700 sur son répertoire ; le travailleur applique également ces autorisations lors de sa prochaine écriture. L'agent Claude SDK lit directement ANTHROPIC_BASE_URL et claude-mem ne l'analyse ni ne le réécrit.

Ne comptez pas sur ANTHROPIC_BASE_URL dans le terminal actuel. claude-mem construit un environnement de travail isolé, le paramètre doit donc exister dans ~/.claude-mem/.env pour survivre à un redémarrage. Utilisez plutôt ANTHROPIC_API_KEY uniquement lorsqu'une passerelle requiert explicitement x-api-key plutôt que l'authentification du porteur.

Étape 2 : épingler le modèle de travail dans settings.json

Modifier ~/.claude-mem/settings.json :

{
  "CLAUDE_MEM_PROVIDER": "claude",
  "CLAUDE_MEM_MODEL": "YOUR_TOKENHUB_ANTHROPIC_MODEL_ID"
}

CLAUDE_MEM_MODEL est transmis sans modification au SDK. claude-mem ne traduit pas les alias et ne lit pas le ANTHROPIC_DEFAULT_HAIKU_MODEL de Claude Code, entrez donc l'ID de modèle Anthropic-compatible complet accepté par TokenHub.

Étape 3 : redémarrez avec les commandes officielles et inspectez les journaux

npm run worker:restart
npm run worker:logs

Attendez le prochain rinçage d'observation. Une exécution réussie enregistre d'abord SDK Starting SDK query, puis Response received. Les échecs de passerelle sont écrits dans worker-error.log ; claude-mem ne revient pas silencieusement au point de terminaison public d'Anthropic.

Dépanner la configuration du travailleur isolé

  • Claude Code utilise TokenHub mais pas claude-mem : ce sont des paramètres distincts ; inspectez ~/.claude-mem/.env et settings.json.
  • L'ancien URL reste après une modification : exécutez worker:restart ; rouvrir un terminal ne suffit pas.
  • Le modèle n'existe pas : CLAUDE_MEM_MODEL n'a pas de traduction d'alias, copiez donc à nouveau l'ID de modèle TokenHub.
  • Erreur d'authentification : utilisez ANTHROPIC_AUTH_TOKEN pour l'authentification du porteur TokenHub ; utilisez ANTHROPIC_API_KEY uniquement lorsque cela est explicitement requis.
  • Le point de terminaison TokenHub expose uniquement OpenAI Chat Completions : le fournisseur claude ne peut pas l'appeler directement ; placez un adaptateur de protocole Anthropic tel que LiteLLM entre les deux.

Référence officielle

Choisir un modèle

Charge de travailChoix du modèlePourquoi
Tâches complexesModèle de raisonnement avec outilsAdapté à la planification, aux étapes multiples et aux longs contextes.
Usage quotidienModèle équilibréÉquilibre qualité, vitesse et coût.
Résumés et tâches légèresModèle rapide et économiqueRéduit le coût des résumés et itérations simples.
Voir les modèles TokenHub

FAQ du backend personnalisé claude-mem

Est-ce que cela va changer ma séance Claude Code ?

Non, Claude-mem lit son propre environnement de travail, le remplacement est donc isolé des sessions interactives Claude Code.

Pourquoi utiliser ANTHROPIC_AUTH_TOKEN ?

Le guide du backend personnalisé claude-mem indique que les informations d'identification de la passerelle utilisent généralement ANTHROPIC_AUTH_TOKEN. Utilisez le format d’informations d’identification requis par votre point de terminaison TokenHub.

Puis-je utiliser un point de terminaison de modèle uniquement OpenAI ?

Pas directement avec le fournisseur Claude. Placez d'abord une passerelle compatible Anthropic telle que LiteLLM devant une passerelle en amont uniquement OpenAI.

Comment puis-je vérifier que le travailleur claude-mem utilise TokenHub ?

Redémarrez le travailleur, attendez le prochain cycle de traitement d'observation et comparez le journal du travailleur avec une requête Anthropic Messages dans les journaux TokenHub.

Pourquoi une exportation shell n'a-t-elle pas mis à jour claude-mem ?

Un travailleur en arrière-plan existant ne peut pas hériter du shell actuel. Conservez les valeurs dans ~/.claude-mem/.env et redémarrez le travailleur.

Références

Cette configuration s’appuie sur TokenHub et la documentation officielle ; dernière vérification : 2026-09-08。

Comparez les réglages et la compatibilité de modèles d’outils similaires.

LangChainOpenAI Compatible