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

Tus archivos CLAUDE.md: vinculados, no convertidos. El comando /init de Warp vincula CLAUDE.md directamente, junto con otros seis formatos: "CLAUDE.md, .cursorrules, AGENT.md, GEMINI.md, .clinerules, .windsurfrules, .github/copilot-instructions.md". Vinculación, no detección. Un repositorio lleno de archivos CLAUDE.md no hace nada hasta que lo vinculas.

Tus habilidades (skills) — con un cambio de directorio. Claude Code lee .claude/skills/; Warp lee las habilidades del proyecto desde .agents/skills/ y las habilidades personales desde ~/.agents/skills/, navegables con /skills. La estructura de SKILL.md es la misma. Esto es un traslado, no una reescritura.

Tus servidores MCP — dos veces, si usas ambas interfaces. Warp señala que "Las reglas y habilidades no necesitan migración: tanto la CLI como la aplicación Warp las descubren desde las mismas ubicaciones de archivos", pero MCP es la excepción: "La CLI mantiene su propia configuración de servidor MCP, independiente de la de la aplicación Warp", en ~/.warp_cli/.mcp.json en macOS.

Comprensión del código base — reconstruida, no trasladada. El Codebase Context de Warp "indexa tu código base rastreado por Git", y la documentación indica que "No se almacena código en los servidores de Warp". Vuelves a indexar; no hay nada que exportar.

Lo que no se transfiere: todo lo que Claude escribió sobre tu trabajo. La memoria automática de Claude Code registra cuatro tipos de notas, etiquetadas por un campo type en el frontmatter de cada archivo: user (tu rol, experiencia y preferencias de trabajo), feedback (correcciones que le haces a Claude y enfoques que confirmas), project (trabajo en curso, plazos y decisiones que Claude no puede deducir del código o del historial de git) y reference (dónde encontrar información fuera del proyecto). Está activada por defecto, por lo que si has usado Claude Code en un repositorio durante cualquier período de tiempo, este directorio existe lo hayas mirado o no.

No hay exportación. No hay importación en el otro lado. Y las notas que más valen son las de feedback y project, precisamente las categorías que, como señalan los documentos de Anthropic, Claude omite escribir cuando puede deducirlas del código base.

También desaparece: las reglas con alcance de ruta como mecanismo. El directorio .claude/rules/ de Claude Code permite que las instrucciones se carguen solo cuando Claude toca archivos coincidentes. El equivalente de Warp es la ubicación: un archivo AGENTS.md en un subdirectorio. Esa es una herramienta más tosca, y el comportamiento de carga tiene un detalle que vale la pena conocer antes de confiar en él, el cual se cubre en la siguiente sección.

Paso 1: Lee el directorio de memoria automática antes de dejar de abrir Claude Code

Este es un ejercicio de lectura, y es el único paso que no se puede volver a hacer más tarde.

Tus notas están en ~/.claude/projects/<project>/memory/. La ruta <project> se deriva del repositorio de git, por lo que cada árbol de trabajo (worktree) del mismo repositorio comparte un único directorio. En su interior encontrarás un índice MEMORY.md —"una línea por memoria, cargada en cada sesión"— además de un archivo de tema por cada memoria.

Abre primero MEMORY.md; es la tabla de contenidos que Claude mantiene para sí mismo. Luego abre los archivos de tema a los que apunta. Dos notas prácticas: los documentos de Anthropic indican que solo "Las primeras 200 líneas de MEMORY.md, o los primeros 25 KB, lo que ocurra primero, se cargan al inicio de cada conversación", y que el contenido que supera ese umbral "no se carga al inicio de la sesión"; por lo tanto, si tu índice es largo, parte de él ha estado inactivo durante un tiempo y lo estás leyendo correctamente por primera vez. Los archivos de tema nunca se cargan al inicio; Claude "los lee bajo demanda".

Clasifica lo que encuentres en tres grupos a medida que avanzas:

• Ya está en CLAUDE.md. Omítelo. Se vincula directamente de forma gratuita.
• Deducible del repositorio. Omítelo también. Warp indexará el código.
• Ninguno de los anteriores. Este es tu verdadero cargamento de migración: las correcciones que hiciste, las decisiones con sus razones asociadas, los plazos, los enlaces a sistemas fuera del repositorio. Cópialo en algún lugar antes de continuar.

No borres nada. Anthropic excluye el directorio de memoria de su barrido de retención de transcripciones —"MEMORY.md y los archivos de tema permanecen hasta que tú o Claude los editen o eliminen"— por lo que dejar Claude Code instalado no te cuesta nada y mantiene el original legible.

Paso 2: Coloca la mitad escrita y luego configura correctamente el modelo de carga

