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

One Complete Claude Code Design Task

A Claude Code Design Task, From Brief to Interface

A single task, shown end to end: the brief and constraints you hand over, the artifact that comes back, and the checks you still run before it is done. The interface below is an illustrative example built for this page, not a recorded Claude Code run.

1Design Brief and Constraints

Brief

Design the workspace settings area for a small SaaS team: general, members, notifications and billing. Use the tokens in CLAUDE.md; nothing hand-tuned. It must work on desktop and on a phone.

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

2Division of Work: You, Claude Code and OpenDesign

  • You

    Write the brief, select the design system and define the acceptance criteria.

  • Claude Code

    Plans the layout, writes the HTML, CSS and JavaScript and revises it on request.

  • OpenDesign

    Provides the design system and skill, renders the preview and stores every version as a file in the project.

  • Review

    Visual hierarchy, spacing on the 8px grid, both breakpoints and every interaction are checked before handoff.

3Claude Code Artifact: The Settings Screen at 1440px and 390px

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

4Review Before Handoff

Layout

Grid and Spacing

Sub-navigation, form and actions sit on the 8px grid; the sticky save bar never overlaps a field.

Hierarchy

Visual Hierarchy

Group titles outrank labels; the accent marks the enabled toggles and nothing else.

Responsive

Mobile Layout

Sub-navigation becomes a segmented switch; toggles keep a 44px hit area; the save button spans the width.

Interaction

Interaction Checks

Tab through every field, flip a toggle, cancel and confirm the unsaved-changes prompt.

Fit

When Claude Code Fits the Task, and When It Does Not

Claude Code Fits When

  • Design system first. Drop a DESIGN.md / tokens / Tailwind config into the project so output matches a brand instead of defaulting to “AI slop”.
  • Aesthetic skills. Skills like Anthropic’s frontend-design make Claude Code commit to a typography/color/motion direction before writing any markup.
  • Figma → code. Wire the Figma MCP server in and Claude Code turns frames into production components with real tokens.
  • Screenshot loop. Let it screenshot its own UI, compare to a reference, and iterate — the agentic design feedback loop.

Choose Another Workflow When

  • You need editable vector files. The artifact is HTML, not an editable design document. Check a separate vector workflow for your required asset format.
  • You have no reference and no constraints. Without a design system or examples the output tends toward a generic look; write the brief first.
  • You do not have the credential this agent needs. Required: Anthropic API key (bring your own key) or Claude subscription. OpenDesign does not provide or proxy credentials.
  • Your team works in Codex or Cursor. Those agents have their own pages; the workspace is the same, the setup differs. See related agents.

Compatibility

Claude Code Requirements Before You Start

This guide covers Claude Code as connected through the OpenDesign desktop app. Published references checked on 6 September 2026.

Tool ScopeClaude Code, by Anthropic

Claude Code is Anthropic’s agentic command-line tool: you describe a task in natural language and it reads, writes, and runs code in your project until the task is done. 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. Authenticate with your Anthropic API key (BYOK) or Claude subscription — nothing is proxied through us. This page does not promise a quota or price.

System and VersionsDesktop app or source

Surfaces: terminal CLI, VS Code / Cursor / JetBrains extensions, desktop app, web. Check the download page for desktop builds. The Node.js and pnpm requirements in the source quickstart apply to running from source, not to installing a desktop package. Minimum compatible Claude Code version: not verified here.

Connection CheckThe success signal

Follow the connection instructions shown by your installed version, then run a small task. Confirm that Claude Code handled it and that the artifact opens. A download alone does not establish a working connection.

Start with the desktop app

Claude Code Setup in Three Steps

Download first, complete the Claude Code setup for your installed version, then check a small result. You do not need to build OpenDesign from source to follow this path.

  1. 1

    Download the OpenDesign Desktop App

    Choose the package for your computer, install it and open the app.

    Download OpenDesign
    CHECKPOINT
    The desktop app opens. Already installed? Move to the next step; there is no need to download again.
  2. 2

    Prepare Your Claude Code Connection

    Follow the Claude Code instructions in 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

    From the Claude Code setup notes in the published guide; check the vendor documentation for the current command.

    CHECKPOINT
    Confirm the intended agent and account. If it is unavailable, check compatibility before trying a larger task.
  3. 3

    Run One Small Claude Code Task

    Use a small brief so you can judge the whole loop, including one revision.

    Starter brief

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

    CHECKPOINT
    Open the result, test the save state and request one specific change. A generated file is the beginning of review, not the end.

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

The Claude Code design workflow

The Claude Code Design Workflow in Five Steps

The same settings screen task, followed from brief to verified file. Each step lists what you provide, what Claude Code does, what OpenDesign contributes and what you check.

  1. 1

    Design Brief

    Plain language, three to six lines. Name the audience, the job of the screen and the platforms.

    • YouWrite the brief; attach a reference screenshot if you have one.
    • Claude CodeReads the brief and the project’s instruction file; asks when something is ambiguous.
    • OpenDesignProvides the project, the prompt surface and the skill for the artifact type.
    • CheckConfirm the brief states the acceptance criteria. Adding them now is cheaper than after generation.
  2. 2

    Design Constraints

    A design system and a few hard rules. This 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 a line.
    • 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 writes 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 asked for. This is where the design is 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, 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. Every revision is 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 — but 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). This page makes no claim about free quotas.
  • 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 ReviewAccessibility, real content, brand fit and interaction correctness are reviewed by you 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.

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