Domingo, 22 de noviembre de 2026  ·  Español
Intermedio 50 min en total 6 pasos

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.

Daniel Puentes Prias
Consultor de IA · Actualizado el 16 de noviembre de 2026
Requisitos
  • 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
Lo que vas a aprender
  • 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
PASO 1 · ~8 min

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.

bash
# 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
claude
ConsejoHaz un commit inicial con git antes de dejar que Claude toque nada. Así puedes descartar una iteración mala con git checkout en segundos.
Error comúnSi ejecutas claude desde tu carpeta home en lugar de la raíz del proyecto, Claude no verá tu package.json ni tu configuración de Tailwind y generará código desconectado de tu stack.
PASO 2 · ~7 min

Conectar 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.

bash
# 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 list
ConsejoAñade --scope project al comando si quieres que la configuración quede en un .mcp.json versionado y todo tu equipo tenga el mismo servidor al clonar el repo.
Error comúnEl error más típico es registrar el servidor y no autenticarse: Claude dirá que no puede acceder al archivo. Entra en /mcp y completa el login de Figma antes de pegar enlaces.
PASO 3 · ~8 min

Preparar 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.

ConsejoSi el diseñador no puede limpiar el archivo, duplica el frame en una página de trabajo y renombra tú las capas principales. Diez minutos aquí ahorran una hora de refactor.
Error comúnPegar el enlace del archivo completo en vez del frame hace que Claude reciba demasiado contexto, tarde más y genere una página gigante y genérica. Usa siempre enlaces con node-id.
PASO 4 · ~8 min

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.

code
# 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>.
ConsejoCrea los tokens en src/index.css antes de implementar el primer frame. Pide a Claude: 'lee las variables del archivo de Figma y genera el bloque @theme de Tailwind'. Así todo lo que venga después ya usa tus tokens.
Error comúnNo metas en CLAUDE.md instrucciones contradictorias con tu código real (por ejemplo, rutas que no existen). Claude las seguirá al pie de la letra y creará carpetas fantasma.
PASO 5 · ~10 min

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.

code
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.
ConsejoSi te importa la fidelidad pixel a pixel, añade al prompt 'usa también la captura del frame como referencia visual'. Combinar estructura y captura reduce errores de alineación.
Error comúnEvita pedir 'haz toda la web' de golpe. Implementa sección por sección: cada frame cabe en contexto, se revisa rápido y los errores no se propagan.
PASO 6 · ~9 min

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.

bash
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"
ConsejoPide también la vista móvil: abre las herramientas de desarrollo en un ancho de 375 px, captura y pásasela. Muchos diseños solo existen en desktop y es donde más fallos aparecen.
Error comúnNo aceptes cambios en bloque sin mirarlos. Si Claude 'arregla' un margen tocando un componente compartido de src/components/ui, puedes romper otras pantallas. Revisa qué archivos ha editado.
Resultado

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.

PRÓXIMOS PASOS
TÉRMINOS DE ESTE TUTORIAL
MÁS DE CLAUDE CODE