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

Claude Code tiene, según el marco de su propia documentación, "dos sistemas de memoria complementarios. Ambos se cargan al inicio de cada conversación". Uno lo escribes tú, el otro lo escribe Claude. Viajan de manera muy diferente.

Tu CLAUDE.md viaja, con una advertencia sobre las importaciones. Claude Code lee CLAUDE.md dentro de las sesiones de Cowork en tu escritorio. Lo que cambia es cómo maneja las importaciones @ dentro de él. Normalmente, se confía en los archivos de ámbito de usuario: "Excepto en las sesiones de Cowork en tu escritorio, Claude Code carga sus importaciones sin el diálogo y confía en ellas como en el resto de tu configuración personal". Dentro de Cowork, esa confianza se reduce. La documentación lo establece directamente: "En las sesiones de Cowork en tu escritorio, Claude Code omite cualquier importación en un archivo de ámbito de usuario que se resuelva en una ruta fuera del directorio de trabajo de la sesión y carga el resto del archivo".

Lee la última cláusula de nuevo. Carga el resto del archivo. No hay ningún error ni falta nada en el archivo que puedas ver; simplemente obtienes el archivo menos las partes que residían en otro lugar.

Un archivo de memoria personal enlazado simbólicamente no viaja. "En esas sesiones también omite un ~/.claude/CLAUDE.md que sea en sí mismo un enlace simbólico o un enlace físico, y un directorio ~/.claude/rules/ o archivo de reglas enlazado simbólicamente que apunte fuera del directorio de trabajo". Si mantienes un archivo de memoria canónico en un repositorio de dotfiles y lo enlazas simbólicamente en cada máquina (una configuración común y sensata), ese archivo se omitirá en las sesiones de Cowork, no se fusionará.

Ambos casos importan más de lo que parece porque la propia documentación de Claude Code recomienda el patrón que los activa. Para compartir instrucciones personales entre árboles de trabajo (worktrees), el enfoque documentado es una importación desde tu directorio de inicio: - @~/.claude/my-project-instructions.md. Esa ruta se resuelve fuera del directorio de trabajo de la sesión, que es exactamente la condición para ser omitida.

La memoria automática (auto memory) no viaja de ninguna forma. Esta es la mitad que escribió Claude: "aprendizajes y patrones", con un alcance "Por repositorio, compartido entre árboles de trabajo", cargado en cada sesión como "las primeras 200 líneas o 25 KB". Reside en ~/.claude/projects/<project>/memory/ como un índice MEMORY.md más un archivo de tema por memoria, etiquetado como user, feedback, project o reference. Y está anclado a la máquina: "La memoria automática es local de la máquina. Todos los árboles de trabajo y subdirectorios dentro del mismo repositorio de git comparten un directorio de memoria automática. Los archivos no se comparten entre máquinas o entornos en la nube".

La ejecución predeterminada de Cowork es un entorno en la nube. La documentación de la arquitectura dice: "Las sesiones de Cowork se ejecutan en la nube de forma predeterminada: el bucle del agente y la ejecución del código se ejecutan en los servidores de Anthropic, y las sesiones y los archivos se guardan en la cuenta de Claude del miembro", y agrega que "La ejecución local sigue estando disponible para las implementaciones de escritorio existentes". Un almacenamiento local de la máquina y una sesión en la nube no son un problema difícil de resolver; son simplemente dos lugares diferentes, sin nada documentado entre ellos.

Lo que Cowork ofrece en su lugar tiene una forma diferente. Tiene tres capas persistentes, y ninguna de ellas es un archivo en el que puedas soltar un CLAUDE.md:

• Instrucciones globales (Global instructions) son "instrucciones permanentes que se aplican a cada sesión de Cowork", editadas en Configuración bajo Cowork. Un cuadro de texto, no un archivo en tu repositorio.
• Instrucciones de carpeta (Folder instructions) "agregan contexto específico del proyecto a Cowork cuando seleccionas una carpeta local en el escritorio", y vienen con una propiedad que ningún archivo de instrucciones tiene: "Claude también puede actualizarlas por su cuenta durante una sesión".
• Proyectos (Projects) contienen sus propias Instrucciones, Tareas programadas, Contexto y Memoria, donde "La memoria tiene un alcance limitado al proyecto, por lo que lo que Claude aprende en un proyecto no se transfiere a otros". Los proyectos se llenan a mano, no por acumulación: "Cowork no cambiará el contenido de un proyecto, así que agrega tú mismo cualquier cosa que quieras conservar al proyecto".

Un límite más que vale la pena conocer antes de planificar, porque decide si la memoria del proyecto está activa en absoluto: "La memoria se comparte entre el Chat y Claude Cowork cuando Cowork se ejecuta en la nube; las sesiones de Cowork que se ejecutan localmente en tu computadora no usan memoria".

Dos pasos. Ninguno es difícil; el primero es el que la gente suele omitir.

