¿Dónde guarda Claude Code su archivo de plan? Qué sucede con un plan tras la compactación o /clear, y cómo mantenerlo en tu repositorio (2026)

Anthropic describe el modo plan en una línea: "le dice a Claude que investigue y proponga cambios sin realizarlos". Claude lee archivos, ejecuta comandos para explorar y escribe un plan, pero no edita tu código fuente hasta que lo apruebas.

El plan se escribe en el disco antes de que Claude pida aprobación. La referencia de hooks de Anthropic lo dice directamente: "Claude escribe el plan en un archivo en el disco antes de llamar a la herramienta". Cuando un hook inspecciona ese paso de aprobación, Claude Code le pasa dos campos: plan, el Markdown del plan, "Inyectado desde el archivo de plan en el disco", y planFilePath, la ruta al archivo.

Por lo tanto, el archivo es la fuente de verdad. Lo que ves en la conversación es el plan tal como Claude lo presentó; lo que está en el disco es el plan que Claude Code vuelve a leer más tarde.

La ubicación por defecto es ~/.claude/plans/. La guía del directorio .claude de Anthropic enumera esa carpeta como el lugar que contiene los "Archivos de plan escritos durante el modo plan". Si estableces CLAUDE_CONFIG_DIR para mover el directorio de inicio de Claude Code, la carpeta de planes se mueve con él.

Los nombres siguen tu prompt. Una nota de lanzamiento de Claude Code dice: "Los archivos de plan ahora se nombran según tu prompt (por ejemplo, fix-auth-race-snug-otter.md) en lugar de palabras puramente aleatorias". Así que un plan para corregir una condición de carrera en la autenticación obtiene un nombre que comienza con esas palabras, seguido de palabras aleatorias, como en el ejemplo de Anthropic.

Los planes de cada proyecto van a la misma carpeta por defecto. Si trabajas en varios repositorios, ~/.claude/plans/ contiene los planes de todos ellos uno al lado del otro.

No tienes que buscar el archivo a mano para cambiarlo.

• En la terminal: cuando el plan esté listo, "Presiona Ctrl+G para abrir el plan propuesto en tu editor de texto predeterminado y editarlo directamente antes de que Claude proceda".
• En VS Code: la extensión abre el plan como un documento Markdown completo donde puedes añadir comentarios en línea. Escribir /plan mientras ya estás en modo plan muestra el plan actual, y /plan open abre el archivo del plan en el editor.
• En el menú de aprobación: elige seguir planificando y dile a Claude qué cambiar.

Debido a que el archivo es lo que Claude Code vuelve a leer, editarlo cambia el plan sobre el cual trabaja Claude.

Las sesiones de planificación largas llenan la ventana de contexto, y la compactación resume la conversación para dejar espacio. Los planes se manejan de forma diferente al resto. La tabla de Anthropic sobre lo que sobrevive a la compactación enumera "El plan que Claude escribió en modo plan" con el resultado "Reinyectado desde el disco".

Eso significa que el plan no se comprime en el resumen junto con todo lo demás. Claude Code lee el archivo de nuevo y lo vuelve a poner en contexto. De esto se derivan dos puntos prácticos:

• Tus ediciones en el archivo cuentan. Lo que esté en el disco cuando se ejecute la compactación es lo que regresa.
• La discusión en torno al plan no recibe el mismo tratamiento. Las razones que diste para rechazar un enfoque, las compensaciones que discutieron, son parte de la conversación y se resumen con ella. Si una razón es importante, ponla en el archivo del plan.

Nuestra guía sobre el comando /context muestra cómo ver qué está llenando la ventana antes de que ocurra la compactación.

/clear inicia una nueva conversación, y los planes siguen su ejemplo. Una nota de lanzamiento describe una corrección exactamente para esto: "Se corrigió que los archivos de plan persistieran a través de los comandos /clear, asegurando ahora que se use un archivo de plan nuevo después de borrar una conversación".

Así que después de /clear, Claude Code inicia un nuevo archivo de plan para la nueva conversación. La nota de lanzamiento no describe la eliminación del archivo antiguo; significa que la nueva conversación no retoma el plan anterior. Si borras y quieres seguir trabajando desde el plan, ábrelo primero o pídele a Claude que lea el archivo antiguo por su ruta.

La opción clear-context al aprobar

