Cómo armar tu sistema de diseño para Claude Design

La guía práctica para armar el sistema de diseño de tu empresa antes de cargarlo en Claude Design: materia prima, tokens, componentes, reglas, assets y pruebas, con nuestro caso real.

Claude Design te arma un deck en tres minutos. Lindo. Prolijo. Y con la marca de nadie.

No es culpa del modelo. Le falta tu sistema de diseño. Y la mayoría de las empresas no tiene uno: tiene un logo, un manual en PDF y un par de piezas que salieron bien. Eso es materia prima, no un sistema.

La misma propuesta hecha sin sistema de diseño, con paleta genérica, y con sistema de diseño, con los colores y componentes de la marca

Esta es la guía para armarlo antes de cargarlo, en nueve pasos. Con nuestro caso como hilo: así armamos el de Magnesium, con lo que salió bien y lo que nos costó. Si todavía no usaste la herramienta, arrancá por qué es Claude Design.

Los nueve pasos para armar un sistema de diseño para Claude Design: materia prima, extraer la marca, tokens, componentes, reglas de uso, assets, cargar, probar y mantener

Paso 1: juntá la materia prima

Antes de decidir nada, juntá todo lo que ya muestra tu marca. La web. Los últimos decks. Las piezas que el equipo aprobó y le gustaron. El logo en vector, no en JPG. Las fotos o ilustraciones que usan. Los archivos de las tipografías.

Las piezas terminadas valen más que el manual. Anthropic lo dice en su propio tutorial: los archivos que muestran la marca en uso le dan a Claude más material que un PDF solo. El manual dice cómo debería verse tu marca. Una pieza aprobada muestra cómo se ve.

Nuestro caso. La mejor fuente era magnesium.team. Un sitio de HTML y CSS estático, con la marca aplicada en cada página. De ahí salieron los colores, las fuentes y los patrones. Las tipografías las sacamos del repositorio de la web, y los 41 personajes de Mg, de su carpeta de imágenes.

Error típico: arrancar solo con el manual de marca. Suele estar desactualizado y no tiene los casos difíciles: la tabla, el gráfico, la portada con foto.

Paso 2: extraé la marca de lo que ya existe

Ahora se mira con lupa. De la materia prima sale un inventario con tres partes.

  • Paleta con códigos y roles. No "azul y gris". Cada color con su código exacto y su trabajo: fondo, superficie de tarjeta, texto principal, texto secundario, acento, bordes y, si los usás, estados.
  • Tipografías y jerarquía. Qué fuente para títulos, cuál para texto, cuál para etiquetas. Con pesos y tamaños.
  • Espaciados, radios y sombras. Cuánto aire hay entre bloques, qué tan redondeadas son las tarjetas, cómo se separan del fondo.

