Claude Code: contexto, memoria, MCP y Context7 antes de añadir más tools
Para recuperar una sesión de Claude Code, distingue una ventana de contexto llena, instrucciones que no se cargaron y una conexión MCP fallida. Context7 exige además comprobar qué documentación devuelve.
En esta página

Si Claude Code deja de respetar una decisión después de leer muchos archivos, empieza por /context. Si una sesión nueva desconoce una regla del proyecto, comprueba sus archivos de instrucciones y usa /memory para editarlos. Si Context7 no aparece, no conecta o consulta otra biblioteca, revisa MCP y la consulta documental. Añadir un servidor de memoria no corrige por sí solo ninguno de esos tres fallos.
Hay una diferencia que cambia el diagnóstico: /context muestra el material que ocupa la ventana actual y permite comprobar los archivos cargados en Memory files; /memory sirve para localizar y editar instrucciones o gestionar la memoria automática. Una ubicación que aparece en el menú de /memory puede corresponder a un archivo todavía inexistente. No equivale a demostrar que sus instrucciones entraron en la sesión. Documentación de memoria de Claude Code.
Identifica el fallo antes de cambiar la configuración
| Lo que observas | Primera comprobación | Qué hacer después |
|---|---|---|
| La respuesta empeora tras una lectura o una salida muy larga | /context: compara mensajes, archivos y resultados con la carga inicial | Reduce la siguiente lectura y compacta conservando la decisión actual |
| Una sesión nueva no conoce una regla estable | /context → Memory files, después /memory | Corrige la ubicación o la instrucción y comprueba otra sesión |
| Una herramienta externa no aparece o no conecta | /mcp, claude mcp list, claude mcp get context7 | Revisa aprobación, alcance, transporte y autenticación |
| Context7 conecta, pero devuelve documentación inadecuada | Solicitud y resultado de resolve-library-id y query-docs | Precisa biblioteca, versión y pregunta; contrasta la respuesta |
| El proceso consume mucha RAM | /doctor y diagnóstico del proceso | Investiga recursos del equipo; la RAM no mide la ventana de contexto |
Esta distinción evita confundir almacenamiento persistente, tokens de una conversación y memoria del proceso. El diagnóstico oficial en español trata el consumo de RAM y la compactación repetida como problemas distintos. Una sesión puede llenar su contexto con una sola respuesta extensa sin que falte memoria persistente.

