# nano.design in Codex

Codex designs in nano.design as real HTML and CSS, checks its work with screenshots, and builds the result in your codebase. One setup covers the Codex CLI, the Codex IDE extension and Codex in the ChatGPT desktop app, because they share a configuration.

## Add nano.design

```bash
codex mcp add nano --url https://nano.design/mcp
codex mcp login nano
```

The first command adds the server to `~/.codex/config.toml`. The second opens nano.design in your browser to sign in.

To add it by hand instead, put this in `~/.codex/config.toml`, or in a project's `.codex/config.toml`:

```toml ~/.codex/config.toml
[mcp_servers.nano]
url = "https://nano.design/mcp"
```

## Try it

- "Design the onboarding screens for this CLI's web dashboard in nano.design. Send me the live link first."
- "Show me two directions for the marketing site in nano.design, then build the one I pick."

## If something goes wrong

- **No browser on this machine.** Run `codex mcp login nano --no-browser` and open the printed URL somewhere you can sign in.
- **The IDE extension doesn't show nano.** Open the gear menu, then **MCP servers**, and check nano is listed and enabled.
- **You signed in with the wrong account.** Run `codex mcp logout nano`, then `codex mcp login nano` again.

## 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:

```bash
npx skills add nano-design-org/skills --skill design-taste
```

In Claude, [download the skill](https://nano.design/skills/design-taste.zip) and upload it under **Settings → Capabilities**. People can read the same guidance as the [design guide](/guide).