Paso 1: Lee tus archivos de instrucciones de la forma en que los leerá una sesión de Cowork

Abre tu CLAUDE.md y busca cada importación @. Para cada una, hazte una sola pregunta: ¿esta ruta se resuelve dentro de la carpeta en la que trabajará la sesión de Cowork?

Las importaciones que apuntan a archivos en el repositorio (como @README, @package.json, @docs/git-instructions.md) están bien. Las importaciones que apuntan a tu directorio de inicio son las que se descartan. También lo hacen ~/.claude/CLAUDE.md y ~/.claude/rules/ cuando cualquiera de ellos es un enlace simbólico o físico que apunta fuera del directorio de trabajo.

Luego verifica lo mismo para .claude/rules/. La documentación de Claude Code señala que el directorio de reglas "admite enlaces simbólicos, por lo que puedes mantener un conjunto compartido de reglas y enlazarlas en múltiples proyectos", un patrón genuinamente bueno que se menciona específicamente entre las cosas que las sesiones de Cowork omiten.

Cuando se descarta una importación, tienes dos opciones honestas. Integrar el contenido en línea (inline) en un archivo real dentro del repositorio, lo que lo hace visible para tus compañeros de equipo y para el control de versiones. O aceptar la pérdida y volver a expresar esa guía como instrucciones globales de Cowork (Global instructions), que es la capa diseñada para preferencias que se aplican en todas partes. Integrar en línea suele ser mejor para cualquier cosa que beneficie ver a un colega; las instrucciones globales son mejores para las preferencias de cómo trabajas que no tienen por qué estar en un repositorio compartido.

Haz esto antes de empezar a trabajar en Cowork, no después. Una importación recortada produce un resultado que se desvía sutilmente de la convención en lugar de estar obviamente roto, que es el modo de fallo más difícil de detectar.

Paso 2: Mueve la capa escrita y luego decide qué hacer con la aprendida

Para la capa escrita, trabaja de arriba hacia abajo a través de las tres ranuras de Cowork.

