# Cómo desactivar la memoria automática de Claude Code en un proyecto
> La memoria automática de Claude Code para un solo proyecto se desactiva con la línea autoMemoryEnabled: false en .claude/settings.json. ¿Qué ventaja tiene frente a /memory y cómo puedes limpiar las notas?
Source: https://ailoot.ai/blog/es/disable-claude-code-auto-memory-per-project/
Canonical: https://ailoot.ai/blog/es/disable-claude-code-auto-memory-per-project/
Language: es
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-049
Revision: sha256-d35e063c39c18eaacdf1ea9fbad421444653f7797b97b5fc130b12789860c1f4
Para desactivar la memoria automática de Claude Code en un solo proyecto, añade `"autoMemoryEnabled": false` al archivo `.claude/settings.json` de ese proyecto. El interruptor del comando `/memory` no sirve para esto: escribe el ajuste en tu archivo global y desactiva la memoria en todos los proyectos de tu ordenador.
Un agente puede llenarse rápidamente de cosas que no necesita. En el caso que se describe aquí, Hermes pasó 2 horas pensando en una tarea. Cuando le preguntaron: «¿Cuántos tokens has usado?», respondió: «Mi estimación aproximada es de 100 millones». ¿Resolvió la tarea? «No, investigué». Siguió revisando todos los archivos uno por uno y acabó confundiéndose.
Por eso, debes guardar en la memoria de un agente solo la información más valiosa. Y, según la evaluación que se presenta aquí, la memoria automática de Claude Code es bastante débil: muy pequeña y muy comprimida. Si quieres que Claude trabaje únicamente según tus reglas, basta con 1 línea en los ajustes del proyecto.
Veamos en qué se diferencia la memoria automática de CLAUDE.md, cómo desactivarla y qué hacer con las notas antiguas. Vamos allá.
Documentación de referencia de Ailoot: [ailoot.ai/docs/](https://ailoot.ai/docs/).
Punto clave
Abre el archivo `.claude/settings.json` del proyecto y añade `"autoMemoryEnabled": false`. Si otras personas trabajan en el proyecto y quieres desactivar la memoria solo para ti, pon la misma clave en `.claude/settings.local.json`. La clave solo se aplica a este proyecto; la memoria seguirá funcionando en los demás. El interruptor de `/memory` escribe la clave en `~/.claude/settings.json` y desactiva la memoria en todas partes. Al desactivar la memoria, las notas antiguas permanecen en el disco. Puedes abrirlas con `/memory` y limpiarlas manualmente.
## ¿En qué se diferencia la memoria automática de CLAUDE.md?
CLAUDE.md es el archivo principal de instrucciones, y tú lo escribes. En cada chat nuevo, Claude se pregunta, en esencia: «¿Qué hay aquí? ¿Quién soy? ¿Qué debo hacer?». Cuando todo está explicado en CLAUDE.md, responde: «Muy bien, soy el experto. Entendido».
Claude escribe la memoria automática por su cuenta. Le dices: «Recuerda que siempre debes responder en mi idioma preferido» o «No pongas valores directamente en el código; obténlos siempre de la base de datos», y escribe un archivo en la carpeta de memoria, algo así como «no vuelvas a hacer eso». En sesiones posteriores, lo recuerda.
Claro que no siempre. Los agentes siguen olvidando cosas y tienes que estar pendiente: «Oye, amigo, se te ha vuelto a olvidar. Ya hemos hablado de esto». Responde: «Ah, sí, me acuerdo; lo encontré aquí, en el archivo». Por eso, normalmente ponemos todo lo importante en CLAUDE.md en vez de depender de la memoria.
Encontrarás una explicación detallada de qué reglas poner en CLAUDE.md [en un artículo aparte](https://ailoot.ai/blog/es/claude-md-template/), y de las diferencias entre Memory en el chat de Claude y CLAUDE.md [en otro artículo](https://ailoot.ai/blog/es/claude-memory-claude-md-auto-memory/).
Si creas tus proyectos con agentes de IA, ten a mano la documentación de las herramientas que utilizas.
## Lo que Claude escribe por su cuenta
Claude Code guarda 4 tipos de notas:
- `user` — tu puesto, experiencia y forma de trabajar preferida;
- `feedback` — tus correcciones y los enfoques que has confirmado;
- `project` — el trabajo actual, los plazos y las decisiones que no se ven en el código;
- `reference` — dónde encontrar información fuera del proyecto, por ejemplo, en un gestor de tareas.
Todo esto está en `~/.claude/projects//memory/`. El archivo principal es `MEMORY.md`, un índice con 1 línea por nota. Al comienzo de cada sesión, Claude lee las primeras 200 líneas o 25 KB y abre los demás archivos cuando los necesita. La memoria solo está en tu ordenador: no se traslada a otro equipo ni a la nube.
En el ejemplo que se describe aquí, contiene el nombre y el puesto del usuario, además de una regla para no escribir valores dinámicos directamente en el código: solo 5–7 líneas en total. Son reglas para el propio agente: indican cómo debe trabajar.
Puedes guardar los conocimientos del proyecto en un segundo cerebro: carpetas con archivos que el agente lee mediante enlaces. Para este enfoque, conviene definir un skill de «segundo cerebro» y guardar junto a los archivos del proyecto un PDF con los comandos de instalación de Hermes y una tabla sobre «qué modelo usar para cada tarea».
## Cómo desactivar la memoria automática para un proyecto
1. ### Añade la línea a los ajustes del proyecto
La carpeta principal del proyecto contiene una carpeta oculta `.claude` con un archivo `settings.json`. Lo más fácil es pedírselo al propio Claude Code: «Añade `"autoMemoryEnabled": false` al archivo `.claude/settings.json` de este proyecto y deja los demás ajustes como están». Si vas a abrirlo manualmente y el archivo no existe, créalo con este contenido:
```json
{
"autoMemoryEnabled": false
}
```
Si el archivo ya contiene ajustes, añade la clave junto a ellos y deja todo lo demás igual. Cuando `autoMemoryEnabled` tiene el valor `false`, Claude no lee la carpeta de memoria ni escribe nada en ella.
2. ### Elige a quién se aplica el ajuste
`.claude/settings.json` es el archivo compartido del proyecto y se aplica a todas las personas que trabajan en él. Si quieres desactivar la memoria solo para ti, pon la misma clave en `.claude/settings.local.json`: este es tu archivo personal de ajustes para el proyecto.
Los ajustes del proyecto tienen prioridad sobre los ajustes globales. Aunque la memoria esté activada en `~/.claude/settings.json`, el valor `false` prevalece en este proyecto.
3. ### Reinicia Claude Code
Cierra la sesión y vuelve a ejecutar `claude` en la carpeta del proyecto. Escribe `/status`: el archivo del proyecto debería aparecer en la línea `Setting sources`. Si aparece, Claude lo ha leído. La memoria seguirá activada en el proyecto vecino.
Hay otros 2 métodos, pero sirven para propósitos distintos:
- **La variable de entorno `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1`.** Ejecutar `CLAUDE_CODE_DISABLE_AUTO_MEMORY=1 claude` desactiva la memoria solo durante esa ejecución y prevalece sobre la clave de los archivos de ajustes. Pero tienes que escribirlo cada vez.
- **El interruptor de `/memory`.** Escribe `autoMemoryEnabled` en `~/.claude/settings.json`, tu archivo global para todos los proyectos del ordenador. Si lo usas en un proyecto, desactivas la memoria en todas partes.
Una cosa más: en una sesión en segundo plano, el interruptor solo puede desactivar la memoria, no volver a activarla. Para activarla, usa una sesión normal que hayas iniciado tú mismo ejecutando `claude` en la terminal.
Advertencia
Desactivar la memoria no elimina nada de lo que Claude ya haya escrito. La carpeta `memory` permanece en el disco hasta que la limpies tú mismo.
## Qué hacer con las notas antiguas
El comando `/memory` muestra una lista de los archivos de memoria y te permite abrir cualquiera de ellos. Son archivos de texto normales: puedes editarlos o eliminarlos.
No los elimines a ciegas; primero mira qué contienen. En el caso descrito aquí, durante la limpieza de una carpeta de reglas, el agente había registrado información innecesaria sobre el usuario como parte de su autorreflexión. Las reglas desordenadas son tan perjudiciales como un archivo CLAUDE.md en la raíz lleno de reglas obsoletas: el agente sigue usándolas, alucina y te proporciona un contexto peor.
Puedes pedirle al agente que haga la limpieza. Una vez a la semana, puedes asignarle una tarea como esta para la carpeta de trabajo; también sirve para la carpeta de memoria:
```
Tu tarea es encontrar todo lo que ya no sea pertinente o esté obsoleto, y demostrar que realmente está obsoleto. Todavía no debes borrarlo; solo tienes que encontrarlo y presentármelo.
```
Te presenta una lista con pruebas, y tú decides qué eliminar. Pasa de las notas a CLAUDE.md solo la información más valiosa. Encontrarás una explicación sobre cómo mantener las instrucciones breves para que Claude las siga [en un artículo aparte](https://ailoot.ai/blog/es/claude-md-after-opus-5/). Y en [el artículo sobre el segundo cerebro](https://ailoot.ai/blog/es/claude-code-second-brain/) se explica cómo organizar en conjunto la memoria del proyecto, con carpetas y reglas.
¿Has dejado activada la memoria automática o la has desactivado? Comprueba qué ha conseguido recordar Claude sobre ti. Puedes seguir explorando Ailoot en [ailoot.ai](https://ailoot.ai/).
### Fuentes
- [Claude Code: Cómo recuerda Claude tu proyecto](https://code.claude.com/docs/en/memory.md) — tipos de notas, carpeta de memoria, 200 líneas o 25 KB, el interruptor de /memory, el ajuste para un solo proyecto y la variable de entorno
- [Claude Code: Archivos de ajustes y prioridades](https://code.claude.com/docs/en/settings.md) — `.claude/settings.json`, `.claude/settings.local.json` y `~/.claude/settings.json`, y cuál tiene prioridad
- [Claude Code: Referencia de ajustes, autoMemoryEnabled](https://code.claude.com/docs/en/settings-reference.md) — qué hace `false`, dónde se puede definir la clave y la prioridad de la variable de entorno
## Preguntas sobre Claude Code
### ¿Qué archivo desactiva la memoria solo para mí en un proyecto?
Añade "autoMemoryEnabled": false al archivo .claude/settings.local.json de ese proyecto. Usa .claude/settings.json si el ajuste debe compartirse en el proyecto. El interruptor /memory cambia el ajuste global y no es adecuado si otros proyectos deben conservar la memoria activada.
### ¿Desactivar la memoria automática borra las notas anteriores?
No. La carpeta de memoria sigue en el disco. Revisa sus archivos antes de borrar nada y conserva las decisiones útiles en otro lugar si hace falta. Reinicia Claude Code tras cambiar los ajustes del proyecto y comprueba en /status de dónde procede la configuración cargada.
## Ailoot · La empresa y su cartera de proyectos
Ailoot se apoya en la experiencia operativa acumulada, una amplia base de clientes, un servicio estable y el seguimiento continuo de KPI.
La empresa y su cartera de proyectos: millones de clientes; ventas por miles de millones al mes.
Ailoot aplica esa experiencia operativa al acceso por API a funciones de IA en productos de clientes, agentes, aplicaciones y automatizaciones.