Cómo migrar tus Proyectos de Claude a Claude Code sin perder el contexto (2026)

Un proyecto en el chat de Claude tiene cuatro tipos de contexto, y cada uno se almacena de forma diferente.

Instrucciones del proyecto. El centro de ayuda de Anthropic dice: "Claude usará estas instrucciones para todos los chats dentro del proyecto". Son el informe permanente: tono, rol, reglas.

Conocimiento del proyecto. Los archivos que subes. "Cualquier cosa que subas a este espacio se utilizará en todos tus chats dentro de ese proyecto". En los planes de pago, las bases de conocimiento grandes pasan a modo de recuperación (retrieval), lo cual explica nuestra guía sobre proyectos de Claude en modo RAG.

Chats del proyecto. Las conversaciones dentro del proyecto. El centro de ayuda añade una nota importante: "El contexto no se comparte entre chats dentro de un proyecto a menos que la información se añada a la base de conocimiento del proyecto".

Memoria del proyecto. "Cada proyecto tiene su propia memoria". Mientras trabajas en un proyecto, Claude utiliza esa memoria junto con tu memoria de chats fuera de los proyectos, y la nueva memoria se guarda en el proyecto.

Cuando te mudas a Claude Code, cada uno de estos elementos necesita un destino, y los destinos dependen de qué versión de Claude Code utilices.

En los nuevos Proyectos, en claude.ai/code

Anthropic está desplegando una nueva versión de proyectos "por etapas, comenzando con Claude Code". En palabras del centro de ayuda, "un proyecto es una conversación: dices lo que necesitas a medida que se te ocurre, y Claude divide el trabajo en hilos paralelos que se ejecutan en la nube". Añade: "Cada hilo comienza con los archivos, repositorios, instrucciones y memoria del proyecto".

La documentación de Claude Code detalla dónde reside ese contexto:

• Memoria del proyecto: "Notas que Claude guarda sobre el proyecto, como requisitos, decisiones y dificultades, almacenadas como archivos". Cada hilo en la nube lee el archivo de índice MEMORY.md cuando comienza.
• Instrucciones del proyecto: "Texto enviado a cada nuevo hilo y a Claude en la conversación del proyecto, hasta 16,000 caracteres".
• Repositorios, archivos y entorno: los repositorios que cada hilo clona, los archivos que puede leer y el entorno en la nube en el que se ejecuta.

Los nuevos Proyectos están disponibles en claude.ai/code, en la aplicación de escritorio y en la aplicación móvil de Claude. La sección de limitaciones de la documentación añade que no están disponibles "en la CLI de la terminal, la extensión de VS Code o el plugin de JetBrains". Nuestra guía sobre Proyectos de Claude Code y memoria de proyecto cubre cómo funciona esa memoria una vez que estás dentro.

En Claude Code en tu máquina

En la terminal, Claude Code lee el contexto de los archivos. La documentación de la memoria enumera los alcances:

• Instrucciones del proyecto en ./CLAUDE.md: "Instrucciones compartidas por el equipo para el proyecto", compartidas con los miembros del equipo a través del control de versiones.
• Instrucciones locales en ./CLAUDE.local.md: "Preferencias personales específicas del proyecto; añadir a .gitignore".
• Instrucciones de usuario en ~/.claude/CLAUDE.md: "Preferencias personales para todos los proyectos".
• Memoria automática (Auto memory), que Claude escribe por sí mismo y que cubre "Tus preferencias, correcciones que le das a Claude, contexto del proyecto que Claude no puede derivar del código".

El repositorio es también donde pertenecen los archivos de conocimiento cuando tratan sobre el código: especificaciones, notas de arquitectura, referencias de API. Claude Code los lee cuando la tarea lo requiere.

El centro de ayuda describe la migración en su sección sobre proyectos existentes: "Hemos comenzado a mover los proyectos existentes de algunos usuarios Pro y Max a la nueva versión. No se pierde ni se borra nada en el traslado. Todo lo que hay en tu proyecto viene con él: tus instrucciones, archivos, historial completo de chat y tareas programadas. Continuarás justo donde lo dejaste".

Dos frases más deciden si esto se aplica a ti. "Si has usado un proyecto existente en los últimos 30 días, te enviaremos un correo electrónico antes de mover tus proyectos". Y: "Otros proyectos existentes en el chat y Cowork permanecen en la versión actual por ahora, y los moveremos a medida que el despliegue se amplíe".

