MemoryLake
Volver a todos los artículos
Tutorial30 de julio de 2026·7 min de lectura

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

Has decidido trasladar tu trabajo diario de programación de GitHub Copilot a Claude Code. La instalación toma minutos. La parte de la que nadie te advierte es que todo lo que Copilot había absorbido sobre tu base de código (tus convenciones, las razones detrás de tres decisiones arquitectónicas, los módulos que son seguros de refactorizar y el que absolutamente no lo es) no viene con él.

Aquí está la respuesta directa: no hay un botón de exportación, porque la mayor parte de lo que intentas mover nunca se almacenó como datos de tu propiedad. La capa duradera de Copilot es un pequeño conjunto de archivos de instrucciones en tu repositorio, y esos se migran en una tarde. El resto vivía en sesiones de chat que terminan cuando las cierras. Por lo tanto, una migración limpia significa migrar los archivos, reescribir deliberadamente el conocimiento tácito y luego (la parte que realmente te evita tener que hacer esto de nuevo) colocar ese conocimiento en un lugar que ninguna de las dos herramientas posea.

Esta guía cubre los tres pasos, en orden.

Por qué cambiar de agentes de programación te hace perder el contexto

La memoria de Copilot es más delgada de lo que parece

Después de meses de uso, parece que Copilot conoce tu proyecto. Lo que realmente tiene, por sesión, son los archivos que tienes abiertos, lo que puede recuperar del repositorio y tus archivos de instrucciones. Las instrucciones personalizadas a nivel de repositorio (como .github/copilot-instructions.md y los archivos de instrucciones y prompts por ámbito que lo acompañan) son reales, portables y están bajo control de versiones. Todo lo demás es inferencia realizada desde cero, además de un historial de chat que es una transcripción, no una base de conocimientos. Los desarrolladores se topan con los límites de esto constantemente; el funcionamiento interno se detalla en por qué GitHub Copilot olvida el contexto de tu base de código.

La parte valiosa nunca se escribió

El conocimiento costoso es el que solo produjiste en la conversación: por qué el módulo de pagos tolera escrituras duplicadas, qué suite de pruebas miente, que el intento anterior de extraer el servicio de autenticación falló y por qué. Le explicaste esas cosas a Copilot en el chat. No hay ningún archivo que copiar, ni un formato de exportación que los capturara si lo hubiera.

Claude Code también es sin estado (stateless)

Esta es la parte que la mayoría de las guías de migración omiten. Claude Code comienza cada sesión desde cero. Lee CLAUDE.md en la raíz de tu proyecto y tu ~/.claude/CLAUDE.md a nivel de usuario, y puede acceder a cualquier herramienta que conectes a través de MCP, pero la sesión en sí no acumula nada que sobreviva a ella. Si cambias de herramienta sin cambiar cómo se almacena tu contexto, te enfrentarás al mismo problema con una interfaz diferente, como describe en detalle el olvido del contexto del proyecto por parte de Claude Code.

Cambiar de herramientas es un cambio de interfaz. Solo cambiar dónde vive tu contexto es un cambio de situación.

La migración manual

Paso 1: Recopila lo que Copilot realmente contiene

Revisa tu repositorio y reúne las piezas portables:

  • .github/copilot-instructions.md: tus instrucciones para todo el repositorio
  • Cualquier archivo de instrucciones con ámbito y archivos de prompts reutilizables que hayas acumulado
  • Configuraciones del editor que codifican convenciones, como la configuración del linter y del formateador
  • Cualquier cosa que hayas fijado en una wiki, carpeta de ADR o documento de incorporación (onboarding)

Luego haz el inventario más difícil. Abre tus chats de Copilot de las últimas dos semanas y anota cada fragmento de contexto que tuviste que explicar más de una vez. Esa repetición es tu auditoría de memoria: lo que sea que tuviste que volver a escribir repetidamente es precisamente lo que nunca se almacenó.

