Warum Claude Code ein Design System braucht
Claude Code ist in Bezug auf Design zustandslos. Jeder Prompt beginnt bei Null, weshalb der Agent immer zu denselben sicheren Standardwerten greift: Inter als Schriftart, ein slate-950 Hintergrund, eine violette Akzentfarbe und generische Cards. Wenn du ein paar Screens baust, driften diese auseinander, weil nichts das Aussehen fixiert. Ein Design System ist genau dieser Fixpunkt: Ein Satz semantischer Tokens und eine geschriebene DESIGN.md, die der Agent bei jeder Aufgabe konsultiert, damit Seite fünf exakt zu Seite eins passt.
Claude Code eignet sich zudem hervorragend für MCP. Sobald der Server verbunden ist, erhält der Agent nicht nur statische Dateien: Er kann den Katalog durchsuchen, das vollständige Briefing eines Kits lesen und es anwenden - alles direkt innerhalb deiner Session, ohne dass du das Terminal verlassen musst.
Das Kit, das du installieren wirst
Hier ist das kostenlose ambient-sage Kit, gerendert aus seinen echten Tokens: Das exakte System, das der Agent in dein Repo schreibt, wenn er diesen Slug anwendet:
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
Installation (MCP empfohlen)
- 1
Schreibe die MCP-Konfiguration
Führe dies in deinem Projektverzeichnis aus. Es fügt einen
identityforgeServer zur.mcp.jsonhinzu (bestehende Server werden dabei nicht überschrieben).npx --yes identityforge@latest install --client claude-code - 2
Claude Code neu starten
Starte den Prozess neu, damit der neue Server erkannt wird. Bestätige anschließend die Verfügbarkeit der Tools, indem du Claude fragst,
/mcpaufzurufen oder seine Identity Forge Tools aufzulisten. - 3
Anmelden (optional für kostenlose Kits)
Nur erforderlich für eigene Daten, ein höheres API-Kontingent oder Pro-Kits. Nutzt einen Browser-PKCE-Flow.
npx --yes identityforge@latest login - 4
Design anfordern und anwenden lassen
Gib Produkt, Zielgruppe und Stimmung vor. Der Agent erstellt eine Vorauswahl mit
search_themes, liest das Briefing mitget_design_mdund schreibt DESIGN.md + Tokens mitapply_theme.Use Identity Forge to pick a calm, trustworthy theme for a fintech dashboard, apply it, and follow the DESIGN.md.
Was in der `.mcp.json` steht
Der Installationsbefehl schreibt genau das hier: einen einzelnen stdio-Server, der das versionierte Paket ausführt. Du kannst ihn auch manuell hinzufügen:
{
"mcpServers": {
"identityforge": {
"command": "npx",
"args": ["-y", "identityforge@latest", "mcp"]
}
}
}Kein MCP gewünscht? Zwei direkte Wege
Da Claude Code Shell-Befehle ausführen kann, benötigst du den MCP-Server nicht zwingend. Beides liefert dem Agenten dieselben Tokens und dieselbe DESIGN.md:
- 1
CLI Apply
Schreibt
DESIGN.mdplus eine Token-Datei in das aktuelle Verzeichnis. Sage Claude, dass er die DESIGN.md lesen und die Tokens in deine Styling-Ebene einbinden soll.identityforge apply ambient-sage - 2
shadcn Registry
Wenn du shadcn/ui nutzt, installiert dies die CSS-Variablen des Kits direkt in das Theme deines Projekts.
npx shadcn add https://identityforge.io/r/ambient-sage.json
Ein echtes Beispiel
Wenn der Server verbunden ist, frage: Nutze Identity Forge, um diese App für ein Wellness-Produkt zu stylen, ruhig und minimalistisch. Claude kann search_themes({ description: "wellness product, calm and minimal" }) aufrufen, ambient-sage wählen, dessen DESIGN.md lesen und apply_theme ausführen. Danach refaktoriert er Komponenten, um semantische Tokens wie bg-background, text-foreground und bg-primary zu verwenden, während er die Regeln des Kits für Cards, Schatten und Typografie befolgt. Spätere Screens erben dieselben Dateien und Regeln.
Als Nächstes: Mache dasselbe in Cursor, lies was eine DESIGN.md ist oder stöbere nach Kits nach visuellem Stil, um einen passenden Slug für dein Produkt zu finden.
FAQ
Wie gebe ich Claude Code ein Design System?
Führe `npx --yes identityforge@latest install --client claude-code` aus, um den Identity Forge MCP-Server zur .mcp.json hinzuzufügen, starte Claude Code neu und bitte ihn dann, ein Kit auszuwählen und anzuwenden. Der Agent schreibt eine DESIGN.md und semantische Tokens in dein Repo und baut darauf auf.
Wo landet die Konfiguration?
In der `.mcp.json` in deinem Projektverzeichnis. Der Installationsbefehl führt den identityforge Server in eine bestehende MCP-Konfiguration zusammen, anstatt sie zu überschreiben.
Muss ich bezahlen oder mich anmelden?
Nein bei kostenlosen Kits: Der MCP-Server, der CLI Apply und die shadcn Registry funktionieren alle ohne Account. Melde dich nur für eigene Projekte, ein höheres API-Kontingent oder Pro-Kits an. Verwalte deine Keys unter /account/api-keys.
Kann ich es ohne MCP nutzen?
Ja. `identityforge apply <slug>` schreibt DESIGN.md und Tokens in das aktuelle Verzeichnis, und `npx shadcn add https://identityforge.io/r/<slug>.json` installiert die CSS-Variablen des Kits, falls du shadcn/ui verwendest.