El mapa ayuda a elegir por dónde empezar. Para confirmar la carga de instrucciones, utiliza la comprobación de Memory files descrita arriba; el menú de edición cumple otra función.
Recupera una sesión que ha perdido el hilo
El contexto es lo que Claude puede procesar en ese momento: instrucciones, conversación, archivos leídos, herramientas disponibles y resultados. La información guardada en disco solo ayuda cuando se carga o se recupera. Tampoco hay una capacidad única de contexto aplicable a todos los modelos y configuraciones. /context muestra la situación de tu sesión, mientras que los gráficos de la documentación son ejemplos. Ventana de contexto de Claude Code.
Si el problema empezó tras una operación concreta, cambia primero esa operación. En vez de leer un registro completo, solicita el intervalo del fallo y los campos necesarios; en vez de recorrer todo el repositorio, pide los archivos relacionados con el símbolo que investigas. Un resumen no durará mucho si la siguiente herramienta vuelve a entregar miles de líneas.
Cuando ya hay una decisión que conviene conservar, puedes dirigir la compactación con una instrucción como esta, dentro de Claude Code:
/compact Conserva el objetivo actual, los archivos modificados, la decisión de no cambiar la autenticación, las comprobaciones pendientes y el siguiente paso. Omite las alternativas descartadas.Después, pide a Claude que enumere el objetivo, la restricción crítica y el siguiente paso. Compáralos con lo acordado antes de compactar. Si falta una condición, vuelve a proporcionarla y, si debe regir futuras sesiones, guárdala en las instrucciones del proyecto. La compactación resume la conversación; no garantiza conservar cada detalle.
Si hay ramas de investigación mezcladas con la implementación, un subagente puede hacer la lectura amplia y devolver archivos relevantes, hallazgos y dudas. No des por hecho que un subagente nuevo recibe toda la memoria automática de la conversación principal: la documentación distingue su contexto y su propia memoria. Incluye las condiciones que necesita para la tarea.
Reserva /clear para empezar una tarea nueva o abandonar un hilo que ya no resulta útil. Antes, guarda en un archivo o nota la decisión vigente, las rutas cambiadas, el trabajo pendiente y las restricciones. Un texto breve de continuación puede ser suficiente:
Objetivo: corregir la validación del formulario.
Archivos modificados: src/form.ts y tests/form.test.ts.
Restricción: no cambiar el flujo de autenticación.
Pendiente: revisar el caso de campo vacío y ejecutar la prueba correspondiente.Estos textos son ejemplos para adaptar, no resultados de una sesión de prueba. La señal de recuperación es que Claude retoma el trabajo correcto y la siguiente operación evita volver a llenar el contexto con material innecesario. Si la sesión compacta una y otra vez, revisa qué devuelve la herramienta inmediatamente después de cada resumen.
Repara una regla que no llega a la siguiente sesión
Para una norma que quieres mantener —el comando de pruebas, una convención del proyecto o una acción que requiere autorización— escribe una instrucción explícita en el archivo adecuado. La memoria automática, o auto memory, recoge aprendizajes y correcciones de forma selectiva; no es una transcripción ni una copia de seguridad de cada conversación.
Un ejemplo de instrucción persistente sería:
## Comprobación de cambios
Antes de dar por terminado un cambio del formulario, ejecuta npm test.
Si la prueba falla, informa del error y conserva los archivos para revisarlos.Para verificarla, abre Claude Code desde el proyecto, ejecuta /context y busca el archivo en Memory files. Usa /memory para abrir o crear la ubicación que corresponda. Después inicia otra sesión en el mismo proyecto y comprueba tanto la carga del archivo como la comprensión de la regla. Si el archivo se cargó pero la respuesta contradice una instrucción, busca reglas incompatibles o demasiado vagas antes de crear otro sistema de memoria.
Las instrucciones de usuario se aplican a tus proyectos; las de proyecto se comparten mediante el repositorio; CLAUDE.local.md permite instrucciones personales para ese proyecto. Los archivos situados en la jerarquía de directorios de arranque se cargan al inicio, mientras que las instrucciones de subdirectorios se incorporan cuando corresponde. Importar archivos con @ruta permite organizarlos, pero no elimina su coste de contexto. Ubicación y carga de instrucciones.
Qué límite tiene MEMORY.md
El índice MEMORY.md de la memoria automática carga al inicio las primeras 200 líneas o 25 KB, lo que se alcance antes. Las notas temáticas se consultan cuando hacen falta. Ese límite no es un recorte universal de todos los archivos CLAUDE.md: para estos, la recomendación de mantenerlos breves no debe confundirse con el límite del índice.
Si una corrección importante quedó enterrada en una nota, utiliza /memory para revisar dónde se guardó y conviértela en una instrucción explícita cuando deba aplicarse siempre. Mantén en el índice referencias claras a detalles, en vez de pegar registros enteros. La memoria automática pertenece al repositorio y, en una misma máquina, se comparte entre sus worktrees y subdirectorios; no se sincroniza automáticamente con otro equipo. Funcionamiento de auto memory.
Si el repositorio utiliza AGENTS.md
Claude Code admite la lectura directa de AGENTS.md desde la versión 2.1.277, con condiciones. Por defecto, lo lee cuando no existe un CLAUDE.md, .claude/CLAUDE.md o CLAUDE.local.md en el directorio de trabajo o sus antecesores. Las instrucciones globales del usuario no bloquean esa lectura. En /config, Project instructions permite elegir qué instrucciones de proyecto cargar.
Si no aparece el ajuste, revisa la versión y la disponibilidad de esa función en tu sesión. La documentación señala limitaciones en algunas sesiones anteriores a 2.1.281. En una sesión compatible, comprueba la carga y evita mantener dos archivos con reglas contradictorias. Si tu entorno no admite lectura directa, la alternativa documentada es importar AGENTS.md desde CLAUDE.md. Condiciones de lectura de AGENTS.md.
Tras /compact, las instrucciones raíz y las reglas sin alcance específico vuelven a incorporarse; las anidadas o limitadas por ruta se cargan cuando corresponde. Una decisión escrita solo en la conversación puede perder detalle durante el resumen. Guardarla como instrucción es útil si debe persistir; guardar toda la conversación no lo es.
Configura Context7 por una sola vía
Context7 recupera documentación de bibliotecas. No guarda las decisiones de tu proyecto ni sustituye las instrucciones persistentes. Su configuración actual ofrece una vía asistida, un plugin alojado y opciones MCP manuales. Elige una de ellas antes de añadir otra entrada para el mismo servicio.
Configuración asistida con CLI o MCP
En una terminal con npx disponible, la guía de Context7 para Claude Code indica:
npx ctx7 setup --claudeEl asistente utiliza OAuth con enlace y código de verificación, genera una clave API e instala un skill; permite elegir modo CLI o MCP. Sigue la modalidad que hayas elegido: en modo CLI no corresponde exigir que exista un servidor MCP como prueba de instalación. El skill instalado se activa ante preguntas sobre bibliotecas, sin que sea obligatorio añadir «use context7» a cada solicitud.
Plugin alojado con inicio de sesión en el navegador
Dentro de Claude Code, ejecuta los dos comandos por separado:
/plugin marketplace add upstash/context7
/plugin install context7@context7-marketplaceReinicia Claude Code, abre /mcp, selecciona Context7 y completa el inicio de sesión en el navegador. El plugin conecta al servidor alojado y ofrece resolve-library-id y query-docs; no necesita Node.js, npm o npx locales.
El plugin no lee CONTEXT7_API_KEY. Exportar esa variable y reiniciar no es una reparación de su autenticación. Si necesitas utilizar una clave API, elige la configuración asistida o la vía manual correspondiente. El inicio de sesión del plugin y el OAuth con código del asistente son flujos distintos. Instalación y autenticación del plugin.
MCP manual por HTTP con una clave API
Para compartir la estructura de configuración del proyecto sin incluir la clave, puedes incorporar esta entrada a .mcp.json. Si el archivo ya contiene servidores, conserva las demás entradas:
{
"mcpServers": {
"context7": {
"type": "http",
"url": "https://mcp.context7.com/mcp",
"headers": {
"Authorization": "Bearer ${CONTEXT7_API_KEY}"
}
}
}
}La clave debe estar disponible en el entorno del proceso que inicia Claude Code, mediante tu mecanismo privado de gestión de secretos. ${CONTEXT7_API_KEY} es una referencia, no una clave literal. Claude Code admite expansión de variables en los encabezados de .mcp.json; la configuración compartida no transmite automáticamente el secreto a tus compañeros. Aprueba el servidor de proyecto cuando Claude Code lo solicite. Variables y alcance MCP, conexión manual de Context7.
Para una conexión manual con OAuth, Context7 documenta el endpoint /mcp/oauth en clientes HTTP compatibles. Esa indicación no obliga a cambiar el endpoint interno del plugin. Un servidor local por stdio utiliza un proceso como npx -y @upstash/context7-mcp --api-key YOUR_API_KEY y autenticación por clave; necesita su entorno local. No combines los campos url de HTTP con una configuración que espere ejecutar un proceso stdio.
Si Context7 no conecta, revisa estado y alcance
Desde una terminal situada en el proyecto, estas comprobaciones documentadas permiten inspeccionar el servidor:
claude mcp list
claude mcp get context7En la sesión, utiliza además /mcp para revisar autenticación, reconexión y herramientas. Que un comando de alta muestre Added solo confirma que se escribió la configuración. Tampoco ver dos herramientas disponibles demuestra que ya se hayan consultado documentos.
| Estado o indicio | Reparación que corresponde | Cómo comprobarla |
|---|---|---|
No aparece context7 | Revisa la vía de instalación y el proyecto desde el que ejecutas Claude Code | La entrada deseada aparece en ese proyecto; si elegiste CLI, verifica esa modalidad |
Pending approval, Rejected o Disabled | Revisa aprobación o activación en /mcp | El servidor queda habilitado y puede conectar |
not configured o URL vacía | Completa la URL de la entrada seleccionada | Desaparece la indicación de URL ausente |
Failed to connect con 401 | Corrige la autenticación de esa vía; en HTTP manual, revisa clave y encabezado | La conexión se establece y una consulta devuelve documentos |
Aviso de espacios en headers.Authorization | Quita espacios o saltos de línea accidentales de la configuración privada | Desaparece el aviso y cambia el resultado de la conexión |
| Configuración correcta, pero se usa otra entrada | Revisa entradas con el mismo nombre en distintos alcances | Queda activa la definición y el endpoint que necesitas |
| Conectado, pero sin documentos pertinentes | Corrige biblioteca, versión o pregunta | El resultado corresponde a la documentación solicitada |
Para un mismo nombre, la precedencia normal de las entradas es local → proyecto → usuario → plugin → claude.ai; la configuración administrada de una organización puede imponerse. Se elige una entrada completa, no se mezclan la URL de una con los encabezados de otra. El alcance local es privado para el proyecto actual, project utiliza .mcp.json y user se aplica a todos tus proyectos. Si una entrada manual oculta al plugin, arregla o elimina la entrada sobrante en el alcance concreto; instalar otra vez el plugin no elimina el conflicto. Gestión y diagnóstico de MCP.
Las versiones actuales muestran detalles en Issue: cuando el fallo incluye un estado HTTP o un código de transporte; antes de 2.1.219, esa información no aparecía de la misma forma. Algunos descubrimientos de herramientas se almacenan en caché y la conexión puede producirse al utilizar el servidor. Distingue ese estado de un fallo confirmado: intenta una consulta concreta y observa su resultado.
Si el detalle disponible no basta, la referencia actual de CLI documenta:
claude --debug='mcp,startup'El signo = importa para filtrar las categorías. Conserva el registro en privado y comparte solo el fragmento necesario, sin credenciales ni datos del proyecto. La ruta aquí utiliza el diagnóstico documentado actual, en lugar de depender de claude mcp logs context7 citado en guías antiguas. Referencia de CLI.
Comprueba que Context7 ha consultado los documentos adecuados
Una conexión correcta solo resuelve el acceso. Para comprobar la recuperación documental, plantea una consulta acotada, por ejemplo:
Usa Context7 con /vercel/next.js. Necesito la documentación de Next.js 15 sobre middleware: ubicación del archivo, firma de la función y un ejemplo mínimo. Indica la versión consultada y las fuentes que respaldan la respuesta. Si no está disponible esa versión, dilo antes de proponer código.El identificador conocido permite omitir la resolución de biblioteca. Si no conoces el identificador, revisa primero el resultado de resolve-library-id y después la solicitud y respuesta de query-docs. Confirma que se consultó la biblioteca correcta y que la documentación respalda la versión y la función pedidas. Si el resultado no identifica la versión o no contiene la respuesta, el diagnóstico sigue abierto; una respuesta convincente del modelo no prueba por sí sola que haya utilizado Context7.
La comprobación útil distingue tres hechos: el servidor conectó, la herramienta devolvió documentación pertinente y el código propuesto pasó las pruebas del proyecto. Ninguno sustituye a los otros. Los ejemplos de esta guía se apoyan en la documentación citada y se han comprobado localmente en cuanto a sintaxis; no se presentan como una instalación, autenticación o consulta real realizada para este artículo.

