Donnez un système de design à Claude Code

Claude Code écrit du code de production mais n'a aucune mémoire de votre marque entre les prompts. Connectez le serveur MCP d'Identity Forge et il pourra choisir un kit, écrire les tokens et le fichier DESIGN.md dans votre dépôt, puis construire chaque écran en s'appuyant sur eux.

Mis à jour 2026-07-13

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 render

Rendered from the kit's actual tokens, fonts, and treatments

AmbientSage/Dashboard
Search...⌘K
AS

Dashboard

Welcome back — here's how AmbientSage is performing today.

Jan 1 – Jan 30, 2026
Overview
Analytics
Reports
Notifications

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

+3

Meets growth projections

Survey · n=1,204

Total revenue

Last 12 months

$49.1k+18.2%

12m30d7d
JanFebMarAprMayJunJulAugSepOctNovDec

Recent sales

You closed 265 deals this month.

AR

Alex Rivera

alex@ambientsage.com

+$1,999.00
MO

Mira Okonkwo

mira@ambientsage.com

+$39.00
JF

Jonas Feld

jonas@ambientsage.com

+$299.00
SQ

Sana Qureshi

sana@ambientsage.com

+$99.00
TL

Theo Lindgren

theo@ambientsage.com

+$2,400.00

Recent transactions

View all
CustomerStatusDateAmount
AR

Alex Rivera

Founder & CEO

Paid2m ago$1,999.00
MO

Mira Okonkwo

Head of Product

Pending1h ago$39.00
JF

Jonas Feld

Design Lead

Processing3h ago$299.00
SQ

Sana Qureshi

Engineering Lead

PaidYesterday$99.00
TL

Theo Lindgren

Brand Director

Refunded2d ago$2,400.00

Typography

Plus Jakarta Sans

Color system

28 semantic roles, light + dark

Agent outputs

DESIGN.md, CSS, Tailwind, shadcn

Ambient Sage : Plus Jakarta Sans, surfaces plates neutres et chaleureuses, un accent jaune vif. Changez de kit et tout le système change.

Installez-le (MCP, recommandé)

  1. 1

    Écrivez la config MCP

    Exécutez ceci à la racine de votre projet. Cela fusionne un serveur identityforge dans .mcp.json (cela n'écrasera pas les serveurs existants).

    npx --yes identityforge@latest install --client claude-code
  2. 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 /mcp ou en listant ses outils Identity Forge.

  3. 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. 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 avec get_design_md et écrit DESIGN.md + les tokens avec apply_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"]
    }
  }
}
.mcp.json : l'entrée du serveur MCP identityforge

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. 1

    Application via CLI

    Écrit DESIGN.md ainsi 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. 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.