Cómo pasar un diseño de Figma a código con Claude Code
Conecta Figma a Claude Code por MCP y convierte frames en componentes React fieles al diseño, sin copiar medidas a mano.
- Cuenta de Claude con acceso a Claude Code (plan Pro, Max, Team o Enterprise, o cuenta de Console con créditos de API)
- Cuenta de Figma con acceso a Dev Mode o a un asiento que permita usar el servidor MCP de Figma
- Node.js 20 o superior instalado para el proyecto front-end
- Terminal en macOS, Linux o Windows (PowerShell o WSL)
- Un archivo de Figma con al menos un frame diseñado con auto layout
- Instalar Claude Code con el instalador nativo y preparar un proyecto React + Tailwind
- Conectar el servidor MCP de Figma a Claude Code y autenticarte
- Preparar el archivo de Figma para que el código generado salga limpio
- Escribir un CLAUDE.md con reglas de tu design system para que Claude reutilice tus componentes
- Iterar visualmente comparando el resultado con la captura del diseño hasta que encaje
Instalar Claude Code y crear el proyecto base
Empieza por lo aburrido pero necesario: Claude Code instalado con el instalador nativo (nada de npm install -g, ese método ya no es el recomendado) y un proyecto front-end donde volcar el diseño. Usaremos Vite con React, TypeScript y Tailwind porque es el stack que mejor sale de un frame de Figma, pero el flujo es idéntico con Next.js, Vue o Astro. Tras instalar, abre una terminal nueva para que el binario esté en el PATH y ejecuta claude dentro de la carpeta del proyecto. La primera vez te pedirá iniciar sesión en el navegador con tu cuenta de Claude. Por defecto trabajará con el modelo más capaz disponible en tu plan (claude-opus-5-5); puedes comprobarlo o cambiarlo con el comando /model dentro de la sesión. Si trabajas en equipo desde España o LATAM con conexiones corporativas, verifica que el proxy no bloquee claude.ai ni mcp.figma.com antes de seguir.
# macOS / Linux / WSL
curl -fsSL https://claude.ai/install.sh | bash
# Windows (PowerShell)
# irm https://claude.ai/install.ps1 | iex
# Proyecto base
npm create vite@latest landing-figma -- --template react-ts
cd landing-figma
npm install
npm install -D tailwindcss @tailwindcss/vite
# Arranca Claude Code dentro del proyecto
claudeConectar el servidor MCP de Figma
La clave para que Claude Code no adivine medidas a partir de una captura es el servidor MCP oficial de Figma. Le da acceso estructurado a tu diseño: jerarquía de capas, auto layout, variables de color y espaciado, tipografías y una captura del frame. Tienes dos opciones. El servidor remoto (recomendado) funciona sin tener la app de escritorio abierta y se autentica con OAuth. El servidor local lo expone la app de escritorio de Figma cuando lo activas desde las preferencias de Dev Mode; útil si prefieres trabajar con la selección actual del lienzo. Añade el remoto con el comando de abajo, sal de la sesión si estabas dentro y vuelve a entrar. Luego, dentro de Claude Code, ejecuta /mcp, selecciona figma y completa la autenticación en el navegador. Cuando el estado aparezca como conectado, ya puedes pedirle cosas sobre tus archivos.
# Servidor remoto de Figma (recomendado)
claude mcp add --transport http figma https://mcp.figma.com/mcp
# Alternativa: servidor local de la app de escritorio
# claude mcp add --transport http figma-desktop http://127.0.0.1:3845/mcp
# Comprueba que está registrado
claude mcp listPreparar el frame de Figma para exportarlo bien
La calidad del código depende muchísimo de cómo esté construido el diseño. Un frame con capas llamadas Rectangle 47 y posiciones absolutas produce divs absolutos imposibles de mantener. Antes de pasárselo a Claude, revisa cuatro cosas: usa auto layout en contenedores para que se traduzca a flex o grid; nombra las capas con intención (Header, CardPrecio, BotonCTA); usa componentes de Figma para elementos repetidos; y define colores, tipografías y espaciados como variables o estilos, no como valores sueltos. Luego selecciona el frame concreto que quieres implementar y copia su enlace desde el menú contextual o la barra de compartir (la opción de copiar enlace a la selección). Ese enlace incluye el parámetro node-id, que es lo que le dice a Claude qué nodo exacto leer. Empieza por un frame mediano, como una sección hero o una tarjeta, no por la página entera.
Escribir un CLAUDE.md con las reglas del design system
Sin instrucciones, el MCP de Figma tiende a devolver código React con Tailwind y valores literales. Eso está bien para un prototipo, pero en un proyecto real quieres que Claude use tus componentes, tus tokens y tu estructura de carpetas. Para eso existe CLAUDE.md: un archivo en la raíz del proyecto que Claude Code lee automáticamente en cada sesión. Puedes generar una base con /init y luego añadir una sección específica para Figma como la de abajo. Sé concreto: rutas de carpetas, qué componentes existen, cómo se llaman los tokens y qué hacer con iconos e imágenes. Cuanto más explícito, menos tendrás que corregir después. Este archivo también es el sitio donde documentar convenciones de tu equipo, por ejemplo textos en español neutro o formato de moneda en euros o pesos según el mercado.
# Reglas para implementar diseños de Figma
- Stack: React + TypeScript + Tailwind v4. No añadas librerías nuevas sin preguntar.
- Componentes nuevos en src/components/<Nombre>/<Nombre>.tsx con export nombrado.
- Reutiliza SIEMPRE los componentes de src/components/ui (Button, Card, Badge) antes de crear otros.
- Traduce las variables de Figma a los tokens definidos en src/index.css (@theme). Nunca uses hex sueltos.
- Usa flex/grid según el auto layout de Figma. Prohibido position absolute salvo superposiciones reales.
- Imágenes y SVG: si el MCP devuelve URLs locales de assets, descárgalos en src/assets y no uses placeholders.
- Iconos: usa los SVG del diseño, no instales paquetes de iconos.
- Mobile first: el frame de Figma es desktop salvo que se indique lo contrario; añade breakpoints razonables.
- Accesibilidad: HTML semántico, alt en imágenes, botones como <button>.Pedir a Claude Code que implemente el frame
Con todo listo, el prompt puede ser corto, pero conviene que sea preciso. Pega el enlace del frame y di qué quieres, dónde y con qué restricciones. Claude usará las herramientas del MCP de Figma para obtener el contexto del diseño, las variables y una captura de referencia, y después escribirá los archivos. Te pedirá permiso antes de editar; revisa el plan que propone. Si el frame es complejo, pídele primero un plan (puedes activar el modo de planificación con Shift+Tab) para que liste los componentes que va a crear y cuáles va a reutilizar. Corregir el plan es mucho más barato que corregir código. Cuando termine, lanza el servidor de desarrollo y abre la página en el navegador para revisarla.
Implementa este frame de Figma como el componente PricingSection:
https://www.figma.com/design/TU_FILE_KEY/Landing?node-id=12-345
Requisitos:
- Sigue las reglas de CLAUDE.md.
- Reutiliza Button y Card de src/components/ui.
- Los precios vienen de un array tipado en el propio componente.
- Móvil: las tarjetas se apilan en una columna por debajo de md.
- Monta el componente en src/App.tsx.
Antes de escribir código, muéstrame qué componentes vas a crear y qué tokens vas a usar.Iterar comparando el resultado con el diseño
Rara vez el primer resultado es perfecto, y está bien: el valor está en iterar rápido. Arranca el servidor de desarrollo, haz una captura de tu página en el navegador y arrástrala a la terminal de Claude Code (o pega la ruta del archivo). Pídele que la compare con el frame de Figma y liste las diferencias antes de corregir. Así obtienes un diff visual razonado: márgenes, pesos tipográficos, radios, sombras. Después pide correcciones concretas. Repite hasta que encaje. Cuando una sección esté bien, haz commit. Si detectas un patrón que se repite (por ejemplo, que siempre usa un gris equivocado), no lo corrijas solo en el código: añádelo a CLAUDE.md para que no vuelva a pasar en los siguientes frames.
npm run dev
# En Claude Code, tras arrastrar tu captura:
# Compara esta captura de mi implementación con el frame de Figma
# https://www.figma.com/design/TU_FILE_KEY/Landing?node-id=12-345
# Lista las diferencias visuales ordenadas por importancia y luego corrígelas.
# Cuando quede bien
git add -A && git commit -m "feat: PricingSection desde Figma"Has montado un flujo de diseño a código de verdad: Claude Code instalado con el instalador nativo, conectado al servidor MCP oficial de Figma, guiado por un CLAUDE.md con las reglas de tu design system y capaz de convertir un frame en componentes React con Tailwind que reutilizan tus tokens y piezas existentes. Además sabes iterar visualmente comparando capturas para cerrar la brecha con el diseño y convertir cada corrección recurrente en una regla permanente. A partir de aquí, el siguiente nivel es exprimir Claude Code en proyectos reales: subagentes para revisar accesibilidad, comandos personalizados para tu equipo y flujos repetibles entre diseño y desarrollo.