Claude Code OpenDesign

Design With
Claude Code in
OpenDesign.

How to design interfaces with Claude Code in OpenDesign: CLAUDE.md and the Frontend Design skill as the constraints, one workspace-settings task from brief to reviewed file, and where the Figma round-trip stops.

From brief to interface01 / Claude Code
YOU BRING THE IDEA↗

“Workspace settings that follow
our tokens, not a template.”

Illustrative interface · not a captured product session
On This Page Example
  1. Example
  2. Fit
  3. Compatibility
  4. Setup
  5. Workflow
  6. Resources
  7. Limitations
  8. FAQ

A CLAUDE CODE DESIGN WALKTHROUGH

From Brief to Interface: One Claude Code Design Task

This walkthrough follows one job through the handoff: the brief and constraints you give Claude Code, the artifact it returns, and the checks that remain yours before sign-off. The interface below is an illustration built for this page, not a capture of a real Claude Code session.

1Design Brief and Constraints

Brief

Design the workspace settings area for a small SaaS team: general, members, notifications, and billing. Pull values from the tokens in CLAUDE.md; no hand-tuned exceptions. It has to hold up on desktop and on a phone.

  • Design systemTokens and primitives from CLAUDE.md; Albert Sans; a single green accent
  • Breakpoints1440px desktop and 390px mobile, no horizontal scroll
  • InteractionsSection switch, toggles, an unsaved-changes bar, and a keyboard focus order
  • OutputA single self-contained HTML file carrying stable data-od-id hooks

2Who Does What: You, Claude Code, and OpenDesign

  • You

    You write the brief, choose the design system, and set the acceptance criteria.

  • Claude Code

    Claude Code plans the layout, writes the HTML, CSS, and JavaScript, then revises on request.

  • OpenDesign

    OpenDesign supplies the design system and skill, renders the preview, and keeps each version as a project file.

  • Review

    Before handoff, check visual hierarchy, spacing on the 8px grid, both breakpoints, and every interaction.

3Claude Code Output: Settings Screen at 1440px and 390px

Claude Code Output: Settings Screen at 1440px and 390px — Desktop
Illustrative example

4Review Before Handoff

Layout

Grid and Spacing

Sub-navigation, form, and actions align to the 8px grid; the sticky save bar never covers a field.

Hierarchy

Visual Hierarchy

Group titles carry more weight than labels; the accent appears only on enabled toggles.

Responsive

Mobile Layout

At mobile width, sub-navigation turns into a segmented switch; toggles keep a 44px hit area; the save button spans the full width.

Interaction

Interaction Checks

Tab through each field, toggle one control, then cancel and confirm the unsaved-changes prompt.

Fit

Where Claude Code Fits — and Where It Doesn’t

Claude Code Fits When

  • Design system first. Put a DESIGN.md / tokens / Tailwind config in the project so Claude Code matches a brand rather than sliding into “AI slop”.
  • Aesthetic skills. Skills such as Anthropic’s frontend-design push Claude Code to choose a typography/color/motion direction before it writes markup.
  • Figma → code. Connect the Figma MCP server, and Claude Code turns frames into production components with real tokens.
  • Screenshot loop. Let Claude Code screenshot its own UI, compare it with a reference, and iterate — the agentic design feedback loop.

Choose Another Workflow When

  • You need editable vector files. Claude Code returns HTML, not an editable design document. Use a separate vector workflow for that asset format.
  • You have no reference and no constraints. With no design system or examples, Claude Code tends toward a generic look; draft the brief first.
  • You do not have the credential this agent needs. Required: Anthropic API key (bring your own key) or Claude subscription. OpenDesign neither provides nor proxies credentials.
  • Your team works in Codex or Cursor. Those agents have their own pages; OpenDesign keeps one workspace across agents, but setup differs. See related agents.

Compatibility

Claude Code Requirements Before You Begin

This page treats Claude Code as connected through the OpenDesign desktop app. Published references were checked on 6 September 2026.

Tool ScopeClaude Code, by Anthropic

