Por que o Claude Code precisa de um design system
O Claude Code não possui estado (stateless) em relação ao design. Cada prompt começa do zero, então ele recorre aos mesmos padrões seguros: Inter, um fundo slate-950, um destaque violeta e cards genéricos. Construa algumas telas e elas começarão a divergir porque nada fixa o visual. Um design system é esse fixador: um conjunto de tokens semânticos e um DESIGN.md escrito que o agente consulta em cada tarefa, para que a página cinco combine com a página um.
O Claude Code também é um ajuste natural para o MCP. Uma vez que o servidor esteja conectado, o agente não recebe apenas arquivos estáticos: ele pode navegar pelo catálogo, ler o briefing completo de um kit e aplicá-lo, tudo de dentro da sua sessão sem que você precise sair do terminal.
O kit que você vai instalar
Aqui está o kit gratuito ambient-sage renderizado a partir de seus tokens reais: o sistema exato que o agente escreve no seu repositório quando 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
Instale agora (MCP, recomendado)
- 1
Escreva a configuração do MCP
Execute isto na raiz do seu projeto. Isso mescla um servidor
identityforgeao.mcp.json(não irá sobrescrever servidores existentes).npx --yes identityforge@latest install --client claude-code - 2
Reinicie o Claude Code
Reinicie para que ele reconheça o novo servidor e, em seguida, confirme se as ferramentas estão disponíveis pedindo ao Claude para digitar
/mcpou listar suas ferramentas do Identity Forge. - 3
Faça login (opcional para kits gratuitos)
Necessário apenas para dados de propriedade do usuário, cota de API maior ou kits Pro. Utiliza um fluxo PKCE via navegador.
npx --yes identityforge@latest login - 4
Peça um visual e deixe o agente aplicá-lo
Forneça o produto, o público e o clima (mood). Ele faz uma pré-seleção com
search_themes, lê o briefing comget_design_mde escreve o DESIGN.md + tokens comapply_theme.Use Identity Forge to pick a calm, trustworthy theme for a fintech dashboard, apply it, and follow the DESIGN.md.
O que o `.mcp.json` contém
O comando de instalação escreve exatamente isto: um único servidor stdio que executa o pacote versionado. Você também pode adicioná-lo manualmente:
{
"mcpServers": {
"identityforge": {
"command": "npx",
"args": ["-y", "identityforge@latest", "mcp"]
}
}
}Prefere não usar MCP? Dois caminhos diretos
O Claude Code pode executar comandos de shell, então você não precisa estritamente do servidor MCP. Qualquer uma destas opções fornecerá os mesmos tokens e o DESIGN.md:
- 1
Aplicação via CLI
Escreve o
DESIGN.mdmais um arquivo de tokens no diretório atual. Diga ao Claude para ler o DESIGN.md e integrar os tokens na sua camada de estilização.identityforge apply ambient-sage - 2
Registro shadcn
Se você estiver usando shadcn/ui, isso instala as variáveis CSS do kit diretamente no tema do seu projeto.
npx shadcn add https://identityforge.io/r/ambient-sage.json
Um exemplo real
Com o servidor conectado, pergunte: Use o Identity Forge para tematizar este app para um produto de bem-estar, calmo e minimalista. O Claude pode chamar search_themes({ description: "wellness product, calm and minimal" }), escolher ambient-sage, ler seu DESIGN.md e executar apply_theme. Ele então refatora os componentes para usar tokens semânticos como bg-background, text-foreground e bg-primary, enquanto segue as regras do kit para cards, sombras e tipografia. As telas criadas posteriormente herdarão os mesmos arquivos e regras.
Próximo passo: faça o mesmo no Cursor, leia o que é um DESIGN.md ou navegue por kits por estilo visual para encontrar um slug que combine com seu produto.
FAQ
Como eu dou um design system ao Claude Code?
Execute `npx --yes identityforge@latest install --client claude-code` para adicionar o servidor MCP do Identity Forge ao .mcp.json, reinicie o Claude Code e peça para ele escolher e aplicar um kit. O agente escreve um DESIGN.md e tokens semânticos no seu repositório e constrói com base neles.
Onde fica a configuração?
No arquivo `.mcp.json` na raiz do seu projeto. O comando de instalação mescla o servidor identityforge em qualquer configuração MCP existente, em vez de sobrescrevê-la.
Preciso pagar ou fazer login?
Não para kits gratuitos: o servidor MCP, a aplicação via CLI e o registro shadcn funcionam sem conta. Faça login apenas para projetos de sua propriedade, mais cota de API ou kits Pro. Gerencie suas chaves em /account/api-keys.
Posso usar sem o MCP?
Sim. `identityforge apply <slug>` escreve o DESIGN.md e os tokens no diretório atual, e `npx shadcn add https://identityforge.io/r/<slug>.json` instala as variáveis CSS do kit se você usar shadcn/ui.