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

Tu CLAUDE.md se transfiere tal cual, de forma condicional. Explicado anteriormente. Trátalo como un período de gracia en lugar de un destino final: funciona hasta que aparece un AGENTS.md en el mismo directorio.

El modelo de carga es lo suficientemente cercano como para ser tranquilizador. Claude Code carga "los archivos CLAUDE.md y CLAUDE.local.md en la jerarquía de directorios por encima del directorio de trabajo... al inicio", mientras que "los archivos en los subdirectorios se cargan bajo demanda cuando Claude lee archivos en esos directorios". Amp es casi idéntico: "los archivos AGENTS.md en el directorio de trabajo actual (o raíces del espacio de trabajo del editor) y directorios padres (hasta $HOME) siempre se incluyen", y "los archivos AGENTS.md del subárbol se incluyen cuando el agente lee un archivo en el subárbol".

Misma estructura, misma carga diferida (lazy loading) sobre los subárboles. Esta mitad de tu modelo mental sobrevive.

Los alcances personales y del sistema existen en ambos lados, en rutas diferentes. Claude Code tiene cuatro alcances documentados en orden de carga: política gestionada, usuario (~/.claude/CLAUDE.md), proyecto y ./CLAUDE.local.md. Amp tiene archivos de repositorio más "$HOME/.config/amp/AGENTS.md" y "$HOME/.config/AGENTS.md" para "preferencias personales, comandos específicos del dispositivo y pautas que estás probando localmente antes de confirmar", además de archivos para todo el sistema en /etc/ampcode/AGENTS.md, /Library/Application Support/ampcode/AGENTS.md o %ProgramData%\ampcode\AGENTS.md para "pautas para todo el sistema o gestionadas por la organización para todas las sesiones de Amp".

Todos los archivos de Amp que no son del repositorio "siempre se incluyen si existen". Así que tu contenido de alcance de usuario se mapea limpiamente; la ruta cambia y la carga es incondicional en ambos lados.

Las reglas condicionales se transfieren y mejoran. Esta es la verdadera mejora. Claude Code delimita el alcance de las instrucciones con un campo paths en el frontmatter de .claude/rules/, donde "las reglas con alcance de ruta se activan cuando Claude lee archivos que coinciden con el patrón". Amp hace el mismo trabajo a través de archivos mencionados con @ que llevan una lista globs: "los archivos mencionados con globs solo se incluirán si Amp ha leído un archivo que coincida con alguno de los globs".

Dos cosas que debes saber al convertir. Una mención simple es incondicional — "Si no se especifican globs, el archivo siempre se incluye cuando se menciona con @" — por lo que el frontmatter es todo el propósito. Y la resolución de globs tiene su propia regla: "Los globs se prefijan implícitamente con **/ a menos que comiencen con ../ o ./, en cuyo caso se refieren a rutas relativas al archivo mencionado".

La sintaxis de importación cambia de significado, no solo de escritura. El @path/to/import de Claude Code extrae un archivo al inicio: "Los archivos importados se expanden y se cargan en el contexto al inicio junto con el CLAUDE.md que los referencia", con "una profundidad máxima de cuatro saltos". Las menciones con @ de Amp se ven iguales y pueden ser condicionales. Ambos omiten los bloques de código — el análisis de importación de Claude Code "omite los fragmentos de código Markdown y los bloques de código delimitados", las menciones con @ de Amp "en bloques de código se ignoran para evitar falsos positivos" — por lo que una ruta entre comillas invertidas sigue siendo literal en ambos.

Una diferencia a tener en cuenta: "Las rutas relativas se interpretan en relación con el archivo del agente que contiene la mención", no con tu directorio de trabajo. Claude Code se resuelve de la misma manera, por lo que una copia directa suele funcionar, pero un archivo que muevas un nivel hacia arriba o hacia abajo romperá sus propias menciones.

La memoria automática (auto memory) no se transfiere. No hay nada en qué transferirla. Claude Code ejecuta dos sistemas, no uno. Junto con los archivos que escribes, "la memoria automática permite a Claude acumular conocimiento a lo largo de las sesiones sin que tengas que escribir nada", etiquetado por tipo: user para "tu rol, experiencia y preferencias de trabajo", feedback para "correcciones que le das a Claude y enfoques que confirmas", project para "trabajo en curso, plazos y decisiones que Claude no puede derivar del código o del historial de git", y reference para referencias externas.