Cualquier cosa en tu CLAUDE.md que sea realmente sobre ti (tono, formato de salida, tu rol, restricciones permanentes) pertenece a las instrucciones globales (Global instructions). Cualquier cosa sobre un cuerpo de trabajo específico pertenece a las instrucciones de carpeta (Folder instructions) o al campo de instrucciones de un proyecto (Project's Instructions). Si ya tienes un proyecto de chat de Claude para el mismo trabajo, Cowork puede sembrarse a partir de él: elegir "Importar desde proyecto" significa que "Al hacer clic en 'Crear' se transferirán los archivos e instrucciones de tu proyecto de Claude existente y se creará un nuevo proyecto de Cowork". Ten en cuenta que "la carga masiva no es compatible", por lo que esto se hace un proyecto a la vez.

Para la capa aprendida, no hay importación. Lo que existe es una lectura documentada. La guía de Anthropic para extraer la memoria de Claude es pedirla textualmente: "Escribe mis recuerdos textualmente, exactamente como aparecen en tu memoria". Eso es una lectura, no una transferencia; produce texto que luego colocas tú mismo en algún lugar. Ten en cuenta también que esta es la memoria a nivel de cuenta, que es un almacenamiento diferente de los archivos ~/.claude/projects/<project>/memory/ en tu máquina; esos los lees directamente, ya que son markdown simple.

Dos advertencias aquí. Primero, la gestión de memoria en Claude incluye una acción de Restablecer memoria (Reset memory) que "Elimina permanentemente todos los recuerdos, incluidos los recuerdos del proyecto" y "esto no se puede deshacer"; lee antes de ordenar. Segundo, si un proyecto a nivel de carpeta te importa, ten en cuenta que las propias páginas de Anthropic actualmente describen el almacenamiento de proyectos de manera diferente en dos lugares: el artículo de Proyectos indica que "Los proyectos son solo para escritorio y se almacenan localmente. No hay sincronización en la nube para los datos del proyecto en este momento", mientras que la página de disponibilidad de interfaces muestra los Proyectos disponibles en escritorio, web y móvil con la advertencia de que "Los proyectos vinculados a una carpeta local admiten sesiones de Cowork solo en escritorio". Ambas páginas están vigentes. Verifica el comportamiento en tu propia cuenta en lugar de asumir que cualquiera de las descripciones cubre tu configuración.

El Paso 1 y el Paso 2 se encargan de la mitad con forma de archivo. La mitad que no tiene ruta de importación es la que más tiempo tomó construir: las correcciones que le diste a Claude a lo largo de los meses, las preferencias que infirió, los hechos del proyecto que no se pueden derivar del código. En Claude Code, eso vive en un directorio local de la máquina. En Cowork, viviría en un almacenamiento a nivel de cuenta que solo se aplica cuando las sesiones se ejecutan en la nube. Ninguno es un lugar que puedas entregar al otro.

La solución no es elegir uno de ellos, sino mantener esa capa fuera de ambos. MemoryLake es una capa de memoria de tu propiedad, leída por cualquier asistente que uses a través de una API en lugar de a través del almacenamiento privado de un solo producto. Tres pasos.

Paso 1: Crea una clave API

Inicia sesión y crea una clave API desde la configuración de tu espacio de trabajo. Te pertenece a ti, no a una interfaz, por lo que moverte entre la terminal y el escritorio no la invalidará.

Paso 2: Sube tus primeros recuerdos

Comienza con el contenido que acabas de extraer, además de las importaciones que tuviste que integrar en línea en el paso de migración. Preferencias y estilo de trabajo. Correcciones que se repiten constantemente. Hechos del proyecto que Claude no podría derivar del código: por qué un servicio está estructurado de la manera en que lo está, qué enfoque ya rechazó el equipo, de qué depende realmente una fecha límite. Los archivos se ingresan tal como están, y se manejan los multimodales, por lo que un diagrama de arquitectura o una hoja de cálculo que codifique una convención se pueden ingresar directamente.

Paso 3: Conecta tu IA y agentes

Conecta Claude Code, Cowork y cualquier otra cosa en la rotación. A partir de ese momento, la capa aprendida se lee desde un solo lugar en vez de reconstruirse por interfaz, y cambiar entre la terminal y la aplicación de escritorio deja de restablecerla.

Tres límites, expresados claramente. MemoryLake no puede leer, exportar ni eliminar la memoria de Claude; por eso la lectura en el Paso 2 de la migración manual es un paso manual. No cambia la forma en que Cowork recorta las importaciones externas; ese comportamiento es de Claude Code y se aplica independientemente. Y no es un reemplazo para CLAUDE.md, que sigue siendo el lugar adecuado para las instrucciones que deben estar en el repositorio donde los compañeros de equipo puedan verlas.

El cambio inmediato es que la migración deja de tener pérdidas que notas tres semanas después. Tus instrucciones llegan intactas porque integraste en línea las partes que se habrían recortado, y la capa aprendida llega porque se está leyendo desde un lugar al que ambas interfaces pueden acceder.

El cambio más importante es que la elección de la interfaz se vuelve reversible. Las sesiones en la nube de Cowork son efímeras por diseño: "Cada sesión tiene su propio sandbox, creado cuando comienza la sesión y destruido cuando termina, y los sandboxes no comparten el estado entre sí ni entre organizaciones", lo cual es la postura de seguridad correcta y también significa que la sesión no es el lugar donde se acumula nada. Una vez que la capa duradera es externa, un sandbox efímero no te cuesta nada, y volver a la terminal durante una semana tampoco te cuesta nada.

También elimina una molestia recurrente específica para cualquiera que trabaje en más de una máquina. El hecho de que la memoria automática sea local de la máquina está documentado y es deliberado, pero significa que la computadora portátil sabe cosas que la de escritorio no sabe, el mismo problema tratado en por qué Claude Code olvida entre máquinas. Una capa externa se lee de la misma manera desde cualquiera de las dos.

Mantén CLAUDE.md para instrucciones, no para aprendizajes. La documentación de Claude Code es explícita en que Claude "omite cualquier cosa que tus archivos CLAUDE.md ya digan" al escribir la memoria automática. Duplicar los aprendizajes en el archivo de instrucciones empeora ambas capas.

Integra en línea, no importes, cualquier cosa que necesites dentro de una sesión de Cowork. Una regla para recordar en lugar de un modelo mental de resolución de rutas.

Trata las instrucciones de carpeta (Folder instructions) como un campo compartido, no como tu campo. Claude puede actualizarlas durante una sesión. Eso es útil, y significa que cualquier cosa que no debas perder pertenece a un lugar donde Claude tampoco escriba.

Coloca las cosas en un proyecto (Project) deliberadamente. Cowork no las agregará por ti.

Verifica si tus sesiones de Cowork se ejecutan en la nube antes de confiar en la memoria del proyecto. La memoria se aplica cuando Cowork se ejecuta en la nube; las sesiones locales no la usan.

Vuelve a leer tus archivos de instrucciones trimestralmente. La propia guía de Claude Code advierte que las reglas contradictorias significan que "Claude puede elegir una arbitrariamente". Dos interfaces que leen los mismos archivos duplican el costo de uno desactualizado. Una revisión periódica de lo que tus asistentes realmente recuerdan vale la pena por los veinte minutos.

Mismo proveedor, misma arquitectura y, aun así, una migración real, porque las partes interesantes de la memoria de Claude Code son un directorio local de la máquina y un gráfico de importación que llega fuera del repositorio, y el límite de sesión de Cowork trata a ambos de manera diferente. Corrige las importaciones antes de cambiar, mueve la capa escrita a las tres ranuras que realmente tiene Cowork, extrae la capa aprendida a mano y luego coloca esa capa aprendida en algún lugar que ninguna de las dos interfaces posea. Después de eso, qué interfaz uses es una preferencia en lugar de un reinicio.