Paso 2: Reconstrúyelo donde Claude Code pueda leerlo

Claude Code lee CLAUDE.md, así que empieza por ahí. Migra el contenido de las instrucciones y luego estructúralo para que siga siendo útil a medida que crezca:

  • Estructura del proyecto: cuáles son los servicios, qué se comunica con qué, qué está en desuso
  • Convenciones: nomenclatura, manejo de errores, expectativas de pruebas, normas de commit y revisión
  • Decisiones con motivos: no "usar Postgres" sino "Postgres, porque los workers en modo cola rompieron el estado en proceso"
  • Trampas: la suite de pruebas inestable, el módulo con acoplamiento oculto, la migración que debe ejecutarse en orden

Mantén las preferencias a nivel de usuario en ~/.claude/CLAUDE.md y los datos del proyecto en el archivo del repositorio, para que tus compañeros de equipo hereden la parte del proyecto sin tu configuración personal.

Esto te proporciona una configuración funcional de Claude Code, y es genuinamente mejor que empezar de cero. También tiene un límite: un solo archivo markdown es un documento de información general, no una memoria. No crece por sí solo, nadie lo actualiza después de una sesión difícil de depuración y nada de lo que contiene llega al asistente que usas para revisiones de incidentes o al agente que diriges a un modelo más barato el próximo mes. A los seis meses, CLAUDE.md estará desactualizado o será enorme.

La mejor manera: una capa de memoria para cualquier herramienta

La solución para no repetir esta migración es dejar de almacenar el conocimiento del proyecto dentro del agente que uses en cada momento. MemoryLake se sitúa fuera de tus herramientas: tus notas de arquitectura, decisiones y el contexto del repositorio viven en una sola capa de memoria, y Claude Code lee de ella a través de MCP. Si más adelante agregas Codex, mantienes Copilot para el autocompletado o delegas el trabajo a un segundo agente, todos leerán de la misma fuente en lugar de reconstruir cada uno una copia privada.

Paso 1: Crea una clave API

Genera una clave y realiza tu primera solicitud en unos 30 segundos.

Crear una clave API de MemoryLake
Crear una clave API de MemoryLake

Paso 2: Sube tus primeras memorias

Arrastra los documentos, imágenes y archivos que contienen el contexto real de tu proyecto: el CLAUDE.md que acabas de escribir, diagramas de arquitectura, ADRs, runbooks, reportes de incidentes, especificaciones de API. Este es el material que antes solo existía en el chat.

Subir tus primeras memorias a MemoryLake
Subir tus primeras memorias a MemoryLake

Paso 3: Conecta tu IA y agentes

Dale acceso a esa memoria a Claude, Codex, OpenClaw y tus otros agentes a través de MCP o la API. Para los detalles específicos de Claude Code, consulta cómo agregar memoria a Claude Code. A partir de ese momento, una nueva sesión comenzará con tu proyecto ya cargado, y el próximo cambio de herramienta será una edición de configuración en lugar de una migración.

Conectar tu IA y agentes a través de MCP
Conectar tu IA y agentes a través de MCP

Lo que realmente te cuesta el cambio y lo que te ahorra

Evalúa el costo del camino manual con honestidad. Migrar archivos de instrucciones: menos de una hora. Reconstruir el conocimiento tácito en CLAUDE.md: medio día si eres minucioso. Luego, el costo recurrente: supongamos que el contexto permanente de tu proyecto es de 2,000 tokens y se vuelve a plantear 20 veces al día en diferentes sesiones y agentes. Eso equivale aproximadamente a 1.2 millones de tokens al mes gastados en repetirte, y de cuatro a cinco minutos de recontextualización cada vez que abres una sesión.