La documentación de Claude Code ofrece la otra cara del despliegue. El acceso "comenzó con cuentas que han usado sesiones en la nube y no tienen proyectos existentes en el chat de claude.ai o Cowork", y los proyectos anteriores "siguen funcionando como lo hacen hoy hasta que la experiencia rediseñada llegue a ellos". Nuestra guía sobre el rediseño de Proyectos cubre cómo se anunció inicialmente ese plan.

La lista de lo que viene con un proyecto migrado menciona instrucciones, archivos, historial de chat y tareas programadas. No menciona la memoria del proyecto de ninguna manera, así que después de una migración, abre la memoria del proyecto y verifica que lo que necesitas esté allí.

Incluso cuando tu proyecto se migra, vale la pena hacer algunas cosas de forma deliberada.

Decisiones que viven solo en los chats. Un proyecto migrado trae su historial de chat, pero un nuevo hilo comienza a partir de los archivos, instrucciones y memoria del proyecto. Una decisión a la que llegaste en un chat hace tres semanas está en el historial; que un hilo comience con ella depende de si llegó a la memoria o a las instrucciones.

Reglas del repositorio. Los nuevos Proyectos mantienen las instrucciones del proyecto separadas del archivo CLAUDE.md de cada repositorio. La documentación dice: "Las reglas sobre un repositorio, como sus comandos de construcción, pertenecen al CLAUDE.md de ese repositorio". Los hilos de la nube leen el CLAUDE.md raíz, pero "los archivos CLAUDE.md en subdirectorios y las reglas específicas de rutas no se cargan".

Trabajo en la terminal. Los nuevos Proyectos no se ejecutan en la CLI de la terminal. Si construyes allí, el contexto del proyecto tiene que llegar al repositorio.

Esperar a la migración. Se está desplegando por etapas, y Anthropic dice que otros proyectos permanecen en la versión actual por ahora.

Subir cada archivo de conocimiento al repositorio. Algunos pertenecen allí; otros, como notas de reuniones o una presentación de precios, son contexto, no código, y añaden ruido a cada sesión.

Pegar las instrucciones del proyecto en CLAUDE.md sin cambios. Las instrucciones escritas para un chat, como pedirle a Claude que responda como un gerente de producto senior, a menudo no encajan con un agente de programación, y los archivos CLAUDE.md largos se cargan en cada sesión.

Esperar que la memoria del proyecto aparezca en la terminal. Las sesiones de terminal utilizan la memoria automática en tu máquina, que es un almacenamiento independiente.

Paso 1: Haz un inventario del proyecto

Abre el proyecto y anota cuatro listas:

• Instrucciones: copia las instrucciones del proyecto en un archivo de texto.
• Archivos de conocimiento: enumera cada archivo y decide si trata sobre el código (especificación, esquema, notas de arquitectura) o sobre el trabajo que lo rodea (investigación, planes, notas).
• Decisiones en chats: revisa los chats recientes del proyecto y escribe una línea por decisión, con el motivo: qué se resolvió, qué se descartó, qué sigue abierto.
• Memoria del proyecto: abre la Memoria en la página del proyecto y anota lo que Claude ha guardado allí que quieras conservar.

La lista de decisiones es la parte que la gente suele saltarse, y es la que más importa. Recuerda la nota del centro de ayuda de que el contexto no se comparte entre los chats de un proyecto a menos que esté en el conocimiento del proyecto.

Paso 2: Elige dónde vivirá el proyecto

Si tienes los nuevos Proyectos en claude.ai/code, y especialmente si tu proyecto ya ha sido migrado, las instrucciones y archivos del proyecto pueden quedarse en el proyecto. Añade los repositorios en los que ocurre el trabajo. Tu tarea es revisar la memoria y las instrucciones, y mover las reglas específicas del repositorio a los repositorios correspondientes.

Si trabajas en la terminal, o aún no tienes los nuevos Proyectos, el repositorio es el destino. Elige el repositorio donde ocurre la mayor parte del trabajo.

Paso 3: Coloca cada pieza donde Claude Code la lea

Para los nuevos Proyectos:

1. Revisa la memoria del proyecto después de la migración y pídele a Claude en la conversación del proyecto que recuerde cualquier requisito o decisión de tu lista del Paso 1 que falte.
2. Recorta las instrucciones del proyecto al informe básico desde el cual debería comenzar cada hilo.
3. Mueve las reglas del repositorio al CLAUDE.md de cada repositorio, en la raíz, para que cada hilo de la nube las lea.

Para Claude Code en la terminal:

