Migrar de Claude Code a Windsurf: El Playbook de Memoria 2026

Claude Code no tiene un empuje nativo a Windsurf. Copiarás CLAUDE.md en .windsurfrules, moverás la guía global del usuario a las reglas globales de Windsurf, traducirás los comandos slash en memorias Cascade o secciones de .windsurfrules, y volverás a añadir los servidores MCP en la configuración MCP de Windsurf. Planifica de 15 a 30 minutos por repositorio. Una capa de memoria compartida basada en MCP como MemoryLake permite que ambas herramientas lean la misma fuente.

Tres impulsores en 2026:

• Flujo de trabajo del agente Cascade. Los equipos que envían cambios de múltiples archivos a menudo prefieren el bucle Cascade de Windsurf en un IDE.
• Diferencia visual y revisión. La revisión visual en línea supera la lectura de parches en terminal para refactorizaciones de alto contacto.
• Estabilidad del editor. Algunos equipos quieren el envoltorio del IDE para soporte de plugins y paridad en la configuración del editor.

Forma diferente, intención relacionada.

La memoria de Claude Code se centra en `CLAUDE.md` en la raíz del repositorio, `~/.claude/CLAUDE.md` (global del usuario), comandos slash personalizados bajo .claude/commands/, y servidores MCP en la configuración de Claude Code.

La memoria de Windsurf abarca `.windsurfrules` (reglas del proyecto), reglas globales (nivel de usuario), y memoria Cascade (memorias persistentes guardadas durante el trabajo agente).

Un CLAUDE.md se convierte en un .windsurfrules. La guía global del usuario se convierte en las reglas globales de Windsurf. Los comandos slash se convierten en memorias Cascade o secciones estáticas de .windsurfrules.

Claude Code almacena todo como archivos de texto plano.

1. Lee el `CLAUDE.md` del repositorio. Copia el contenido en un archivo de texto de trabajo.
2. Lee `~/.claude/CLAUDE.md`. Copia la guía global en user-guidance.txt.
3. *Lista `.claude/commands/.md.** Cada uno se convierte en una memoria Cascade o una sección de .windsurfrules`.
4. Documenta los servidores MCP. Abre la configuración de Claude Code y anota la URL del endpoint y la autenticación de cada servidor MCP.

Estado final: una carpeta claude-code-export/ por repositorio que contiene CLAUDE.md, user-guidance.txt, commands/, y mcp-list.md.

Windsurf acepta el material equivalente reestructurado.

1. Crea `.windsurfrules` en la raíz del repositorio. Pega el contenido de CLAUDE.md.
2. Establece reglas globales. Abre la configuración de Windsurf y pega el contenido de ~/.claude/CLAUDE.md en el área de reglas globales.
3. Traduce los comandos slash. La guía estática (estilo, convenciones) se incorpora en .windsurfrules. Los prompts reutilizables se guardan como memorias Cascade durante una sesión Cascade a través de su panel de Memorias.
4. Vuelve a añadir los servidores MCP. Abre la configuración MCP de Windsurf y añade cada servidor MCP de mcp-list.md con su URL de endpoint y token Bearer.
5. Prueba. Abre Cascade y ejecuta una pequeña tarea que dependa de una regla trasladada.

• Patrón de invocación de comandos slash. Los atajos /<nombre> no tienen un equivalente uno a uno en Cascade.
• Flujo de múltiples pasos nativo de terminal. Las tareas CLI de larga duración se transforman en ejecuciones de Cascade.
• Historial de chat por herramienta. Las sesiones de Claude Code permanecen en la terminal.
• Sincronización continua. Nuevas ediciones de CLAUDE.md la próxima semana no aparecerán en .windsurfrules a menos que vuelvas a hacer la copia.

Si saltas entre Claude Code y Windsurf, los archivos por herramienta se desvían. Los estándares entre repositorios terminan en dos lugares.

MemoryLake almacena esas reglas una vez y las expone a través de MCP. Tanto Claude Code como Windsurf soportan MCP, por lo que el mismo contexto del proyecto fluye en ambos desde un único endpoint.

• Una fuente de verdad. Actualiza una vez; ambas herramientas ven el cambio.
• Estándares entre repositorios. Las convenciones del equipo viven por encima de cualquier repositorio único.
• Integración para la próxima herramienta. Añade Cursor o un futuro agente con un cambio de configuración.

Paso 1: Crea un proyecto y carga tu contexto

Inicia sesión en MemoryLake, abre Gestión de Proyectos y haz clic en Crear Proyecto. Nómbralo "Reglas compartidas de Claude Code ↔ Windsurf." Arrastra documentos de referencia (guías de estilo, ADRs como PDF, Word, Markdown o imágenes) a la Unidad de Documentos bajo Mi Espacio, luego abre la pestaña Documentos y haz clic en Añadir Documentos. Pega tu CLAUDE.md, guía del usuario y cuerpos de comandos slash en la pestaña Memorias a través de Añadir Memoria.

Paso 2: Generar un endpoint de servidor MCP

Abre la pestaña Servidores MCP dentro del proyecto, haz clic en Añadir Servidor MCP, descríbelo (por ejemplo, "Reglas de desarrollo compartidas"), y haz clic en Generar. MemoryLake devuelve un ID de clave, un secreto y una URL de endpoint. Copia el secreto inmediatamente — se muestra solo una vez.

Paso 3: Apunta ambas herramientas al endpoint

En la configuración de Claude Code, añade un servidor MCP de MemoryLake con la URL de endpoint y el secreto como un token Bearer. En la configuración MCP de Windsurf, añade la misma entrada. Reinicia ambos clientes.