Está activada por defecto, reside en archivos locales bajo ~/.claude/projects/<project>/memory/ con un índice MEMORY.md, su alcance es "por repositorio, compartido entre árboles de trabajo (worktrees)", y la porción cargada está limitada: "cada sesión (las primeras 200 líneas o 25 KB)".

La persistencia documentada de Amp son los archivos AGENTS.md que escribes más los hilos (threads), y los hilos son conversaciones en lugar de un almacén; no existe un equivalente documentado para un directorio de memoria que se escribe a sí mismo. Así que la mitad de tu configuración de Claude Code que se acumuló por sí sola —las correcciones que diste, las preferencias que infirió— no tiene destino.

Los hilos no son una capa de memoria, y Amp no pretende que lo sean. Están genuinamente bien diseñados para la continuidad del trabajo: un hilo tiene una URL, "el mismo hilo se abre en la aplicación web, la CLI, las aplicaciones de Amp para iOS y macOS", y "el lugar donde se ejecuta el agente es independiente de donde lo miras". La recomendación es un hilo por tarea, porque "un hilo que mezcla trabajo no relacionado le da al agente un peor contexto para razonar", con una vía de escape documentada cuando uno crece: "pídele al agente 'Handoff and...' (Transferir y...) y comenzará un hilo nuevo con el contexto que importa".

Útil. Pero tampoco es un lugar para guardar hechos, ya que una transferencia lleva lo que el agente consideró relevante en lugar de todo lo que es verdadero sobre tu proyecto.

Paso 1: Renombrar deliberadamente, luego dividir por activador

No confíes en la alternativa. Crea archivos AGENTS.md reales en las mismas rutas que ocupan tus archivos CLAUDE.md, para que el comportamiento sea explícito en lugar de depender de que nadie agregue un archivo más tarde.

Luego divide, porque Amp te lo pide: "En un repositorio grande con múltiples subproyectos, recomendamos mantener el AGENTS.md de nivel superior general y crear archivos AGENTS.md más específicos en subárboles para cada subproyecto". Claude Code daba el mismo consejo desde la otra dirección: "apunta a menos de 200 líneas por archivo CLAUDE.md. Los archivos más largos consumen más contexto y reducen la adherencia", por lo que si ya estabas por debajo de ese límite, esto es principalmente una copia.

A continuación, convierte tus entradas de .claude/rules/. Una regla con un campo paths se convierte en un archivo referenciado desde AGENTS.md con una lista globs en su frontmatter. Una regla sin este campo se cargaba incondicionalmente, por lo que pertenece al archivo general en lugar de ser una mención simple.

Mueve el contenido de ~/.claude/CLAUDE.md a $HOME/.config/amp/AGENTS.md. Para cualquier cosa que estuviera en CLAUDE.local.md —"preferencias personales específicas del proyecto" que mantuviste fuera del control de versiones— los archivos $HOME/.config de Amp son el hogar más cercano, con la diferencia de que se aplican en todas partes en lugar de a un solo proyecto.

Luego verifica, con el comando diseñado para ello: "Para ver los archivos de agente que Amp está usando, selecciona agents-md list en la paleta de comandos". Ejecútalo desde un par de directorios y después de que el agente haya leído diferentes tipos de archivos. Eso es el equivalente a revisar /context para Memory files en Claude Code, y es cómo detectas una mención cuya ruta relativa se rompió en el traslado.

Paso 2: Lee tu memoria automática antes de dejar de usar Claude Code

Este paso no tiene herramientas y es el que la gente suele saltarse.

Abre ~/.claude/projects/<project>/memory/. Los archivos son markdown simple con un índice MEMORY.md, y son legibles precisamente porque Claude los escribió para sí mismo. Léelos.

Lo que encuentres será el residuo de meses de correcciones, y vale la pena clasificarlos a medida que avanzas. Los elementos que parecen instrucciones —una preferencia de formato, una regla que seguías repitiendo— se convierten en contenido en tu nuevo AGENTS.md o en un archivo con alcance de glob. Los elementos que parecen hechos sobre el proyecto —un plazo, una decisión y su motivo, por qué existe una solución temporal— no pertenecen en absoluto a un archivo de instrucciones, y volveremos a ellos más adelante.