1. Reescribe las instrucciones del proyecto como una sección de CLAUDE.md. Mantén lo que se aplica al código: convenciones, arquitectura, flujos de trabajo. Pon las preferencias personales en CLAUDE.local.md o ~/.claude/CLAUDE.md.
2. Añade los archivos de conocimiento relacionados con el código al repositorio, en una carpeta docs/, y apunta a ellos desde CLAUDE.md.
3. Escribe las decisiones donde se carguen. Las reglas establecidas van en CLAUDE.md. El contexto que Claude no puede derivar del código, como por qué se rechazó un enfoque, puede ir a la memoria automática: dile a Claude que lo recuerde en tu primera sesión.
4. Inicia una sesión y pídele a Claude que resuma lo que sabe sobre el proyecto antes de que escriba código.

Mantén CLAUDE.md corto. Nuestra guía sobre el límite de CLAUDE.md en subdirectorios de Claude Code cubre cómo se cargan los archivos de instrucciones más largos.

La migración manual funciona, y el movimiento de Anthropic ayuda a quienes lo reciben. Ambos muestran el mismo patrón: el contexto más útil de un proyecto, las decisiones y restricciones, se sigue reconstruyendo en un nuevo contenedor. La memoria del proyecto de chat, la memoria del proyecto en la nube, CLAUDE.md y la memoria automática son cuatro lugares para hechos que se solapan, y cuando planificas o revisas en ChatGPT o Codex, vuelves a explicar esas decisiones.

MemoryLake es una capa de memoria para mantener esas decisiones en una sola lista que tú gestionas, disponible para Claude Code y los otros asistentes que conectes, como ChatGPT y Codex.

Tú mismo escribes las entradas, con tus propias palabras. No se lee nada de tus proyectos de Claude, ni se escribe o borra nada en ellos, ni en tu memoria de proyecto, memoria automática, archivos CLAUDE.md o cualquier almacenamiento de proveedores. Para contenido de trabajo, sigue la política de tu organización sobre lo que guardas fuera de sus herramientas.

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 la lista de decisiones del Paso 1 de la migración manual: qué se resolvió, el motivo y qué se descartó. Una decisión por entrada, con fecha y etiquetada con el proyecto al que pertenece.

Paso 3: Conecta tu IA y agentes

Conecta Claude Code y los otros asistentes que utilices. La siguiente sesión, en la terminal o en un hilo de la nube, comenzará con las decisiones a su alcance.

La primera diferencia es que la construcción comienza desde el razonamiento del proyecto, no solo desde sus archivos. Claude Code sabe qué se decidió y por qué.

La segunda es que cada pieza aterriza en el lugar correcto. Las reglas del repositorio viven en el repositorio, las notas del proyecto en la memoria del proyecto o la memoria automática, y las preferencias personales siguen siendo personales.

La tercera es que la próxima migración será más fácil. Cuando el despliegue llegue a tus otros proyectos, o muevas el trabajo de un proyecto a ChatGPT, las decisiones ya existirán fuera de cualquier contenedor individual.

Anota las decisiones primero. Son la parte que es más fácil dejar atrás en los chats antiguos.

Revisa la memoria del proyecto después de una migración automática. La lista de migración no la menciona de ninguna manera.

Pon las reglas del repositorio en el repositorio. En el CLAUDE.md raíz, para que tanto los hilos de la nube como las sesiones de terminal lo lean.

Separa el conocimiento del código del contexto de trabajo. Las especificaciones van en el repositorio; las notas de las reuniones no necesitan estar allí.

Mantén las preferencias personales fuera del CLAUDE.md compartido. Usa CLAUDE.local.md o tu archivo de usuario.

Pídele a Claude que reformule el proyecto antes de que construya. Es la comprobación más rápida de que el contexto ha llegado.

Si Claude olvida los archivos del proyecto incluso en el chat, nuestra guía sobre proyectos de Claude que olvidan archivos de conocimiento cubre ese problema.

Un proyecto de Claude contiene instrucciones, archivos de conocimiento, chats y su propia memoria. Anthropic está migrando algunos proyectos existentes a una nueva versión que comienza en Claude Code y afirma que no se pierde nada en el traslado. Su lista de lo que se incluye nombra instrucciones, archivos, historial de chat y tareas programadas. Los nuevos Proyectos no se ejecutan en la CLI de la terminal, y otros proyectos permanecen donde están por ahora.

Ya sea que tu proyecto se migre o lo muevas tú mismo, el trabajo sigue siendo el mismo: anotar las decisiones, poner las reglas del repositorio en CLAUDE.md, revisar qué contiene la memoria y pedirle a Claude que reformule el proyecto antes de que escriba código.