Hay un borrado que está diseñado para mantener el plan. El ajuste showClearContextOnPlanAccept añade una primera opción al menú de aprobación que "aprueba el plan, borra el contexto de la conversación y comienza la implementación basándose solo en el plan". Está desactivado por defecto. La razón de Anthropic para ofrecerlo: "La planificación puede usar mucho contexto".

Esa opción es la forma limpia de descartar una exploración larga y quedarse solo con su resultado.

Los forks obtienen su propio archivo de plan. Una nota de lanzamiento corrigió que "las conversaciones bifurcadas (/fork) compartieran el mismo archivo de plan, lo que causaba que las ediciones del plan en una bifurcación sobrescribieran la otra". Ahora cada bifurcación planifica por separado.

Resume restaura el modo plan. Varias correcciones se refieren a esto, incluida una para "el modo plan no se restauraba al reanudar una sesión desde el selector de sesiones claude --resume o con /resume". Si una sesión reanudada parece haber salido del modo plan, verifica que estés en una versión reciente.

Las sesiones en la nube mantienen el archivo tras los reinicios. Las notas de lanzamiento describen correcciones para sesiones remotas que perdían el rastro del archivo de plan tras el reinicio de un contenedor, y para un plan escrito en modo plan que se perdía cuando el contenedor de una sesión en la nube se reiniciaba antes de que se presentara el plan.

Los archivos de plan no son permanentes. La lista de datos de aplicación de Anthropic que Claude Code elimina de forma programada incluye plans/, junto con transcripciones y otros archivos de sesión. La regla: "Claude Code elimina los archivos en las rutas a continuación una vez que son más antiguos que cleanupPeriodDays". El valor por defecto es 30 días.

La tabla de Anthropic sobre lo que pierdes al eliminar los datos de la aplicación tú mismo sitúa a ~/.claude/plans/ entre las carpetas con "Nada orientado al usuario". En otras palabras, Claude Code trata un plan en la carpeta por defecto como material de trabajo para una sesión, no como un registro.

Si quieres un plan como registro, debe vivir en otro lugar.

El ajuste plansDirectory mueve los archivos de plan. "Elige dónde guarda Claude Code los archivos de plan que escribe en modo plan. Claude Code resuelve la ruta relativa a la raíz del proyecto". El valor de ejemplo de Anthropic es ./plans.

Ponlo en el archivo .claude/settings.json de tu proyecto, y los planes para ese proyecto aterrizarán en una carpeta plans/ en el repositorio. El ajuste puede ir en cualquier archivo de configuración, por lo que también puedes establecerlo solo para ti en la configuración local.

Dos casos envían los planes de vuelta a la carpeta por defecto:

• Una ruta fuera de la raíz del proyecto, como ../plans.
• Una barra invertida (backslash) en macOS, Linux y WSL. Anthropic sugiere escribir docs/plans en lugar de una ruta al estilo Windows; la barra diagonal funciona también en Windows.

La lista de limpieza automática nombra la carpeta plans/ bajo ~/.claude/; una carpeta de planes dentro de tu repositorio no está en esa lista. El modo plan también puede seguir escribiendo allí: la lista de rutas protegidas de Anthropic hace una excepción para "Los archivos de plan de la propia sesión actual" en ~/.claude/plans/ o en el plansDirectory que establezcas.

Hazles commit o ignóralos

Una vez que los planes estén en el repositorio, decide si se comparten. Los planes confirmados (committed) dan a los revisores el razonamiento detrás de un cambio. Los planes ignorados permanecen locales y no están en la lista de limpieza. De cualquier manera, ahora son archivos que tú controlas. Para ver cómo maneja Factory la misma cuestión, consulta nuestra guía sobre cómo mover los planes de especificaciones de Factory fuera del directorio de inicio.

Buscar el plan en la carpeta del proyecto. Por defecto está en ~/.claude/plans/, no en el repositorio.

Esperar que /clear mantenga el plan. Inicia un archivo de plan nuevo. Abre o guarda el antiguo primero.

Asumir que los planes duran para siempre. Los archivos en la carpeta por defecto se limpian con cleanupPeriodDays, 30 días por defecto.

Establecer plansDirectory en una carpeta superior. Las rutas fuera de la raíz del proyecto vuelven al valor por defecto.