Claude Code is Anthropic’s agentic command-line tool: describe a task in natural language, and it reads, writes, and runs code in your project until that task is finished. It is separate from Anthropic’s hosted Claude Design product; the Claude Design comparison covers that choice. This page is about designing interfaces with Claude Code through OpenDesign, not about Claude Code’s own interface. OpenDesign’s setup notes list the available agents.

Accounts and AuthenticationAnthropic API key (BYOK) or Claude

Anthropic API key (BYOK) or Claude subscription. You authenticate with your Anthropic API key (BYOK) or Claude subscription — nothing is proxied through us. No quota or price is promised on this page.

System and VersionsDesktop app or source

Available as a terminal CLI, VS Code / Cursor / JetBrains extensions, desktop app, and web. For desktop builds, see the download page. Node.js and pnpm requirements in the source quickstart matter when running from source, not when installing a desktop package. Minimum compatible Claude Code version: not verified here.

Connection CheckThe success signal

Use the connection instructions that your installed version shows, then try a modest task. Confirm that Claude Code completed it and that the artifact opens. Downloading the agent alone does not prove a working connection.

Start with the desktop app

Claude Code Setup in Three Steps

Start with the download, complete the Claude Code setup for the version you have installed, then verify a modest result. Following this path does not require building OpenDesign from source.

  1. 1

    Download the OpenDesign Desktop App

    Pick the package for your machine, install it, and open the desktop app.

    Download OpenDesign
    CHECKPOINT
    The desktop app opens. If it is already installed, go to the next step; no second download is needed.
  2. 2

    Prepare Your Claude Code Connection

    Follow the Claude Code instructions that ship with your installed version. Authenticate with your Anthropic API key (BYOK) or Claude subscription — nothing is proxied through us.

    anthropics/skills — frontend-design skill
    # 1. Install Claude Code (native install, recommended)
    curl -fsSL https://claude.ai/install.sh | bash
    # or: brew install --cask claude-code
    # Windows PowerShell: irm https://claude.ai/install.ps1 | iex
    
    # 2. Start it in your project and sign in on first run
    cd your-project
    claude            # sign in with your Claude subscription or API key

    Taken from the Claude Code setup notes in the published guide; verify the current command in the vendor documentation.

    CHECKPOINT
    Confirm the agent and account you meant to use. If Claude Code is unavailable, review compatibility before moving to a larger task.
  3. 3

    Run a First Small Claude Code Task

    Keep the first brief modest, so you can judge the full loop, including one revision.

    Starter brief

    Build a settings screen with a profile form and a save confirmation. Follow my design rules. Check it at desktop and mobile widths.

    CHECKPOINT
    Open the artifact, exercise the save state, and ask for one specific change. Generation starts the review; it does not finish it.

To run OpenDesign from source, use the technical quickstart instead.

The Claude Code design workflow

Claude Code Design Workflow: Five Steps From Brief to Reviewed File

One workspace-settings task traced from brief to verified file. Every step shows what you hand over, what Claude Code does, what OpenDesign contributes and what you check.

  1. 1

    Design Brief

    Plain language, three to six lines. State the audience, the screen's job and the platforms.

    • YouWrite the brief; attach a reference screenshot when you have one.
    • Claude CodeReads the brief and CLAUDE.md; asks when something is ambiguous.
    • OpenDesignProvides the project, the prompt surface and the matching skill for the artifact type.
    • CheckConfirm the brief includes acceptance criteria. Adding them now costs less than after generation.
  2. 2

    Design Constraints

    A design system and a few hard rules. That combination is what separates on-brand output from a generic look.

    • YouPick a design system; state breakpoints and any must-use components.
    • Claude CodeLoads the DESIGN.md tokens and posture rules into context before writing any markup.
    • OpenDesignShips the design-system library and binds the chosen one into the skill template.
    • CheckThe tokens match your brand. One accent, the right fonts, the right radius.
  3. 3

    Generate the Interface

    Claude Code produces a self-contained HTML file: layout, styles, interactions and stable hooks.

    • YouWait, or answer a clarifying question. Nothing to configure.
    • Claude CodePlans the sections, writes the HTML, CSS and JavaScript, runs the file and fixes what fails.
    • OpenDesignSaves the artifact into the project folder and indexes it for preview.
    • CheckNothing yet. Judge the file after it is rendered, not from the source.
  4. 4

    Preview

    The file renders inside OpenDesign at the widths you specified. This is where the design gets judged.

    • YouSwitch widths, click through the interactions, leave comments on elements.
    • Claude CodeReads your comments on the preview and prepares the next revision.
    • OpenDesignRenders the preview and exposes data-od-id targets for comments and edits.
    • CheckHierarchy, contrast, overflow at 390px, focus states, and whether the accent is used sparingly.
  5. 5

    Revise and Verify

    Request changes by pointing at elements in the preview. Each revision becomes a new file; nothing is overwritten silently.

    • YouTurn comments into requests; decide when the task is done.
    • Claude CodeApplies the changes in place and re-runs the file.
    • OpenDesignKeeps versions side by side; exports an image or the HTML when you are done.
    • CheckRe-check only the area that changed, then the whole page once at each breakpoint.