Ejecuta /init en Warp desde la raíz del repositorio y elige vincular tu CLAUDE.md existente. Luego asegúrate de hacer bien tres cosas, porque cada una de ellas puede fallar silenciosamente.

El nombre del archivo distingue entre mayúsculas y minúsculas. La documentación de Warp incluye esto como una Advertencia: "El nombre del archivo debe estar en mayúsculas para que Warp lo reconozca (por ejemplo, AGENTS.md, no agents.md o Agents.md)". Un archivo en minúsculas no se considerará un archivo de reglas y no habrá ningún error.

Solo se cargan automáticamente dos ubicaciones. "Warp aplica automáticamente el archivo AGENTS.md (or WARP.md) en la raíz y en el directorio actual". Para cualquier otra ubicación, "Warp hace un intento de mejor esfuerzo para incluir también el archivo de reglas de ese subdirectorio", condicionado a que edites archivos allí. Si una regla debe aplicarse a todo el repositorio, el archivo raíz es el único hogar garantizado.

El archivo más específico gana. Warp resuelve los conflictos priorizando primero el subdirectorio actual, luego la raíz y finalmente las Reglas Globales, con la intención declarada de que "las reglas más específicas y relevantes para el proyecto tengan prioridad sobre las más generales". Viniendo de .claude/rules/, donde el alcance era declarativo, este es el cambio a vigilar: un archivo de subdirectorio desactualizado ahora tiene prioridad sobre un estándar raíz nuevo, solo en ese directorio.

Luego mueve .claude/skills/ a .agents/skills/, configura los servidores MCP para cualquiera de las interfaces que uses (la aplicación o la CLI) y ejecuta /index para compilar el Codebase Context.

Una cosa que Warp te ofrece y Claude Code no: verificación. "Las reglas utilizadas en una interacción aparecerán en la conversación bajo References (Referencias) o marcadas como derivadas de una regla específica". Úsalo una vez con una regla que sepas que debería activarse, para que aprendas cómo se ve una regla cargada antes de que necesites depurar una.

Eso cubre la mitad escrita por completo. La mitad aprendida todavía no tiene adónde ir.

Warp tiene una respuesta para esto, y vale la pena entenderla incluso si aún no puedes usarla.

Agent Memory se describe como "un sistema de memoria persistente que vive en Warp y se comparte entre todos los entornos de agentes compatibles, incluidos el Warp Agent integrado, Claude Code, Codex y otros a medida que se agreguen". Las memorias se organizan en almacenes (stores) —personales, propiedad del agente o propiedad del equipo— vinculados a agentes específicos con acceso de solo lectura o lectura y escritura e instrucciones requeridas por almacén. Cada memoria "registra de dónde proviene", cada cambio se registra para su inspección, y la creación y recuperación se ejecutan en segundo plano para que "no consuman tokens ni agreguen latencia a la tarea activa".

Se indican tres límites con la misma claridad. Está "en vista previa de investigación (research preview) y se habilita por equipo para socios de diseño", con una lista de espera. Los entornos de terceros solo se cubren cuando se ejecutan como agentes en la nube: "La ejecución local de entornos de terceros no es compatible durante la vista previa de investigación". Y el acceso programático a la API y el autoalojamiento (self-hosting) figuran en la sección "Próximamente".

Por lo tanto: un buen diseño, que va en la dirección correcta, no disponible para el público general y que aún no es accesible desde una sesión local de Claude Code. Si tu equipo es un socio de diseño, úsalo; ese es el camino nativo.

Si no lo eres, aún necesitas que la mitad aprendida aterrice en algún lugar, y eso es lo que hace MemoryLake: una capa de memoria que se sitúa fuera de cualquier herramienta individual, de modo que las notas que rescataste en el Paso 1 sean legibles desde Warp hoy y desde lo que sea que uses a continuación. La configuración consta de tres pasos.

Paso 1: Crea una clave de API

Inicia sesión y crea una clave de API. Una sola credencial para todas las herramientas que conectes.

Paso 2: Sube tus primeras memorias

Entradas cortas, una afirmación cada una. Tu material de origen es el tercer grupo del Paso 1, y los propios tipos de notas de Claude Code son una buena guía de clasificación:

Correcciones que funcionaron. La categoría feedback de Claude Code: los enfoques que rechazaste y los que confirmaste. Este es el grupo de mayor valor y el que no tiene equivalente en ningún lugar del modelo de reglas de Warp.

Decisiones con sus razones. "Las migraciones son solo de adición porque la réplica de lectura se retrasa bajo carga". La instrucción pertenece a AGENTS.md; la razón pertenece aquí, y es lo que evita que la regla se revierta el próximo trimestre.

Contexto de trabajo que no es código. Plazos, prioridades actuales, quién es el propietario de cada servicio: la categoría project de Claude Code, que sus documentos describen como cosas que Claude "no puede deducir del código o del historial de git".

