# Claude Code

Conecte Claude Code utilizando la Skill independiente de XMemo como la ruta recomendada, con MCP directo como alternativa compatible.

- Canonical: https://docs.xmemo.dev/es/docs/mcp/claude-code
- Locale: es-ES
- Content-Locale: es-ES
- Canonical-Content-Digest: 5edeeceeddc0cef8d2d6e339fda7faaccf26ce601200bc11845b78bb698132cd
- Edition-Digest: 0f4e55cb8bd1163b590cd2448df5f85531e5e26ad12168588c13c2346cfc586e
- Source-Revision: sha256:288082ef3586e3b1f3c2f1a2efb1500c46b876aa3b4c51604bd280c04fc27027

## Requisitos previos

Utilice Claude Code CLI (claude) en su terminal local. Tiempos de ejecución y requisitos previos:

- Interfaz concreta: Claude Code CLI (claude).
- Requisito de tiempo de ejecución: Node.js versión 22.22.0 o superior para el ejecutor de Skill independiente.
- Cuenta: Cuenta válida de XMemo en https://xmemo.dev.
- Requisito previo alternativo de MCP: Soporte de transporte Streamable HTTP con token de portador en el entorno local.

## Instalación / configuración

La ruta recomendada instala la Skill independiente de XMemo en el directorio de skills de Claude Code utilizando el aviso seleccionado por el propietario. Pida a su agente en Claude Code que ejecute la instalación:

- Aviso: 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.
- Ruta de instalación predeterminada: ~/.claude/skills/xmemo-memory.
- Ruta alternativa: Registre MCP Streamable HTTP directo mediante claude mcp add o .mcp.json con https://xmemo.dev/mcp.

## Establecer la credencial

Antes de ejecutar comandos, configure su ruta de almacenamiento de credenciales. Prefiera establecer XMEMO_KEY desde un almacén de secretos o el entorno de shell local. Si utiliza inicio de sesión interactivo de dispositivo con --allow-plaintext, tenga en cuenta que esta bandera almacena credenciales sin cifrar en este equipo:

```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
```

## Generar / confirmar XMEMO_AGENT_INSTANCE_ID

Genere un valor no secreto por instalación local de Claude Code, consérvelo fuera de git y reutilícelo en todas las sesiones para que la atribución de la instancia permanezca estable.

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

## Conservar el bloque de configuración existente

Para entornos MCP directos, utilice el bloque de configuración revisado de Claude Code. Conserve la referencia de variable Authorization; nunca reemplace el marcador de posición del token con un secreto real:

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

## Reiniciar el cliente

Reinicie Claude Code después de cambiar variables de entorno, archivos de configuración o instalar la Skill para que todos los componentes se carguen limpiamente en la memoria.

## Probar con una llamada real de recall

Haga que la primera solicitud sea de solo lectura para verificar la conectividad antes de escribir datos. Esta comprobación no modifica el estado de la memoria.

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

## Respuesta esperada (forma literal)

Una llamada exitosa devuelve la forma de texto clasificado público a continuación; la referencia y el contenido son valores reales del espacio de memoria autorizado.

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

## Primera tarea útil: Ciclo de vida de memoria sintética

Verifique la persistencia de la memoria, la transición de sesión sin estado, el recall atribuido a la fuente y la corrección:

- 1. Guardar hecho sintético: node scripts/xmemo-skill.mjs remember --content "Demo project timestamps use UTC." --path "projects/demo-onboarding/conventions" (o herramienta MCP remember).
- 2. Transición sin estado: Abra una nueva sesión de terminal de Claude Code para verificar la persistencia entre sesiones.
- 3. Recall con atribución de origen: node scripts/xmemo-skill.mjs recall --query "demo project timestamp format" (o herramienta MCP recall). Verifique Reference y Location en la salida devuelta.
- 4. Corregir memoria: node scripts/xmemo-skill.mjs update --id <active-memory-id> --content "Demo project timestamps use UTC with ISO 8601 formatting." (o herramienta MCP update_memory).
- 5. Limpieza opcional: node scripts/xmemo-skill.mjs forget --id <active-memory-id> --confirm (o herramienta MCP forget).

## Capacidades y herramientas de perfil

Claude Code tiene acceso a herramientas calificadas por perfil definidas en el contrato de documentación de MCP para los perfiles claude-plugin y claude-public:

- Herramientas de memoria principales: remember, recall, update_memory, forget, read_memory, explain_memory, search_memory, recall_context.
- Herramientas de proyecto y contexto: get_mcp_identity, get_project_context, project, todo, update_state.
- Continuidad de sesión: create_restart_snapshot, restore_restart_snapshot, record_event, create_pending_decision, resolve_decision.

## Limitaciones y límites

Límites operativos y restricciones para Claude Code:

- Límite del espacio de trabajo: El acceso a la memoria está estrictamente confinado al espacio de trabajo del usuario autorizado.
- Separación de escritorio: La configuración de Claude Code CLI es independiente de la configuración de Claude Desktop Cowork.
- Claude en claude.ai y Claude Desktop: conéctese mediante el conector personalizado con OAuth; consulte [Claude (claude.ai)](/docs/mcp/claude).
- Manejo de secretos: Nunca confirme tokens en texto plano en git ni pegue secretos en archivos de configuración confirmados.

## Errores comunes

Solucione problemas comunes de conexión y autorización siguiendo estos pasos:

- 401 invalid_token — XMEMO_KEY falta, está vencido o no es válido: verifique el token del entorno o vuelva a ejecutar el inicio de sesión del dispositivo.
- 403 insufficient_scope — El token carece del ámbito memory:read o memory:write: emita un token con los permisos necesarios.
- Destino de instalación incorrecto — Verifique que XMEMO_SKILL_DIR se haya establecido en ~/.claude/skills/xmemo-memory.
- Se necesita recarga de Skill — Salga de Claude Code (/exit) y vuelva a iniciarlo para recargar las skills en memoria.

## Actualización y eliminación

Procedimientos para actualizar o desinstalar la integración:

- Actualización: Vuelva a ejecutar el aviso del instalador para obtener la última versión del paquete de Skill.
- Eliminación: Elimine ~/.claude/skills/xmemo-memory, o ejecute claude mcp remove xmemo para eliminar la configuración directa 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}"
      }
    }
  }
}
```