Resources

Claude Code Design Resources

Limitations

Claude Code Limitations, Manual Checks and Fallbacks

  • ScopeIt is a coding agent, not a design tool — yet design is one of its strongest emergent uses. With the right skills and a design system in context, it generates production HTML/CSS/React, iterates on screenshots, and maintains design tokens. This page covers Claude Code as an agent connected to OpenDesign, not every Claude Code feature.
  • Usage LimitsUsage limits and cost follow the credential you use (Anthropic API key or Claude subscription). No claim about free quotas is made here.
  • NetworkLocal project files do not mean offline inference. Review your agent’s provider settings and data policies before sharing sensitive inputs.
  • Output Is HTMLArtifacts are HTML files, not vector design files. Figma round-trips go through Claude Code’s own Figma integration.
  • Manual ReviewYou review accessibility, real content, brand fit and interaction correctness in the preview. Treat any self-check by the agent as a first pass.
  • FallbackIf the agent is unavailable or a task fails, check the installed version’s connection instructions and authentication. Preserve the error and the last working artifact before changing configuration.

FAQ

Common Questions About Claude Code and OpenDesign

Is Claude Code Good for Design Work?
Yes — it is widely regarded as the coding agent with the best frontend taste, making specific, codebase-aware decisions about hex values, spacing, and type scales. With the Frontend Design skill, a design system, and real reference images in context it produces production-quality, responsive UI and can verify it in a browser. Without that context it tends to default to a generic look, which is the gap OpenDesign fills.
Do I Need a Claude Subscription to Design With Claude Code?
You can use either an Anthropic API key (BYOK, via the Console) or a Claude subscription (Pro / Max). Either way OpenDesign never proxies your credentials — they are used directly by your agent on your machine.
Claude Code or Codex for Frontend Design?
Both are strong. Claude Code is known for specific, codebase-aware design decisions and frontend reasoning; Codex has strong visual polish and excels at delegated, sandboxed builds. Many teams use both — OpenDesign lets you switch agents without changing your design workflow.
How Do I Connect Claude Code to Figma?
Install the official Figma plugin with claude plugin install figma@claude-plugins-official. You can then implement Figma frames in code using the design context, and push a running UI back to editable Figma frames with “Send this to Figma.” Dev Mode MCP requires a paid Figma plan.
What Are Skills and CLAUDE.md?
CLAUDE.md is a markdown file in your project root that Claude Code reads at the start of every session — the place to encode your design conventions. Skills package repeatable instructions and resources Claude loads on demand, including Anthropic’s official Frontend Design skill. OpenDesign ships a curated library of both so you skip the per-project setup.
What Claude Code actually is
Claude Code is Anthropic’s agentic coding tool. It reads your codebase, edits files, runs commands, and integrates with your dev tools — planning, writing, and verifying work from natural-language tasks rather than just autocompleting lines.

It ships across several surfaces that all share the same engine: a terminal CLI, IDE extensions for VS Code, Cursor, and JetBrains, a desktop app with visual diff review, and a web experience for long-running tasks. Your CLAUDE.md files, settings, and MCP servers carry across all of them.