Nuestro caso. El fondo es casi negro (#050608), las tarjetas un azul marino profundo (#0C0E18), el texto un gris claro (#CBD5E1). El acento es un gradiente de azul #2563EB a cyan #06B6D4. Títulos y texto en Poppins, etiquetas y números en JetBrains Mono. Radios de 8, 12 y 16 píxeles. Y una decisión que vale anotar: la paleta no lleva ámbar ni verde.

Error típico: sacar los colores con el gotero de una captura. Los valores salen corridos por la compresión. Tomalos del código de la web o del archivo original.

Paso 3: convertila en tokens con nombres que Claude entienda

Un token es un valor con nombre. En vez de "#2563EB", el sistema dice --mg-blue. Parece un detalle. Es lo que hace que Claude aplique la marca en lugar de copiar números.

Tres reglas para nombrarlos. Un prefijo propio, para que no choquen con nada. Nombres por rol en todo lo que no es la paleta de marca: fondo, tarjeta, texto, borde. Y una línea que explique cada grupo, porque esa línea es la que Claude lee.

Nuestro caso. Todo empieza con --mg-. La paleta de marca va por nombre (--mg-blue, --mg-cyan, --mg-indigo). El resto va por rol: --mg-darker para el fondo, --mg-card para tarjetas, --mg-text y --mg-muted para el texto, --mg-border para bordes. El gradiente también es un token, --mg-gradient. Y el coral, --mg-claude, es el de Claude: aparece en su insignia.

De los colores y tipografías de la web de Magnesium a tokens con nombre y rol: fondo, tarjetas, texto, acento, títulos y etiquetas

Error típico: tokens como "azul-2" o "gris-nuevo". Dentro de seis meses nadie, ni Claude, sabe para qué servían.

Paso 4: definí los componentes que la empresa usa de verdad

Un componente es una pieza que se repite: el botón, la tarjeta, el dato destacado, la tabla, la portada de un deck, el cierre con llamado a la acción. Listá los que aparecen en tus piezas reales. No los que tendría una marca ideal.

Cada componente lleva sus variantes. El botón principal y el secundario. La tarjeta con ícono y sin ícono. El dato suelto y el destacado.

Nuestro caso. Quedaron 26 componentes: botones, tarjetas, héroes, pasos, estadísticas, citas, preguntas frecuentes, el logo de Claude y un componente de personaje. El botón tiene seis variantes: la principal con gradiente, sólida azul, sólida cyan, dos translúcidas y una con borde. La estadística tiene una variante destacada, la tarjeta azul a cyan con personaje, copiada tal cual de una de nuestras páginas de casos.

Galería de la librería de componentes de Magnesium: colores, botones, chips, tarjetas y personajes

Error típico: nombres raros. Un componente que nombramos todo en mayúsculas, FAQ, el sincronizador lo leyó como una constante y no le armó tarjeta propia. Nombres simples, con mayúscula inicial en cada palabra.

Paso 5: escribí las reglas de uso, con así sí y así no

Este es el paso que más rinde. Los tokens dicen qué existe. Las reglas dicen cómo se usa y cuándo no. Anthropic las llama notas de uso, y Claude lee la nota de un componente antes de construir con él.

Escribí decisiones, no adjetivos. "Moderno y cercano" no le sirve a nadie. "Una sola palabra en gradiente por título" sí.

Regla de uso con ejemplo: así sí, una palabra en gradiente por título; así no, el título entero en gradiente y el texto en tipografía mono

Nuestro caso. Algunas de nuestras reglas reales:

  • Gradiente. Así sí: una palabra del título. Así no: el título entero. El gradiente es un condimento, no la salsa.
  • Tipografía mono. Así sí: etiquetas, números, pasos. Así no: párrafos.
  • Colores. Nunca un código escrito a mano. Los tokens llevan la marca.
  • Personajes. Así sí: una pose que signifique algo para la pieza. Así no: el superhéroe volador en una portada, o el personaje sobre un recuadro blanco.
  • Contexto. Todo va dentro del componente raíz, que pone el fondo oscuro. Fuera de él, el texto blanco desaparece.

Error típico: un resumen eterno. Claude lo lee completo cada vez que usa el sistema. Lo general va en el resumen; la regla de un componente, en su nota. La estructura de un deck o el orden de una propuesta no son diseño: eso va en una skill de Claude.

Paso 6: sumá los assets y decidí cómo se cargan

Logos en todas sus versiones (fondo claro, fondo oscuro, ícono). Ilustraciones o fotos. Íconos. Y las fuentes, como archivo. Si una fuente está nombrada pero no tiene archivo, Claude no la puede usar.

Después decidí desde dónde se cargan. Subidos al sistema, o servidos desde un lugar estable, como tu web.

Nuestro caso. Los 41 personajes y el logo de Claude se cargan desde magnesium.team, con nombres que dicen qué hacen: mg-sherpa guía, mg-presenter explica, mg-team es el equipo. Las fuentes, en cambio, las subimos como archivo. Al principio el sistema tenía una fuente de respaldo que en realidad era Arial con otro nombre, y el chequeo la marcó como faltante.

Error típico: cargar assets desde rutas que cambian. Si la web mueve una carpeta, las imágenes del sistema quedan en blanco. Lo que se sirve desde un sitio pasa a ser parte del sistema.

Paso 7: cargalo en Claude Design

Con todo armado, cargar es lo más corto. Hay tres caminos, según dónde vive tu marca.

Tres caminos para crear un sistema de diseño en Claude: desde el código, desde tus herramientas y desde archivos de marca
  • Desde el código. Si tenés una librería de componentes, Claude la sincroniza desde GitHub: colores, estilos de texto, espaciados, radios, fuentes, logos y documentación. Si es React y vive en tu máquina, el atajo es Claude Code con /design-sync.
  • Desde tus herramientas. Si la marca vive en una herramienta de diseño, un drive o una wiki, Claude la lee con los conectores de Claude.
  • Desde archivos. Subís logos, fuentes, la guía y las piezas terminadas, y Claude escribe el primer borrador.

Los sistemas de diseño están en beta en los planes pagos de Claude, y la versión independiente de claude.ai/design cierra el 14 de diciembre de 2026.

Nuestro caso. La web era HTML estático: no tenía componentes para sincronizar. Así que extrajimos el estilo a una librería React fina, donde cada componente es un envoltorio delgado sobre las mismas clases mg- y los mismos tokens de la web. Después la sincronizamos con /design-sync. El archivo de convenciones, con las reglas de construcción, viajó como encabezado del resumen.

Paso 8: probalo con tres piezas reales

Pedile a Claude tres piezas comunes sin decir nada de la marca: un deck, un one-pager y una landing. La prueba la propone Anthropic: si la pieza se parece a tu empresa, el sistema funciona.

Mirá cuatro cosas. Los colores en su rol. La jerarquía de la tipografía. Si usó tus componentes o inventó otros. Y si respetó las reglas, sobre todo las prohibiciones. Si sale cerca pero no exacto, sumá ejemplos de la marca en uso o afiná la regla que falló. Para los decks, el método completo está en crear presentaciones con Claude.

Nuestro caso. El chequeo automático dio todo bien. Y el logo se veía como una imagen rota. El texto del logo es blanco y la tarjeta de prueba era blanca. El chequeo no lo detecta porque solo verifica que algo se haya mostrado. Lo vimos mirando. Otra: la fila de estadísticas destacadas se apilaba en una columna porque la probábamos en una pantalla angosta. En el ancho real se veía bien.

Chequeo de renderizado de la sincronización a Claude Design con las tarjetas de cada componente de Magnesium

Error típico: confiar en que cargó. El chequeo dice que el sistema funciona. Solo una persona mirando dice que se ve bien.

Paso 9: mantenelo vivo

Un sistema de diseño envejece igual que un manual. Cambia la web, aparece un producto, se suma una submarca. Tres hábitos lo mantienen al día.

  • Un dueño. Anthropic recomienda una persona responsable. Nosotros lo aprendimos al revés: una vez sincronizamos mientras otra sesión editaba la librería, y los resultados no coincidían.
  • Una cuenta. Otra vez el proyecto quedó atado a una cuenta distinta y hubo que recrearlo. Dos copias en dos cuentas es peor que una perdida.
  • La fuente de cada pieza. Anotá de dónde salió cada componente. Nuestra estadística destacada copia una página de casos: si esa página cambia, es lo primero que se revisa.

Y un detalle que se olvida: cada deck o diseño ya hecho guarda su propia copia del sistema. Si lo actualizás, pedile a Claude que actualice las piezas que importan.

Checklist: lo que tu sistema tiene que tener antes de cargarlo

Copiala y tachá:

Checklist del sistema de diseño antes de cargarlo en Claude Design: trece puntos, de las piezas reales al dueño y la versión
  1. Piezas reales terminadas: al menos un deck, un one-pager y una página web.
  2. Logo en vector, con versión para fondo claro, fondo oscuro e ícono.
  3. Cada color con su código exacto y su rol: fondo, superficie, texto, texto secundario, acento, bordes, estados.
  4. Las tipografías como archivo, con su jerarquía: títulos, texto, etiquetas.
  5. Espaciados, radios y sombras definidos con valores.
  6. Tokens con prefijo propio y nombres por rol, con una línea que explique cada grupo.
  7. La lista de componentes que la empresa usa de verdad, con sus variantes.
  8. Nombres de componentes simples, con mayúscula inicial.
  9. Reglas de uso con así sí y así no, incluidas las prohibiciones.
  10. Un resumen corto: cómo se construye con el sistema, en una página.
  11. Assets con nombres que digan qué son, cargados desde un lugar estable.
  12. Tres piezas de prueba pedidas sin nombrar la marca, revisadas por una persona.
  13. Un dueño, una cuenta y una fecha de versión.

Si una línea queda vacía, el sistema todavía no está listo. Claude va a completar el hueco adivinando, y lo que adivina es lo genérico. Es el mismo principio que con el texto: sin contexto, Claude completa con lo más probable.

La pregunta que importa

Tu marca ya existe. Está en la web, en el logo, en el último deck que salió bien. Armar el sistema no es inventarla: es escribirla de forma que Claude la pueda leer.

La pregunta es cuántas piezas más vas a corregir a mano antes de escribirla una vez.

Si querés, lo armamos juntos: el sistema de diseño de tu empresa, con tus archivos y tu marca, listo para Claude Design. Hablemos.

Fuentes

  1. Setting up a design system in Claude (Claude Academy)
  2. Set up your design system in Claude Design (Claude Help Center)
  3. Claude Design (claude.com)
  4. Introducing Claude Design by Anthropic Labs (Anthropic)