Por qué Claude Code necesita un sistema de diseño
Claude Code no tiene estado respecto al diseño. Cada prompt comienza desde cero, por lo que recurre a los mismos valores predeterminados seguros: Inter, un fondo slate-950, un acento violeta y tarjetas genéricas. Construyes algunas pantallas y empiezan a diferenciarse porque nada fija la apariencia. Un sistema de diseño es ese ancla: un conjunto de tokens semánticos y un archivo DESIGN.md escrito que el agente consulta en cada tarea, para que la página cinco coincida con la página uno.
Claude Code también encaja perfectamente con MCP. Una vez conectado el servidor, el agente no solo recibe archivos estáticos: puede navegar por el catálogo, leer el informe completo de un kit y aplicarlo, todo desde dentro de tu sesión sin que tengas que salir de la terminal.
El kit que vas a instalar
Aquí tienes el kit gratuito ambient-sage renderizado con sus tokens reales: el sistema exacto que el agente escribe en tu repositorio cuando aplica este slug:
Ambient Sage
Live renderRendered from the kit's actual tokens, fonts, and treatments
Dashboard
Welcome back — here's how AmbientSage is performing today.
Active users
15.1k
+5%Trending up this month
vs. previous 30 days
MRR
$49.1k
+3%Strong recurring growth
Net of churn
Retention
89%
+2%Engagement above target
Rolling 28-day window
NPS
69
+3Meets growth projections
Survey · n=1,204
Total revenue
Last 12 months
$49.1k+18.2%
Recent sales
You closed 265 deals this month.
Alex Rivera
alex@ambientsage.com
Mira Okonkwo
mira@ambientsage.com
Jonas Feld
jonas@ambientsage.com
Sana Qureshi
sana@ambientsage.com
Theo Lindgren
theo@ambientsage.com
Recent transactions
View all| Customer | Status | Date | Amount |
|---|---|---|---|
AR Alex Rivera Founder & CEO | Paid | 2m ago | $1,999.00 |
MO Mira Okonkwo Head of Product | Pending | 1h ago | $39.00 |
JF Jonas Feld Design Lead | Processing | 3h ago | $299.00 |
SQ Sana Qureshi Engineering Lead | Paid | Yesterday | $99.00 |
TL Theo Lindgren Brand Director | Refunded | 2d ago | $2,400.00 |
Typography
Plus Jakarta Sans
Color system
28 semantic roles, light + dark
Agent outputs
DESIGN.md, CSS, Tailwind, shadcn
Instálalo (MCP, recomendado)
- 1
Escribe la configuración de MCP
Ejecuta esto en la raíz de tu proyecto. Fusionará un servidor
identityforgeen.mcp.json(no sobrescribirá los servidores existentes).npx --yes identityforge@latest install --client claude-code - 2
Reinicia Claude Code
Reinicia para que detecte el nuevo servidor y luego confirma que las herramientas estén disponibles pidiéndole a Claude
/mcpo listando sus herramientas de Identity Forge. - 3
Inicia sesión (opcional para kits gratuitos)
Solo es necesario para datos propios, una cuota de API más alta o kits Pro. Utiliza un flujo PKCE a través del navegador.
npx --yes identityforge@latest login - 4
Pide un estilo y deja que el agente lo aplique
Dale el producto, la audiencia y el estado de ánimo. El agente hará una selección con
search_themes, leerá el informe conget_design_mdy escribirá DESIGN.md + tokens conapply_theme.Use Identity Forge to pick a calm, trustworthy theme for a fintech dashboard, apply it, and follow the DESIGN.md.
Qué contiene `.mcp.json`
El comando de instalación escribe exactamente esto: un único servidor stdio que ejecuta el paquete versionado. También puedes añadirlo manualmente:
{
"mcpServers": {
"identityforge": {
"command": "npx",
"args": ["-y", "identityforge@latest", "mcp"]
}
}
}¿Prefieres no usar MCP? Dos rutas directas
Claude Code puede ejecutar comandos de shell, por lo que estrictamente no necesitas el servidor MCP. Cualquiera de estas opciones le proporciona los mismos tokens y el archivo DESIGN.md:
- 1
Aplicación vía CLI
Escribe
DESIGN.mdmás un archivo de tokens en el directorio actual. Dile a Claude que lea DESIGN.md y conecte los tokens con tu capa de estilos.identityforge apply ambient-sage - 2
Registro de shadcn
Si usas shadcn/ui, esto instala las variables CSS del kit directamente en el tema de tu proyecto.
npx shadcn add https://identityforge.io/r/ambient-sage.json
Un ejemplo real
Con el servidor conectado, pregunta: Usa Identity Forge para tematizar esta aplicación para un producto de bienestar, tranquilo y minimalista. Claude puede llamar a search_themes({ description: "wellness product, calm and minimal" }), elegir ambient-sage, leer su DESIGN.md y ejecutar apply_theme. Luego refactoriza los componentes para usar tokens semánticos como bg-background, text-foreground y bg-primary, mientras sigue las reglas del kit para tarjetas, sombras y tipografía. Las pantallas posteriores heredarán los mismos archivos y reglas.
Siguiente paso: haz lo mismo en Cursor, lee qué es un DESIGN.md o explora kits por estilo visual para encontrar un slug que encaje con tu producto.
Preguntas frecuentes
¿Cómo le doy un sistema de diseño a Claude Code?
Ejecuta `npx --yes identityforge@latest install --client claude-code` para añadir el servidor MCP de Identity Forge a .mcp.json, reinicia Claude Code y luego pídele que elija y aplique un kit. El agente escribirá un DESIGN.md y tokens semánticos en tu repositorio y construirá basándose en ellos.
¿Dónde se guarda la configuración?
En `.mcp.json` en la raíz de tu proyecto. El comando de instalación fusiona el servidor de identityforge en cualquier configuración MCP existente en lugar de sobrescribirla.
¿Tengo que pagar o iniciar sesión?
No para los kits gratuitos: el servidor MCP, la aplicación por CLI y el registro de shadcn funcionan sin una cuenta. Inicia sesión solo para proyectos propios, obtener más cuota de API o usar kits Pro. Gestiona tus claves en /account/api-keys.
¿Puedo usarlo sin MCP?
Sí. `identityforge apply <slug>` escribe DESIGN.md y tokens en el directorio actual, y `npx shadcn add https://identityforge.io/r/<slug>.json` instala las variables CSS del kit si utilizas shadcn/ui.