Instruction file: Claude Code reads a CLAUDE.md file in your project root at the start of every session — the natural place to encode your design conventions, tokens, and review checklists.

Skills: Agent Skills package repeatable instructions, scripts, and resources that Claude loads on demand, including Anthropic’s official Frontend Design skill for taste.

Plan and subagents: It can plan before acting and spawn subagents that work on different parts of a task in parallel, which keeps large UI refactors coherent.

Credential: Anthropic API key (BYOK, via the Console) or a Claude subscription (Pro / Max)

Vendor: Anthropic
Why Claude Code is good at design
Among coding agents, Claude Code has a reputation for taste in frontend work. A few things explain it.

Specific, not vague, decisions: Claude Code tends to commit to concrete choices — exact hex values, spacing scales, type ramps, and component hierarchy — instead of hand-waving, which is what separates a real interface from a placeholder.

Codebase-aware reasoning: With a large working context it refactors UI across many files at once, reusing your existing components and tokens rather than reinventing one-off styles.

An official frontend skill: Anthropic ships a Frontend Design skill that makes Claude write a design direction first and deliberately steers away from generic system fonts and predictable purple gradients.

Taste comes from three inputs you provide: a design system, a skill, and real reference images.

The lesson is the same one Anthropic makes about its own models: Claude does not have taste by default — left alone it converges on the statistical center of web design (Inter, purple gradients, soft shadows). It produces good design when you give it constraints. OpenDesign packages exactly those inputs, which is why the two fit together (more below).
Set up Claude Code for design work, from zero
The setup sequence: install → authenticate → configure CLAUDE.md → add the Frontend Design skill → enable browser verification.

Encode your design rules: Put your tokens, primitives, and conventions in CLAUDE.md and point Claude at them, so output matches a brand instead of defaulting to a generic look.

Add browser verification: Wire a Playwright or Chrome MCP so Claude renders in a real browser and checks its output across breakpoints instead of only confirming the build passes.

Use the current setup section for commands and version-specific details, which may change.

# 1. Install Claude Code (native install, recommended) curl -fsSL https://claude.ai/install.sh | bash # or: brew install --cask claude-code # Windows PowerShell: irm https://claude.ai/install.ps1 | iex # 2. Start it in your project and sign in on first run cd your-project claude # sign in with your Claude subscription or API key # 3. Generate project context /init # creates a CLAUDE.md for this project # 4. Add the official Frontend Design skill claude plugin install frontend-design@claude-plugins-official # 5. Wire the Figma MCP server (optional, for design handoff) claude plugin install figma@claude-plugins-official
Historical command example from the previous guide; verify current syntax in the linked vendor documentation.
The CLAUDE.md and Skills workflow
The highest-leverage design loop with Claude Code is feeding it real references plus your design context, then iterating until the UI matches — with CLAUDE.md and Skills carrying the constraints so you do not re-explain them every prompt.

Start from the clearest visual references you have — and include multiple states (desktop and mobile, hover, empty, loading), not just one hero shot.

Be specific in the prompt; vague prompts produce generic UI even with a strong agent.

Keep your design system and conventions in CLAUDE.md, and tell Claude where the tokens and canonical primitives live.

Add the Frontend Design skill so Claude commits to a real aesthetic direction before writing code.

Wire browser verification so Claude renders, resizes to breakpoints, and compares back to the references — not merely confirms it builds.

Drop a reference image into the session and prompt with concrete constraints:

Run a dev server alongside, keep prompts small and focused, and commit good iterations / revert bad ones (telling Claude when you revert) so each pass builds on a clean base. Use plan mode for larger refactors so you can review the approach before any file changes.

claude "Implement reference-desktop.png and reference-mobile.png in React + Vite + Tailwind + TypeScript. Reuse the design-system components and tokens described in CLAUDE.md. Match spacing, layout, and hierarchy; make it responsive. Render it in the browser, verify it matches the references across breakpoints, and iterate until it does."
Historical command example from the previous guide; verify current syntax in the linked vendor documentation.
Claude Code + Figma: design ↔ code round-trip
In February 2026 Anthropic and Figma shipped a first-class, bidirectional integration via the Figma MCP server. It works in both directions.

