# Claude Code

Connectez Claude Code à l'aide de la Skill autonome XMemo comme chemin recommandé, avec MCP direct comme alternative prise en charge.

- Canonical: https://docs.xmemo.dev/fr/docs/mcp/claude-code
- Locale: fr-FR
- Content-Locale: fr-FR
- Canonical-Content-Digest: 5edeeceeddc0cef8d2d6e339fda7faaccf26ce601200bc11845b78bb698132cd
- Edition-Digest: 1d44eba88256ef8c5dde52888cc6f2447a822f3e0fe15a52b1977634605a2733
- Source-Revision: sha256:288082ef3586e3b1f3c2f1a2efb1500c46b876aa3b4c51604bd280c04fc27027

## Prérequis

Utilisez Claude Code CLI (claude) dans votre terminal local. Environnements d'exécution et prérequis :

- Interface concrète : Claude Code CLI (claude).
- Exigence d'exécution : Node.js version 22.22.0 ou supérieure pour le lanceur de Skill autonome.
- Compte : Compte XMemo valide sur https://xmemo.dev.
- Prérequis MCP alternatif : Prise en charge du transport Streamable HTTP avec jeton porteur dans l'environnement local.

## Installation / configuration

Le chemin recommandé installe la Skill autonome XMemo dans le répertoire skills de Claude Code à l'aide de l'invite sélectionnée par le propriétaire. Demandez à votre agent dans Claude Code d'exécuter l'installation :

- Invite : Install the standalone XMemo Skill into your skills directory: run the installer from https://xmemo.dev/skill/install (on Windows, https://xmemo.dev/skill/install.ps1) with XMEMO_SKILL_DIR set to your skills directory plus /xmemo-memory. Run the doctor command it prints to verify the installation, then reload your skills and follow the Skill's first-run steps. Follow your normal safety checks and do not use elevated privileges.
- Chemin d'installation par défaut : ~/.claude/skills/xmemo-memory.
- Chemin alternatif : Enregistrez le MCP Streamable HTTP direct via claude mcp add ou .mcp.json avec https://xmemo.dev/mcp.

## Définir l'identifiant

Avant d'exécuter des commandes, configurez votre chemin de stockage d'identifiants. Préférez définir XMEMO_KEY depuis un coffre de secrets ou l'environnement shell local. Si vous utilisez la connexion interactive de l'appareil avec --allow-plaintext, notez que cet indicateur stocke l'identifiant non chiffré sur cet ordinateur :

```bash
export XMEMO_KEY='<your-xmemo-token>'
# Interactive alternative (stores credential unencrypted on this machine):
# node ~/.claude/skills/xmemo-memory/scripts/xmemo-skill.mjs login --allow-plaintext
```

## Générer / confirmer XMEMO_AGENT_INSTANCE_ID

Générez une valeur non secrète par installation locale de Claude Code, conservez-la en dehors de git et réutilisez-la d'une session à l'autre afin que l'attribution d'instance reste stable.

```bash
export XMEMO_AGENT_INSTANCE_ID='<stable-local-instance-id>'
# Persist and reuse this value for the same local install
```

## Conserver le bloc de configuration existant

Pour les environnements MCP directs, utilisez le bloc de configuration révisé de Claude Code. Conservez la référence de variable Authorization ; ne remplacez jamais l'espace réservé de jeton par un secret réel :

```json
{
  "mcpServers": {
    "xmemo": {
      "type": "http",
      "url": "https://xmemo.dev/mcp",
      "headers": {
        "Authorization": "Bearer ${XMEMO_KEY}"
      }
    }
  }
}
```

## Redémarrer le client

Redémarrez Claude Code après avoir modifié les variables d'environnement, les fichiers de configuration ou installé la Skill afin que tous les composants se chargent proprement en mémoire.

## Tester avec un véritable appel de rappel

Effectuez une première requête en lecture seule pour vérifier la connectivité avant d'écrire des données. Cette vérification ne modifie pas l'état de la mémoire.

```text
recall({ query: "connection check", limit: 1 })
```

## Réponse attendue (forme littérale)

Un appel réussi renvoie la forme de texte classé public ci-dessous ; la référence et le contenu sont de véritables valeurs issues de l'espace mémoire autorisé.

