nano.design in Claude Code
Claude Code designs in nano.design as real HTML and CSS, screenshots its own work and refines it. When the design is right, it reads the frame back as code, tokens and assets and builds it in your project.
Add nano.design
claude mcp add --transport http nano --scope user https://nano.design/mcp
--scope user makes nano.design available in every project. Leave it out to add it to the current project only, or use --scope project to write it to the project's .mcp.json, so everyone on the project gets it.
Sign in
Start Claude Code, run /mcp, choose nano and follow the sign-in in your browser. From a shell, claude mcp login nano does the same.
Try it
- After you've adjusted the design yourself
Handoff gives Claude Code the frame's React code, only the tokens it uses, its fonts and its images, so what it builds matches what you approved.
If something goes wrong
- The browser doesn't open. Copy the sign-in URL Claude Code prints and open it yourself.
- The redirect fails with a connection error. Copy the full URL from the browser's address bar and paste it into Claude Code's prompt.
- You signed in with the wrong account. Run
/mcp, choose nano, then Clear authentication, and sign in again. - The tools are missing. Run
claude mcp list. nano should be listed as connected; if it isn't, run/mcpand sign in.
What signing in looks like
Your client opens nano.design in the browser. Sign in with Google, GitHub or an emailed link, then click Allow access. Keep Open nano in a new tab checked to watch the design appear as it's made.
No account yet? Choose Try without an account. The agent gets a guest workspace for 2 hours, with room for 10 designs, and gives you a link to keep them. Sign in from that link and the designs move into your account. Otherwise they're deleted.
Every change an agent makes is saved as a version, so you can go back to any earlier state.
Better designs from the start
Agents design better with taste. In Claude Code, Cursor, Codex, opencode and other agents that support skills, install the free design-taste skill:
npx skills add nano-design-org/skills --skill design-taste
In Claude, download the skill and upload it under Settings → Capabilities. People can read the same guidance as the design guide.