Claude Design — UI generation with prompt + design-system + Claude Code handoff
Overview
Claude Design (claude.ai/design, Anthropic Labs, launched 2026-04-17, powered by Opus 4.8) is a chat-driven visual canvas. You describe what you want in plain English; Claude generates a working design on the right pane; you iterate via chat or by clicking individual elements to leave inline comments. A major 2026-06-17 overhaul repositioned it from a flashy demo into a design-system compliance layer with a bidirectional Claude Code round-trip + a fix for its token-burning problem. The standout features for engineering teams:
- Org-wide design system (import from GitHub repo / local codebase / design files / raw uploads) — bring one or several design systems in ONCE; Claude builds with your real components, checks its output against the system, and auto-corrects before you see it. A new admin role can approve ONE standard system + lock edits (enterprise brand control).
- Bidirectional Claude Code round-trip (the 2026-06-17 headline) — from a Claude Code terminal:
/design-sync imports your local codebase's design system INTO Claude Design (so prototypes start from real components, not approximations); /design creates/edits/syncs design projects without leaving the terminal. When a design is ready it hands off to Claude Code, which picks up exactly where you left off — no screenshot, no rebuild. (This Claude Code environment exposes a DesignSync tool for this.)
- Multi-output export + connectors — standalone HTML, PDF, PPTX, .zip, org-scoped share link (view/comment/edit), or push to a connected app: Adobe, Base44, Canva, Gamma, Lovable, Miro, Replit, Vercel, Wix (more added over time).
Available on Pro / Max / Team / Enterprise. NOT on Free. Usage now shares your subscription pool with chat / Cowork / Code (see Pricing). Still beta — treat as exploratory tooling, not a system of record (no audit logs yet).
When to use
- Generate a prototype / wireframe / high-fidelity mock from a verbal spec before you commit any engineering
- Build a pitch deck, investor slides, or sales one-pager that needs to look on-brand
- Produce dashboard/landing mockups using your real component library — then hand off to Claude Code with full context
- Explore 3-5 visual directions in parallel for a design crit without burning eng time
- Generate marketing assets (emails, banners, social posts) that match brand
When NOT to use
- Cloning a specific reference UI screenshot/URL → use
aura-screenshot-clone skill (aura.build Pro is the project's asset source-of-truth)
- Greenfield high-fi UI from natural language via Google Stitch MCP → use
stitch-mcp-design (remote MCP + optional google-labs-code/stitch-skills)
- Translating an existing Figma file into code → use
figma-design-to-code
- Mass image picking for hero/landing imagery → use
mengto-aura-asset-images
- Production component edits in the app repo → edit the code directly; Claude Design is for the design phase, not codebase surgery
- Anything that needs an audit trail (compliance, legal review, regulated industry) — research preview has no audit logs yet
- Free-plan users — feature isn't available
Quick start (fresh session, 5 minutes)
- Navigate to
https://claude.ai/design (drive it programmatically via logged-in browser automation when available — navigate → prompt → upload reference screenshots → screenshot each state. DevTools-only MCP often has no logged-in session.)
- Connect a real design system first. Prefer
/design-sync from Claude Code (GitHub / design files / local app codebase) so generation starts from real components and tokens; or use org Set up design system → upload library / brand assets → Published ON.
- From the homepage, pick a project type:
- Prototype → New prototype / Wireframe / High fidelity
- Slide deck
- From template
- Other
- Describe what you want. Attach screenshots, images, codebases, existing design files, or website captures as context.
- Iterate:
- Chat (broad changes): "Make the color scheme darker and more minimal", "Move the metrics row above the chart"
- Inline comment (targeted): click an element on the canvas → "Make this button padding larger", "Change this to a dropdown instead of radio buttons"
- Export (upper-right Export button) when ready: Handoff to Claude Code (local or web — the direct-to-repo path, preferred for us), Send to Vercel (then pull with
mcp__plugin_vercel_vercel__import-claude-design-from-url), .zip / PDF / PPTX / Canva / standalone HTML, or a share URL. No native Figma export — see the Figma-bridge row in design-to-code-pipeline.
Design system setup — the load-bearing step
Skip this and Claude Design produces generic-looking output that doesn't match your brand. Doing it once unlocks every future project.
| Input type |
What Claude extracts |
Recommended fidelity |
| Codebase (React component library) |
Components, prop shapes, design tokens, layout patterns |
Highest — use this if available |
| Slide decks (PPTX) or PDFs |
Color palette, typography, layout patterns |
Medium |
| Screenshots / design files |
Color palette, typography, isolated component visuals |
Medium |
| Individual logos, color palettes, typography files |
Tokens only, no component shape |
Lowest |
Steps (verbatim from the docs):
- Click your organization name in the lower-left corner.
- Select or create an organization → complete the onboarding flow.
- Upload brand materials. Per docs: "If your design system lives in code (for example, a React component library)" you can upload the codebase directly.
- Claude extracts and organizes color palettes, typography specs, UI components, and layout patterns. Validate with sample test prompts.
- Toggle Published ON. After publishing, every project created from the homepage while in your organization uses your design system.
- To update later: Organization Settings → click Open next to your design system → click Remix → edit via chat.
Scope is organization-wide — auto-applies for all team members on Team/Enterprise plans.
Export and handoff matrix
| Export option |
Best for |
| Handoff to Claude Code (local) |
You want to immediately implement in your repo. Opens a Claude Code session with the design context attached. |
| Handoff to Claude Code (web) |
Implement in a sandbox / shareable session. |
| Standalone HTML |
Self-contained preview for non-technical stakeholders — AND the source for the Figma bridge (below). |
| Send to Vercel |
Direct deploy path; pull into a session with the mcp__plugin_vercel_vercel__import-claude-design-from-url MCP tool. Also sends to Adobe/Base44/Gamma/Lovable/Miro/Replit/Wix. |
| Download .zip |
Local asset bundle for manual implementation or offline versioning. |
| PDF |
Read-only review, contract attachments, archival. |
| PPTX |
Slide deck for an investor / sales / all-hands. |
| Send to Canva |
Marketing team continues in their tool of record (fully editable). |
| Share link |
View / Comment / Edit roles for collaborators inside your org. |
Figma: no native export. Confirmed 2026-07-02 (Anthropic docs + 3 sources) — Claude Design cannot export to Figma directly. To get a design INTO Figma: export standalone HTML → html.to.design (Chrome-extension "Copy to Clipboard" → paste into Figma with Ctrl/Cmd+V, OR the html.to.design Figma-plugin drop-zone), or the Anima Figma design-agent. For OUR repo you usually don't need Figma at all — Handoff to Claude Code is the direct path; reach for Figma only when a human designer must edit layers.
Pricing & usage
| Plan |
Use case (per Anthropic) |
| Pro |
Quick explorations, one-off use |
| Max |
Semi-regular — PMs and engineers producing regular mockups |
| Team (standard seat) |
Quick explorations, one-off use |
| Team (premium seat) |
Power users — designers and creatives |
| Enterprise (legacy standard) |
Semi-regular — PMs and engineers producing occasional mockups |
| Enterprise (legacy premium) |
Power users — designers and creatives |
| Free |
Not available |
- Usage SHARES your subscription pool with chat, Claude Cowork, and Claude Code (2026-06-17 change — a heavy design session eats the SAME limits as a coding session; budget accordingly). The older "separate weekly allowance" framing is superseded; check the Help Center for current shared-limit details.
- Buy more usage (enable extra usage) if you blow through the shared cap.
- Enterprise usage-based: one-time ~20-prompt credit per Claude Design user, expires July 17.
- No exact "per-prompt" cost is published — Anthropic tunes the meter during research preview.
- No audit logs, no usage tracking yet — Labs release.
Common mistakes
| Mistake |
Fix |
| Skipping the design-system setup → output looks generic |
Lower-left org name → set up + Publish before creating projects |
| Uploading just colors/fonts when a React codebase exists |
Upload the codebase — extracts components AND tokens, not just tokens |
| Treating exported HTML as production-ready |
It's a high-fidelity mockup; use Handoff to Claude Code to integrate with your real component library, lint, tests |
| Using Claude Design for a 1:1 reference clone |
Use aura-screenshot-clone skill instead — that's its job |
| Not toggling Published ON |
New projects won't pick up your design system; the toggle is the gate |
| Inline comments occasionally disappear before processing |
Re-add the comment; document quirk; verify the change actually applied before iterating further |
| Large codebases choke the canvas |
Upload only the design-system-relevant subset (components/, tokens/, theme files) — not the full repo |
| Compact view triggers save errors |
Switch to default view layout when saving |
Decision matrix vs other UI tools in this stack
Canonical copy: repo AGENTS.md § Design path matrix
| Situation |
First reach for |
| Brand-new feature mockup, no existing reference |
claude-design |
| Pitch deck or slide work for the company |
claude-design (Slide deck mode) |
| Match a specific reference UI screenshot/URL |
aura-screenshot-clone |
| Generate/iterate UI in Google Stitch via MCP |
stitch-mcp-design |
| Convert an existing Figma file → React |
figma-design-to-code |
| Hero/landing imagery picking |
mengto-aura-asset-images |
| Direct edit of a live app component |
Edit the code directly — no design tool needed |
| Visual review of a live deployed page |
frontend-audit skill + claude-in-chrome MCP |
What to verify after handing off to Claude Code
The handoff seeds the next session with design context, but Claude Code still needs to:
- Map design components → your real component library imports (not the extracted clones)
- Run
npm run check-types + project lint before claiming the implementation matches
- Verify in the browser at 375 / 1024 / 1440 viewports —
frontend-audit skill or claude-in-chrome MCP
- Pin a regression test if the design encodes a non-obvious invariant
Recommended path + design→code landscape
Prefer /design-sync so prototypes start from the product’s real components and
design tokens. Visuals round-trip; state logic stays in application code.
- aura.build — HTML/Tailwind/vanilla JS (+ React projects); Figma import/export
on Pro. Use
aura-screenshot-clone + mengto-aura-asset-images.
- Figma — Figma MCP (
https://mcp.figma.com/mcp) into the IDE; Dev Mode /
Code Connect for implementation.
- Google Stitch — Stitch MCP + pack skills via
stitch-mcp-design
(~400 credits/day).
Sources
1---2name: claude-design3description: Use when generating, prototyping, or iterating on UI designs (prototypes, wireframes, slide decks, landing/dashboard mockups) with Anthropic's Claude Design tool at claude.ai/design — particularly when you want a design system applied automatically and a clean handoff into Claude Code for implementation.4---56# Claude Design — UI generation with prompt + design-system + Claude Code handoff78## Overview910Claude Design (claude.ai/design, Anthropic Labs, launched 2026-04-17, powered by Opus 4.8) is a chat-driven visual canvas. You describe what you want in plain English; Claude generates a working design on the right pane; you iterate via chat or by clicking individual elements to leave inline comments. **A major 2026-06-17 overhaul** repositioned it from a flashy demo into a design-system *compliance layer* with a bidirectional Claude Code round-trip + a fix for its token-burning problem. The standout features for engineering teams:11121. **Org-wide design system (import from GitHub repo / local codebase / design files / raw uploads)** — bring one or several design systems in ONCE; Claude builds with your real components, **checks its output against the system, and auto-corrects before you see it**. A new admin role can approve ONE standard system + lock edits (enterprise brand control).132. **Bidirectional Claude Code round-trip (the 2026-06-17 headline)** — from a Claude Code terminal: **`/design-sync`** imports your local codebase's design system INTO Claude Design (so prototypes start from real components, not approximations); **`/design`** creates/edits/syncs design projects without leaving the terminal. When a design is ready it hands off to Claude Code, which picks up exactly where you left off — no screenshot, no rebuild. *(This Claude Code environment exposes a `DesignSync` tool for this.)*143. **Multi-output export + connectors** — standalone HTML, PDF, PPTX, .zip, org-scoped share link (view/comment/edit), or push to a connected app: **Adobe, Base44, Canva, Gamma, Lovable, Miro, Replit, Vercel, Wix** (more added over time).1516Available on **Pro / Max / Team / Enterprise**. NOT on Free. Usage now **shares your subscription pool with chat / Cowork / Code** (see Pricing). Still beta — treat as exploratory tooling, not a system of record (no audit logs yet).1718## When to use1920- Generate a prototype / wireframe / high-fidelity mock from a verbal spec before you commit any engineering21- Build a pitch deck, investor slides, or sales one-pager that needs to look on-brand22- Produce dashboard/landing mockups using your real component library — then hand off to Claude Code with full context23- Explore 3-5 visual directions in parallel for a design crit without burning eng time24- Generate marketing assets (emails, banners, social posts) that match brand2526## When NOT to use2728- **Cloning a specific reference UI screenshot/URL** → use `aura-screenshot-clone` skill (aura.build Pro is the project's asset source-of-truth)29- **Greenfield high-fi UI from natural language via Google Stitch MCP** → use `stitch-mcp-design` (remote MCP + optional google-labs-code/stitch-skills)30- **Translating an existing Figma file into code** → use `figma-design-to-code`31- **Mass image picking for hero/landing imagery** → use `mengto-aura-asset-images`32- **Production component edits in the app repo** → edit the code directly; Claude Design is for the design phase, not codebase surgery33- **Anything that needs an audit trail** (compliance, legal review, regulated industry) — research preview has no audit logs yet34- **Free-plan users** — feature isn't available3536## Quick start (fresh session, 5 minutes)37381. Navigate to `https://claude.ai/design` (drive it programmatically via logged-in browser automation when available — `navigate` → prompt → upload reference screenshots → screenshot each state. DevTools-only MCP often has no logged-in session.)392. **Connect a real design system first.** Prefer **`/design-sync`** from Claude Code (GitHub / design files / local app codebase) so generation starts from real components and tokens; or use org **Set up design system** → upload library / brand assets → **Published** ON.403. From the homepage, pick a project type:41 - **Prototype** → New prototype / Wireframe / High fidelity42 - **Slide deck**43 - **From template**44 - **Other**454. Describe what you want. Attach screenshots, images, codebases, existing design files, or website captures as context.465. Iterate:47 - **Chat (broad changes):** "Make the color scheme darker and more minimal", "Move the metrics row above the chart"48 - **Inline comment (targeted):** click an element on the canvas → "Make this button padding larger", "Change this to a dropdown instead of radio buttons"496. **Export (upper-right Export button)** when ready: **Handoff to Claude Code** (local or web — the direct-to-repo path, preferred for us), **Send to Vercel** (then pull with `mcp__plugin_vercel_vercel__import-claude-design-from-url`), `.zip` / PDF / PPTX / Canva / standalone HTML, or a share URL. **No native Figma export** — see the Figma-bridge row in `design-to-code-pipeline`.5051## Design system setup — the load-bearing step5253Skip this and Claude Design produces generic-looking output that doesn't match your brand. Doing it once unlocks every future project.5455| Input type | What Claude extracts | Recommended fidelity |56|---|---|---|57| **Codebase (React component library)** | Components, prop shapes, design tokens, layout patterns | **Highest** — use this if available |58| **Slide decks (PPTX) or PDFs** | Color palette, typography, layout patterns | Medium |59| **Screenshots / design files** | Color palette, typography, isolated component visuals | Medium |60| **Individual logos, color palettes, typography files** | Tokens only, no component shape | Lowest |6162**Steps (verbatim from the docs):**631. Click your organization name in the **lower-left corner**.642. Select or create an organization → complete the onboarding flow.653. Upload brand materials. Per docs: "If your design system lives in code (for example, a React component library)" you can upload the codebase directly.664. Claude extracts and organizes color palettes, typography specs, UI components, and layout patterns. Validate with sample test prompts.675. Toggle **Published** ON. After publishing, every project created from the homepage while in your organization uses your design system.686. To update later: Organization Settings → click **Open** next to your design system → click **Remix** → edit via chat.6970Scope is **organization-wide** — auto-applies for all team members on Team/Enterprise plans.7172## Export and handoff matrix7374| Export option | Best for |75|---|---|76| **Handoff to Claude Code (local)** | You want to immediately implement in your repo. Opens a Claude Code session with the design context attached. |77| **Handoff to Claude Code (web)** | Implement in a sandbox / shareable session. |78| **Standalone HTML** | Self-contained preview for non-technical stakeholders — AND the source for the Figma bridge (below). |79| **Send to Vercel** | Direct deploy path; pull into a session with the `mcp__plugin_vercel_vercel__import-claude-design-from-url` MCP tool. Also sends to Adobe/Base44/Gamma/Lovable/Miro/Replit/Wix. |80| **Download .zip** | Local asset bundle for manual implementation or offline versioning. |81| **PDF** | Read-only review, contract attachments, archival. |82| **PPTX** | Slide deck for an investor / sales / all-hands. |83| **Send to Canva** | Marketing team continues in their tool of record (fully editable). |84| **Share link** | View / Comment / Edit roles for collaborators inside your org. |8586**Figma: no native export.** Confirmed 2026-07-02 (Anthropic docs + 3 sources) — Claude Design cannot export to Figma directly. To get a design INTO Figma: export **standalone HTML** → **html.to.design** (Chrome-extension "Copy to Clipboard" → paste into Figma with Ctrl/Cmd+V, OR the html.to.design Figma-plugin drop-zone), or the **Anima** Figma design-agent. For OUR repo you usually don't need Figma at all — **Handoff to Claude Code** is the direct path; reach for Figma only when a human designer must edit layers.8788## Pricing & usage8990| Plan | Use case (per Anthropic) |91|---|---|92| **Pro** | Quick explorations, one-off use |93| **Max** | Semi-regular — PMs and engineers producing regular mockups |94| **Team (standard seat)** | Quick explorations, one-off use |95| **Team (premium seat)** | Power users — designers and creatives |96| **Enterprise (legacy standard)** | Semi-regular — PMs and engineers producing occasional mockups |97| **Enterprise (legacy premium)** | Power users — designers and creatives |98| **Free** | Not available |99100- **Usage SHARES your subscription pool with chat, Claude Cowork, and Claude Code** (2026-06-17 change — a heavy design session eats the SAME limits as a coding session; budget accordingly). The older "separate weekly allowance" framing is superseded; check the Help Center for current shared-limit details.101- Buy more usage (enable extra usage) if you blow through the shared cap.102- **Enterprise usage-based**: one-time ~20-prompt credit per Claude Design user, **expires July 17**.103- No exact "per-prompt" cost is published — Anthropic tunes the meter during research preview.104- **No audit logs, no usage tracking yet** — Labs release.105106## Common mistakes107108| Mistake | Fix |109|---|---|110| Skipping the design-system setup → output looks generic | Lower-left org name → set up + Publish before creating projects |111| Uploading just colors/fonts when a React codebase exists | Upload the codebase — extracts components AND tokens, not just tokens |112| Treating exported HTML as production-ready | It's a high-fidelity mockup; use **Handoff to Claude Code** to integrate with your real component library, lint, tests |113| Using Claude Design for a 1:1 reference clone | Use `aura-screenshot-clone` skill instead — that's its job |114| Not toggling **Published** ON | New projects won't pick up your design system; the toggle is the gate |115| Inline comments occasionally disappear before processing | Re-add the comment; document quirk; verify the change actually applied before iterating further |116| Large codebases choke the canvas | Upload only the design-system-relevant subset (components/, tokens/, theme files) — not the full repo |117| Compact view triggers save errors | Switch to default view layout when saving |118119## Decision matrix vs other UI tools in this stack120121Canonical copy: repo `AGENTS.md` § Design path matrix122123| Situation | First reach for |124|---|---|125| Brand-new feature mockup, no existing reference | **claude-design** |126| Pitch deck or slide work for the company | **claude-design** (Slide deck mode) |127| Match a specific reference UI screenshot/URL | `aura-screenshot-clone` |128| Generate/iterate UI in Google Stitch via MCP | `stitch-mcp-design` |129| Convert an existing Figma file → React | `figma-design-to-code` |130| Hero/landing imagery picking | `mengto-aura-asset-images` |131| Direct edit of a live app component | Edit the code directly — no design tool needed |132| Visual review of a live deployed page | `frontend-audit` skill + claude-in-chrome MCP |133134## What to verify after handing off to Claude Code135136The handoff seeds the next session with design context, but Claude Code still needs to:1371. Map design components → your real component library imports (not the extracted clones)1382. Run `npm run check-types` + project lint before claiming the implementation matches1393. Verify in the browser at 375 / 1024 / 1440 viewports — `frontend-audit` skill or claude-in-chrome MCP1404. Pin a regression test if the design encodes a non-obvious invariant141142## Recommended path + design→code landscape143144Prefer **`/design-sync`** so prototypes start from the product’s real components and145design tokens. Visuals round-trip; **state logic stays in application code**.146147- **aura.build** — HTML/Tailwind/vanilla JS (+ React projects); Figma import/export148 on Pro. Use `aura-screenshot-clone` + `mengto-aura-asset-images`.149- **Figma** — Figma MCP (`https://mcp.figma.com/mcp`) into the IDE; Dev Mode /150 Code Connect for implementation.151- **Google Stitch** — Stitch MCP + pack skills via `stitch-mcp-design`152 (~400 credits/day).153154## Sources155156- News announcement (launch 2026-04-17): <https://www.anthropic.com/news/claude-design-anthropic-labs>157- **2026-06-17 overhaul (design-system import + `/design-sync` code round-trip + connectors + token-burn fix):** <https://venturebeat.com/technology/anthropic-ships-major-claude-design-overhaul-with-design-system-imports-code-round-trips-and-a-fix-for-its-token-burning-problem>158- Product page (current features): <https://claude.com/product/design>159- Get started: <https://support.claude.com/en/articles/14604416-get-started-with-claude-design>160- Set up design system: <https://support.claude.com/en/articles/14604397-set-up-your-design-system-in-claude-design>161- Subscription, usage, pricing: <https://support.claude.com/en/articles/14667344-claude-design-subscription-usage-and-pricing>162- Tool: <https://claude.ai/design>