Ten en cuenta también lo que Claude Code deliberadamente no registró, porque cambia lo que deberías esperar encontrar: "Claude omite cualquier cosa que pueda derivar de la base de código" y "también omite cualquier cosa que tus archivos CLAUDE.md ya digan". Así que la memoria automática es el complemento de tus archivos, no un duplicado de ellos. Todo lo que hay allí es algo que el código no puede decirte, que es la misma razón por la que es la parte que más vale la pena rescatar, y el patrón detrás de por qué Claude Code olvida el contexto del proyecto cuando esos archivos se pierden.

El cambio de nombre es mecánico y la conversión de globs es una mejora. Lo que hace que esta migración cueste tiempo real es la mitad acumulada, y volverás a pagar ese precio en el próximo cambio, porque lo que se acumuló estaba almacenado dentro de una herramienta.

El propio enfoque de Claude Code señala el porqué. Separa lo que escribes de lo que el agente aprende, y trata a ambos como contexto en lugar de configuración: "Claude los trata como contexto, no como configuración obligatoria". Amp conserva la primera categoría y descarta la segunda. Ninguna herramienta está equivocada; la categoría simplemente necesita un hogar que no sea una herramienta.

Coloca la mitad acumulativa en una capa de memoria y la migración se reducirá a un cambio de nombre. MemoryLake se configura en tres pasos.

Paso 1: Crear una clave API

Inicia sesión y genera una clave API desde tu panel de control. No es una configuración del editor ni un directorio local del agente, por lo que no tiene la propiedad que inició esta migración: nada en ella es una alternativa que otro archivo pueda superar silenciosamente.

Paso 2: Subir tus primeras memorias

Aquí es donde va el segundo grupo del Paso 2: decisiones y sus motivos, plazos, vocabulario del dominio, por qué existe una solución temporal, las correcciones que ya has dado más de una vez.

Deja el comportamiento en AGENTS.md, delimitado con globs donde se ajuste un patrón. Las dos capas hacen trabajos diferentes, y mezclarlas es la razón por la que un archivo de instrucciones crece más allá del punto de ser seguido.

Paso 3: Conectar tu IA y agentes

Apunta Amp al almacén. Tus archivos AGENTS.md se mantienen cortos y enfocados en el comportamiento, un nuevo hilo comienza a partir de los hechos de tu proyecto en lugar de un resumen de transferencia, y el conocimiento sobrevive a la próxima herramienta que evalúes, el argumento presentado en memoria entre agentes.

El primer cambio es que la alternativa deja de ser fundamental para la carga. Archivos AGENTS.md explícitos más un almacén externo significan que ninguna parte de tu configuración depende de que un archivo no exista.

El segundo es que perder la memoria automática cuesta menos. Era una buena característica y que Amp no la tenga es una verdadera brecha, pero solo para el conocimiento que no tiene otro lugar donde vivir.

El tercero es que las pautas con alcance de glob pueden mantenerse pequeñas. La carga condicional de Amp es genuinamente mejor que un archivo siempre activo, y funciona mejor cuando lo que estás restringiendo son instrucciones en lugar de un archivador de hechos del proyecto, el razonamiento en reducir el uso de tokens con una capa de memoria.

• Crea archivos AGENTS.md reales. La alternativa de CLAUDE.md se aplica solo donde no existe un AGENTS.md.
• Divide el archivo raíz. Amp recomienda un archivo general de nivel superior con archivos de subárbol específicos.
• Convierte paths a globs. Y recuerda que una mención simple con @ es incondicional.
• Ten en cuenta la resolución de globs. Prefijo implícito **/ a menos que el patrón comience con ./ o ../.
• Verifica las rutas de mención después de mover archivos. Se resuelven en relación con el archivo que contiene la mención.
• Lee primero tu directorio de memoria automática. Markdown simple, indexado por MEMORY.md, y nada lo exporta.
• Verifica con agents-md list. Desde varios directorios, después de tocar diferentes tipos de archivos.
• No trates los hilos como almacenamiento. Un hilo por tarea, y una transferencia lleva lo que el agente consideró relevante.

Que Amp lea CLAUDE.md hace que esta parezca la migración más fácil de la categoría, y para la mitad de los archivos casi lo es, con un modelo de carga condicional que mejora lo que tenías.

La mitad que duele es la mitad que se escribió sola. Claude Code acumuló tus correcciones en markdown local; Amp no tiene esa capa y ningún importador vendrá a rescatarla. Lee ese directorio antes de dejarlo, separa las instrucciones de los hechos y coloca los hechos en un lugar que el próximo cambio de herramienta no pueda afectar.