Design → Code: Select a frame in Figma or paste a link into Claude Code, pull the design context, and ask it to implement the design using your existing component library. Code Connect keeps output aligned with your real components.

Code → Design: Build and preview a feature in the browser, then say “Send this to Figma” to capture the running UI as editable Figma layers — entire screen or a selected element.

Install it once with claude plugin install figma@claude-plugins-official (Dev Mode MCP requires a paid Figma plan). The same Figma MCP is available to Claude Code, Codex, Cursor, and VS Code — exactly the kind of portable, multi-agent capability OpenDesign is built to orchestrate.
Claude Code vs Codex vs Cursor for design
There is no single winner for design work — each agent has a different strength, and experienced teams stack them. A fair summary:

Claude Code — Specific design decisions (hex, spacing, type) and codebase-aware UX reasoning — Frontend reasoning and large-context refactors

Codex — Strong visual polish and image understanding; sandboxed async builds — Delegated async builds and portable AGENTS.md rules

Cursor — Visual build-and-see loop with live preview and inline edits — Tight iterate-and-watch UI work inside an IDE

The recurring community verdict is that taste comes from humans: all three default to a generic aesthetic without skills, references, and constraints. That is the real problem to solve — and it is design-tool-shaped, not model-shaped.

Agent — Design strength — Best for
Pitfalls, and how to avoid the “AI slop” look
Even with Claude Code’s reputation for taste, the most common complaint about AI-generated design is that it looks generic — Inter fonts, purple gradients on white, soft shadows, oversized rounded corners, an aesthetic that “screams an AI made this.” Anthropic itself attributes this to distributional convergence: safe choices dominate web training data. Other reported issues include broken mobile layouts and instructions leaking into UI copy.

Install the Frontend Design skill: It forces Claude to commit to a real direction and explicitly avoids fonts and gradients overused by AI.

Enable browser verification: Make Claude render and self-check across breakpoints so layouts do not silently break on mobile.

Supply tokens and references: Real design tokens and reference screenshots are the single biggest lever on output quality.

Encode rules in CLAUDE.md: Put “no hero cards, max two typefaces, brand-first hierarchy” style rules where the agent reads them every run.

Notice that every mitigation is about giving the agent a curated design context. Maintaining that context by hand, per project, is the toil OpenDesign removes.
Designing with Claude Code inside OpenDesign
OpenDesign is the open-source design layer the workflow above keeps asking for. It treats Claude Code as a first-party adapter and wraps it in a curated skill and design-system library, a structured render pipeline, and a local desktop UI — so the design context that makes Claude Code good is there from the first run, not assembled by hand each time.

Install OpenDesign and select Claude Code as your agent.

Authenticate with your Anthropic API key (BYOK) or Claude subscription — credentials stay on your machine and are never proxied through us.

Pick a design system and a skill, then generate decks, prototypes, and landing pages with consistent taste.

Every artifact and DESIGN.md file lives in your own repo, not a hosted cloud.

Same Claude Code agent, same key — plus a real, portable, open-source design workflow around it. It is local-first and Apache-2.0, so nothing about your work or your credentials leaves your machine.
Is this an official Anthropic product?
No. OpenDesign is an independent open-source project. Claude Code is a trademark of Anthropic; we integrate with it as a first-party adapter.

Start a First Design Task With Claude Code

Start with a small task, judge the round trip, then bring the real brief. Choose the option that matches your setup; the page does not detect it.

Where are you in the setup?
Download OpenDesign See the setup checklist

OpenDesign Desktop

One design system. Every output unmistakably your brand

Inside the full Vibe Design Workspace, use the same brand rules across websites, slide decks, interactive prototypes, dashboards, images, and HTML video. Connect Codex, Claude Code, Cursor, and other coding agents already on your computer, then create locally for free.

  • Web, slides, prototypes, dashboards, images, and video
  • 140+ design systems, plus the full template and skill library
  • Connect local Codex and 21+ coding agents · Free to use
Download free

Available for macOS and Windows