La escritura única en una capa de memoria compartida reemplaza la mitad recurrente de ese costo. También cambia lo que sucede en tu próxima evaluación de herramientas: hoy en día, probar Codex o un nuevo agente significa pagar nuevamente el costo de reconstrucción del contexto, que es exactamente la razón por la cual los equipos se quedan con herramientas que ya les quedan pequeñas. Cuando la memoria es externa, evaluar una herramienta cuesta una tarde en lugar de un mes.

Mejores prácticas para el cambio

Migra decisiones, no transcripciones

No vuelques los registros de chat en tu nueva configuración. Extrae las conclusiones (la elección, el motivo, la fecha) y almacena eso. Las conclusiones se recuperan bien; las transcripciones entierran la señal y cuesta tokens leerlas.

Ejecuta ambas herramientas durante dos semanas

Mantén el autocompletado de Copilot mientras Claude Code se encarga del trabajo de agente. La superposición saca a la luz el contexto que olvidaste migrar, porque te darás cuenta de que estás explicando algo dos veces.

Escribe la memoria una vez, léela en todas partes

Cada vez que le expliques algo a un agente que vayas a necesitar de nuevo (una convención, una restricción, un hallazgo de un post-mortem), colócalo en la capa compartida en lugar de en la sesión. Ese hábito es lo que hace que la tercera migración sea trivial. Es el mismo principio detrás de migrar de Cursor a Claude Code y dejar de usar Codex sin tener que empezar de cero.

Conclusión

Pasar de GitHub Copilot a Claude Code son dos migraciones bajo un mismo nombre. La primera es mecánica: archivos de instrucciones a CLAUDE.md, hecha en una hora. La segunda es la que duele: los meses de contexto que explicaste en el chat, que no tiene ruta de exportación porque nunca se almacenó.

Puedes reconstruir eso a mano, y deberías hacerlo, una vez. Pero si lo reconstruyes dentro de Claude Code, lo estás almacenando en la próxima herramienta que vas a abandonar. Mantén la memoria de tu proyecto en una capa de la que lean tus agentes, y la pregunta dejará de ser "cómo muevo mi contexto a Claude Code" para convertirse en "qué agente debería leerlo hoy".

Preguntas frecuentes

¿Puedo exportar mi historial de chat de GitHub Copilot a Claude Code?

No existe una exportación compatible que lleve el historial de chat de Copilot a Claude Code en un formato utilizable, e incluso una transcripción sin procesar tendría el formato incorrecto: Claude Code lee instrucciones y memoria conectada, no los registros de otras herramientas. Migra tus archivos de instrucciones y luego extrae a mano las conclusiones duraderas de esos chats.

¿Cuál es el equivalente en Claude Code de `.github/copilot-instructions.md`?

CLAUDE.md en la raíz de tu proyecto, con las preferencias a nivel de usuario en ~/.claude/CLAUDE.md. Ambos son markdown plano y ambos pertenecen a la misma disciplina de revisión que el código, ya que un archivo de instrucciones desactualizado confunde silenciosamente a cada sesión que lo lee.

¿Recordará Claude Code mi proyecto entre sesiones?

No por sí solo. Vuelve a leer tus archivos CLAUDE.md en cada sesión y puede acceder a cualquier cosa que conectes a través de MCP, pero la sesión en sí no conserva nada. La persistencia proviene de aquello a lo que lo conectes.

¿Debería seguir usando Copilot después de migrar?

Muchos equipos lo hacen: Copilot para el autocompletado en línea, Claude Code para el trabajo de agentes en múltiples archivos. Esa combinación solo es cómoda cuando ambos apuntan al mismo contexto; de lo contrario, mantendrás dos conjuntos divergentes de conocimiento del proyecto.

¿Cómo evito tener que hacer esta migración de nuevo?

Almacena el contexto del proyecto fuera del agente. Cuando las convenciones, decisiones y trampas viven en una capa de memoria que tus agentes leen a través de MCP o una API, cambiar o agregar herramientas es un cambio de conexión, no un proyecto de reconstrucción de conocimiento.