Enlaces externos. El panel de control, el rastreador de problemas, el manual de procedimientos (runbook): la categoría reference.

Paso 3: Conecta tu IA y agentes

Conecta lo que uses. MemoryLake es accesible a través de MCP y de una API, y Warp admite servidores MCP (recordando que la aplicación y la CLI mantienen configuraciones MCP independientes, por lo que las configuraciones compartidas deben configurarse dos veces). Claude Code, Codex, Cline y OpenClaw se conectan de la misma manera, y cualquier otra herramienta lee la misma memoria a través de la API.

Tres límites honestos. MemoryLake no puede leer, exportar ni eliminar la memoria automática de Claude Code: no existe una API para ese directorio, por lo que el Paso 1 es una lectura manual. No escribe tu AGENTS.md ni tus Reglas Globales; el comportamiento de carga descrito anteriormente es de Warp, y una capa de memoria no lo cambia. Y la memoria es contexto, no imposición: los propios documentos de Anthropic señalan lo mismo sobre CLAUDE.md y la memoria automática, que Claude "los trata como contexto, no como una configuración obligatoria". Cualquier cosa que deba cumplirse estrictamente cada vez pertenece a una verificación que falle la ejecución.

La migración de reglas toma minutos, no una tarde. El comando /init vincula CLAUDE.md en su lugar.

La mitad aprendida deja de ser invisible. Lees el directorio una vez, deliberadamente, en lugar de descubrir meses después que existía.

Lo local de la máquina deja de ser el valor predeterminado. La memoria automática de Claude Code explícitamente no se comparte entre máquinas; lo que traslades fuera de ella, sí.

La depuración de reglas obtiene una respuesta real. La sección References (Referencias) muestra lo que realmente se activó, algo que CLAUDE.md nunca hizo.

La próxima migración es más barata. El conocimiento ya no está dentro del directorio de inicio de ninguna de las dos herramientas.

Lee MEMORY.md antes de cambiar, no después. Se carga en cada sesión de Claude Code y es el índice de todo lo demás.

Vincula en lugar de duplicar. El comando /init vincula siete formatos externos. Dos copias de las mismas reglas se desvían en menos de un mes.

Verifica el uso de mayúsculas en el nombre del archivo de inmediato. Todo en mayúsculas o no existirá. Es el fallo silencioso más común en el sistema de reglas de Warp.

Coloca las reglas de todo el repositorio en el archivo raíz. La raíz y el directorio actual se cargan automáticamente; todo lo demás es de mejor esfuerzo.

Audita los archivos de los subdirectorios en busca de anulaciones obsoletas. El archivo más específico gana, y los archivos antiguos siguen siendo específicos.

Verifica con References (Referencias) una vez por cada regla que te interese. Lo que se cargó es un hecho; lo que escribiste es una intención.

Mantén el razonamiento fuera del archivo de reglas. Las reglas se aplican en el momento de la solicitud y compiten por el contexto; la estructura general se detalla en lo que realmente leen los agentes de programación.

No trates las habilidades (skills) como memoria. Son procedimentales y estables; la memoria se escribe a medida que trabajas. La distinción se encuentra en por qué las habilidades de los agentes no son memoria.

Esta es una de esas raras migraciones en las que el destino te recibe a mitad de camino. El comando /init de Warp vincula CLAUDE.md directamente, tus habilidades se trasladan cambiando el nombre de un directorio y el Codebase Context se reconstruye a partir del repositorio. Si tu contexto vivía completamente en archivos que escribiste, habrás terminado en una tarde, y lo único que debes hacer bien es el nombre del archivo en mayúsculas, el modelo de carga de raíz frente a subdirectorio y la precedencia de que el archivo más específico gana.

Lo que no te acompaña es la mitad que escribió Claude. La memoria automática está activada por defecto, guarda tus correcciones y el estado de tu proyecto en ~/.claude/projects/<project>/memory/, es local de la máquina por diseño y no hay opción de exportación. Agent Memory de Warp tiene la estructura adecuada para ese conocimiento —multientorno, con seguimiento de origen, acceso por agente— pero es una vista previa de investigación limitada a equipos de socios de diseño, y durante la vista previa no cubre entornos de terceros que se ejecuten localmente.

Así que lee el directorio de memoria antes de dejar de abrir Claude Code, conserva las correcciones y decisiones que no estén en tu CLAUDE.md ni sean deducibles del código, y colócalas en una capa que no esté atada al directorio de inicio de una sola herramienta. Las reglas se vincularán en minutos. El razonamiento es la parte que solo tú puedes trasladar, y la razón por la que se perdió en primer lugar se explica en por qué Claude Code olvida entre máquinas.