Pourquoi Claude Code a besoin d'un système de design
Claude Code est sans état concernant le design. Chaque prompt repart de zéro, il utilise donc les mêmes valeurs par défaut sécurisées : Inter, un arrière-plan slate-950, un accent violet, des cartes génériques. Construisez quelques écrans et ils finiront par diverger car rien ne fixe l'aspect visuel. Un système de design est ce point d'ancrage : un ensemble de tokens sémantiques et un fichier DESIGN.md écrit que l'agent consulte pour chaque tâche, afin que la page cinq corresponde à la page une.
Claude Code est également parfaitement adapté au protocole MCP. Une fois le serveur connecté, l'agent ne reçoit pas seulement des fichiers statiques : il peut parcourir le catalogue, lire le brief complet d'un kit et l'appliquer, le tout depuis votre session sans que vous ayez à quitter le terminal.
Le kit que vous allez installer
Voici le kit gratuit ambient-sage rendu à partir de ses vrais tokens : le système exact que l'agent écrit dans votre dépôt lorsqu'il applique ce 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
Installez-le (MCP, recommandé)
- 1
Écrivez la config MCP
Exécutez ceci à la racine de votre projet. Cela fusionne un serveur
identityforgedans.mcp.json(cela n'écrasera pas les serveurs existants).npx --yes identityforge@latest install --client claude-code - 2
Redémarrez Claude Code
Redémarrez pour qu'il prenne en compte le nouveau serveur, puis confirmez que les outils sont disponibles en demandant à Claude
/mcpou en listant ses outils Identity Forge. - 3
Connectez-vous (optionnel pour les kits gratuits)
Uniquement nécessaire pour vos propres données, un quota API plus élevé ou les kits Pro. Utilise un flux PKCE via le navigateur.
npx --yes identityforge@latest login - 4
Demandez un style et laissez l'agent l'appliquer
Donnez-lui le produit, l'audience et l'ambiance. Il sélectionne avec
search_themes, lit le brief avecget_design_mdet écrit DESIGN.md + les tokens avecapply_theme.Use Identity Forge to pick a calm, trustworthy theme for a fintech dashboard, apply it, and follow the DESIGN.md.
Ce que contient `.mcp.json`
La commande d'installation écrit exactement ceci : un serveur stdio unique qui exécute le package versionné. Vous pouvez également l'ajouter manuellement :
{
"mcpServers": {
"identityforge": {
"command": "npx",
"args": ["-y", "identityforge@latest", "mcp"]
}
}
}Vous préférez sans MCP ? Deux voies directes
Claude Code peut exécuter des commandes shell, vous n'avez donc pas strictement besoin du serveur MCP. L'une ou l'autre de ces méthodes lui donnera les mêmes tokens et le même DESIGN.md :
- 1
Application via CLI
Écrit
DESIGN.mdainsi qu'un fichier de tokens dans le répertoire actuel. Dites à Claude de lire DESIGN.md et d'intégrer les tokens dans votre couche de style.identityforge apply ambient-sage - 2
Registre shadcn
Si vous utilisez shadcn/ui, cela installe les variables CSS du kit directement dans le thème de votre projet.
npx shadcn add https://identityforge.io/r/ambient-sage.json
Un exemple concret
Avec le serveur connecté, demandez : Utilise Identity Forge pour thématiser cette application pour un produit de bien-être, calme et minimal. Claude peut appeler search_themes({ description: "wellness product, calm and minimal" }), choisir ambient-sage, lire son DESIGN.md et exécuter apply_theme. Il refactorise ensuite les composants pour utiliser des tokens sémantiques tels que bg-background, text-foreground et bg-primary, tout en respectant les règles du kit pour les cartes, les ombres et la typographie. Les écrans suivants héritent des mêmes fichiers et règles.
Ensuite : faites la même chose dans Cursor, lisez ce qu'est un DESIGN.md, ou parcourez les kits par style visuel pour trouver un slug qui correspond à votre produit.
FAQ
Comment donner un système de design à Claude Code ?
Exécutez `npx --yes identityforge@latest install --client claude-code` pour ajouter le serveur MCP d'Identity Forge à .mcp.json, redémarrez Claude Code, puis demandez-lui de choisir et d'appliquer un kit. L'agent écrit un fichier DESIGN.md et des tokens sémantiques dans votre dépôt et construit l'interface en fonction d'eux.
Où va la configuration ?
Dans le fichier `.mcp.json` à la racine de votre projet. La commande d'installation fusionne le serveur identityforge avec toute configuration MCP existante plutôt que de l'écraser.
Dois-je payer ou me connecter ?
Non pour les kits gratuits : le serveur MCP, l'application via CLI et le registre shadcn fonctionnent tous sans compte. Connectez-vous uniquement pour vos propres projets, pour un quota API plus élevé ou pour les kits Pro. Gérez vos clés sur /account/api-keys.
Puis-je l'utiliser sans MCP ?
Oui. `identityforge apply <slug>` écrit DESIGN.md et les tokens dans le répertoire actuel, et `npx shadcn add https://identityforge.io/r/<slug>.json` installe les variables CSS du kit si vous utilisez shadcn/ui.