```text
### XMemo Memory Results:
1. Reference: <opaque-memory-id> | Location: <location>
   > <memory content>
```

## Première tâche utile : Cycle de vie de mémoire synthétique

Vérifiez la persistance de la mémoire, la transition de session sans état, le rappel attribué à la source et la correction :

- 1. Enregistrer un fait synthétique : node scripts/xmemo-skill.mjs remember --content "Demo project timestamps use UTC." --path "projects/demo-onboarding/conventions" (ou outil MCP remember).
- 2. Transition sans état : Ouvrez une nouvelle session de terminal Claude Code pour vérifier la persistance d'une session à l'autre.
- 3. Rappel avec attribution de source : node scripts/xmemo-skill.mjs recall --query "demo project timestamp format" (ou outil MCP recall). Vérifiez Reference et Location dans la sortie renvoyée.
- 4. Corriger la mémoire : node scripts/xmemo-skill.mjs update --id <active-memory-id> --content "Demo project timestamps use UTC with ISO 8601 formatting." (ou outil MCP update_memory).
- 5. Nettoyage optionnel : node scripts/xmemo-skill.mjs forget --id <active-memory-id> --confirm (ou outil MCP forget).

## Capacités et outils de profil

Claude Code a accès aux outils qualifiés par profil définis dans le contrat de documentation MCP pour les profils claude-plugin et claude-public :

- Outils de mémoire principaux : remember, recall, update_memory, forget, read_memory, explain_memory, search_memory, recall_context.
- Outils de projet et de contexte : get_mcp_identity, get_project_context, project, todo, update_state.
- Continuité de session : create_restart_snapshot, restore_restart_snapshot, record_event, create_pending_decision, resolve_decision.

## Limites et frontières

Frontières opérationnelles et contraintes pour Claude Code :

- Limite de l'espace de travail : L'accès à la mémoire est strictement confiné à l'espace de travail de l'utilisateur autorisé.
- Séparation bureau : La configuration de Claude Code CLI est indépendante des paramètres Claude Desktop Cowork.
- Claude sur claude.ai et Claude Desktop : connectez-vous via le connecteur personnalisé avec OAuth ; voir [Claude (claude.ai)](/docs/mcp/claude).
- Gestion des secrets : Ne validez jamais de jetons en texte brut dans git et ne collez pas de secrets dans les fichiers de configuration archivés.

## Erreurs courantes

Dépannez les problèmes courants de connexion et d'autorisation grâce à ces étapes :

- 401 invalid_token — XMEMO_KEY est manquant, expiré ou invalide : vérifiez le jeton d'environnement ou réexécutez la connexion sur l'appareil.
- 403 insufficient_scope — Le jeton ne dispose pas de la portée memory:read ou memory:write : émettez un jeton avec les autorisations requises.
- Mauvaise cible d'installation — Vérifiez que XMEMO_SKILL_DIR a été défini sur ~/.claude/skills/xmemo-memory.
- Rechargement de Skill requis — Quittez Claude Code (/exit) et relancez-le pour recharger les skills en mémoire.

## Mise à jour et suppression

Procédures de mise à jour ou de désinstallation de l'intégration :

- Mise à jour : Réexécutez l'invite de l'installateur pour récupérer la dernière version du package Skill.
- Suppression : Supprimez ~/.claude/skills/xmemo-memory, ou exécutez claude mcp remove xmemo pour supprimer la configuration directe de MCP.

## Claude Desktop

Stdio bridge: Claude Desktop uses mcp-remote to connect to hosted streamable-http with XMEMO_KEY from the environment. Run npx @xmemo/client mcp add claude-desktop to configure automatically.

```
{
  "mcpServers": {
    "XMemo": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://xmemo.dev/mcp",
        "--header",
        "Authorization:Bearer ${XMEMO_KEY}",
        "--header",
        "X-Memory-OS-Agent-ID:claude-desktop",
        "--header",
        "X-Memory-OS-Agent-Instance-ID:${XMEMO_AGENT_INSTANCE_ID}"
      ],
      "env": {
        "XMEMO_AGENT_INSTANCE_ID": "${XMEMO_AGENT_INSTANCE_ID}"
      }
    }
  }
}
```