Para pedir ayuda, conserva el momento del fallo, el archivo de instrucciones cargado, el estado MCP y la biblioteca consultada. No publiques un volcado completo de memoria del proceso: puede contener cadenas del proyecto y credenciales.
Cuándo merece la pena un servidor externo de memoria
Un servidor de memoria empieza a tener sentido cuando necesitas recuperar estado cambiante entre herramientas, compartir información entre personas o continuar entre máquinas. Antes de conectarlo, define qué información podrá guardar, quién la leerá, cómo eliminarla y cómo comprobar si sigue siendo válida. Prueba una tarea concreta: por ejemplo, recuperar una decisión vigente con su fecha y fuente, sin traer una versión ya descartada.
Para una regla corta, utiliza instrucciones persistentes. Para un procedimiento que se repite, un skill puede guardar los pasos y referencias. Para localizar símbolos, consulta el código. Para una investigación grande, aísla la lectura y devuelve una síntesis. Así puedes evaluar un servidor externo por lo que aporta, en vez de pedirle que compense una conexión rota o una sesión saturada.
La búsqueda diferida de herramientas, MCP Tool Search, puede reducir la carga inicial de definiciones cuando el modelo y la integración la admiten. Los nombres de herramientas, las instrucciones del servidor y los resultados utilizados siguen teniendo un coste. Con un proveedor o proxy externo, la disponibilidad depende también de que soporte las referencias a herramientas; no basta con activar una variable para superar una incompatibilidad. Condiciones de MCP Tool Search.
Preguntas frecuentes
¿Qué diferencia hay entre contexto y memoria en Claude Code?
El contexto es el material disponible en la conversación actual. Las instrucciones y la memoria automática persisten fuera de ella y aportan información cuando se cargan o se consultan. Guardar un dato no garantiza que esté presente ni que se aplique correctamente en cada respuesta.
¿Cómo sé si Claude Code ha cargado mi CLAUDE.md?
Ejecuta /context y comprueba Memory files. /memory permite gestionar ubicaciones y editar archivos, pero algunas ubicaciones pueden aparecer antes de que exista el archivo. Verifica también que la regla tenga un significado claro y no contradiga otra. Carga de instrucciones.
¿Las 200 líneas se aplican a todo CLAUDE.md?
No. El límite inicial de 200 líneas o 25 KB corresponde al índice MEMORY.md de auto memory. Mantener CLAUDE.md breve es una recomendación para reducir ruido, no ese mismo límite de carga. Límites de memoria.
¿Por qué Context7 no utiliza mi CONTEXT7_API_KEY?
El plugin alojado no lee esa variable y se autentica mediante su flujo de navegador. La vía manual HTTP del ejemplo sí referencia la variable en el encabezado, y el asistente tiene su propia configuración. Identifica cuál utilizas antes de cambiar secretos o reinstalar. Autenticación de Context7.
¿Context7 conectado significa que Claude usó documentación actual?
No. Comprueba la llamada y el resultado de query-docs, la biblioteca y la versión. Después valida el código en tu proyecto. La conexión, la consulta documental y la ejecución del código son comprobaciones distintas.
¿Necesito un memory MCP si Claude olvida decisiones tras compactar?
Primero conserva la decisión en el resumen y guarda como instrucción lo que deba regir futuras sesiones. Comprueba que la siguiente lectura no vuelva a saturar el contexto. Un servidor externo se justifica por una necesidad concreta de recuperación o colaboración, no solo por haber perdido un detalle durante la compactación.
Fuentes7
Páginas externas que cita esta guía, en el orden en que aparecen. Última actualización: 7 oct 2026.
Fuentes7
Páginas externas que cita esta guía, en el orden en que aparecen. Última actualización: 7 oct 2026.
- 1.Documentación de memoria de Claude Codecode.claude.com/docs/en/memory
- 2.diagnóstico oficial en españolcode.claude.com/docs/es/troubleshooting
- 3.Ventana de contexto de Claude Codecode.claude.com/docs/en/context-window
- 4.guía de Context7 para Claude Codecontext7.com/docs/clients/claude-code
- 5.Variables y alcance MCPcode.claude.com/docs/en/mcp
- 6.conexión manual de Context7context7.com/docs/resources/all-clients
- 7.Referencia de CLIcode.claude.com/docs/en/cli-reference