Tratar el plan como memoria del proyecto. Un plan pertenece a una sesión. Las reglas que deben aplicarse siempre pertenecen a CLAUDE.md o archivos de reglas; nuestra guía sobre las reglas de Claude Code explica la diferencia.

Paso 1: Establece plansDirectory para el proyecto

Añade plansDirectory con una ruta dentro del proyecto, como ./plans, a la configuración del proyecto. Los nuevos planes para ese proyecto aterrizarán en el repositorio en lugar de en la carpeta de inicio.

Paso 2: Pon las razones en el archivo del plan

Antes de aprobar, abre el plan con Ctrl+G o /plan open y añade las decisiones y los enfoques rechazados que sean importantes. El archivo es lo que regresa después de la compactación.

Paso 3: Mueve las decisiones duraderas fuera del plan

Cuando el trabajo esté terminado, toma las decisiones que deban sobrevivir a él, como una convención que acordaste o un enfoque que descartaste, y escríbelas en CLAUDE.md o en tus propias notas. Si la implementación salió mal, nuestra guía sobre /rewind en Claude Code cubre cómo deshacer las ediciones.

Un archivo de plan contiene el razonamiento de un cambio. Parte de ese razonamiento sigue siendo importante: por qué elegiste una librería, qué enfoque falló la última vez. Esos hechos desaparecen cuando se limpia un plan en la carpeta por defecto, y no están en absoluto en el plan de la siguiente sesión.

MemoryLake es una capa de memoria para mantener esas decisiones en un lugar que tú mantienes, disponible para los asistentes que conectes, como ChatGPT, Claude Code y Codex.

Tú mismo escribes las entradas, con tus propias palabras. No se lee nada, ni se escribe, ni se borra de tus archivos de plan, tus sesiones de Claude Code, tus archivos CLAUDE.md, tu memoria automática o el almacenamiento de cualquier proveedor. El modo plan y plansDirectory siguen funcionando de la manera que Anthropic describe.

Paso 1: Crea una clave API

Inicia sesión y genera una clave desde el panel de control. La clave pertenece a tu espacio de trabajo de MemoryLake y es independiente de tu cuenta de Claude.

Paso 2: Sube tus primeras memorias

Comienza con las decisiones del Paso 3 de la solución: elecciones que hiciste y enfoques que descartaste, cada uno con una línea sobre el porqué. Un punto por entrada.

Paso 3: Conecta tu IA y agentes

Conecta Claude Code y cualquier otro asistente que utilices. El siguiente plan comenzará con las decisiones del último disponible.

La primera diferencia son los planes que puedes encontrar. Están en el repositorio, nombrados según el prompt, y no están en la lista de limpieza.

La segunda son los planes que sobreviven a la sesión. La compactación vuelve a leer el archivo, y las razones que añadiste regresan con él.

La tercera es menos argumentos repetidos. El enfoque que descartaste el mes pasado está escrito, por lo que el siguiente plan no lo propondrá de nuevo. Si planificas con un modelo diferente, nuestra guía sobre cómo cambiar de modelo a mitad de sesión cubre qué efecto tiene eso en la conversación.

Conoce la carpeta por defecto. Los planes van a ~/.claude/plans/ a menos que establezcas plansDirectory.

Establece plansDirectory dentro del proyecto. Las rutas fuera de la raíz vuelven al valor por defecto.

Usa barras diagonales (forward slashes). Una barra invertida envía los planes de vuelta al valor por defecto en macOS y Linux.

Edita el archivo, no solo el chat. El archivo es lo que regresa después de la compactación.

Guarda el plan antes de /clear. La siguiente conversación obtiene un archivo de plan nuevo.

Ten en cuenta la limpieza de 30 días. Se aplica a la carpeta de planes por defecto.

Mueve las decisiones duraderas a CLAUDE.md. Un plan pertenece a una sola sesión.

Claude Code escribe cada plan en un archivo antes de pedir aprobación, por defecto en ~/.claude/plans/, nombrado según tu prompt. El archivo se reinyecta desde el disco tras la compactación, se utiliza un archivo nuevo tras /clear, cada bifurcación obtiene el suyo propio y la carpeta por defecto se limpia después de 30 días.

Para conservar los planes, establece plansDirectory en una carpeta dentro de tu proyecto. Edita el archivo para cambiar el plan, incluye las razones en él y mueve las decisiones que deban durar más que la sesión a un lugar donde se vuelvan a encontrar.