Setup guide接入指南
Use Curio with Codex在 Codex 里用 Curio
Codex can build whole interfaces — but on its own it defaults to the same generic look as every other agent. Connect Curio and it can apply any of 989 real design styles instead, consistently, without you writing a design spec by hand.Codex 能搭出整套界面 —— 但单独用时,它默认跟其它 agent 一样的「通用脸」。连上 Curio,它就能改用 989 真实设计风格中的任意一种,而且一致,不用你手写设计规范。
What this gives Codex这给 Codex 带来什么
Curio runs a Model Context Protocol (MCP) server. Once Codex is connected, it gains tools to search the library, read a style's metadata, and fetch the full design spec — colors, typography, spacing, components, and rules — for whatever you are building.Curio 跑着一个 Model Context Protocol (MCP) 服务。Codex 连上后,就获得了搜索风格库、读取风格元数据、以及取用完整设计规范(色彩、字体、间距、组件、规则)的工具,用于你正在做的东西。
It is read-only and sign-in based: you connect once with OAuth, no API keys to manage. The Codex CLI and IDE share the same ~/.codex/config.toml, so one entry covers both — and the same connection also works in Claude Code, Cursor, VS Code, and other MCP clients.它是只读、登录制的:用 OAuth 连一次,不用管 API key。Codex 的 CLI 和 IDE 共用同一份 ~/.codex/config.toml,所以一条配置两边都生效 —— 同一个连接在 Claude Code、Cursor、VS Code 等 MCP 客户端里也都能用。
Setup配置步骤
-
1
Add Curio to ~/.codex/config.toml在 ~/.codex/config.toml 里加上 Curio
Add an MCP server entry pointing at https://mcp.designbycurio.com/mcp in your ~/.codex/config.toml. This file is shared by the Codex CLI and IDE, so both pick it up. The developer docs show the exact entry format.在 ~/.codex/config.toml 里加一条指向 https://mcp.designbycurio.com/mcp 的 MCP 服务条目。这个文件由 Codex 的 CLI 和 IDE 共用,两边都会读到。具体写法见开发者文档。
-
2
Sign in with OAuth用 OAuth 登录
On first connect, Codex opens the OAuth sign-in flow in your browser. Sign in with email, Google, or GitHub and approve. A free account works for free styles; Pro or Max unlocks the full library.首次连接时,Codex 会在浏览器里打开 OAuth 登录流程。用邮箱、Google 或 GitHub 登录并同意。免费账户可用免费风格;Pro 或 Max 解锁完整库。
-
3
Find a style找一种风格
Ask Codex to search Curio — for example, "search Curio for a bold editorial style" — or name one directly, like Bauhaus or Stripe. It uses search_styles and get_style to pick a match.让 Codex 搜 Curio —— 比如「在 Curio 里搜一个大胆的编辑风格」—— 或直接点名,比如包豪斯或 Stripe。它会用 search_styles 和 get_style 选出匹配。
-
4
Apply it to your build套到你的项目上
Tell Codex to build in that style. It fetches the full spec with get_style_spec and generates your page, component, or deck using the style's exact tokens and rules.让 Codex 用那种风格来生成。它会用 get_style_spec 取来完整规范,按该风格的精确 token 和规则生成你的页面、组件或幻灯片。
What you get你能得到什么
Consistent output: every screen Codex generates holds the same look, because it works from one authoritative spec instead of re-guessing each time.输出一致:Codex 生成的每一屏都保持同一个外观,因为它依据的是一份权威规范,而不是每次重新猜。
Real, distinct styles: hundreds of movements, brands, and traditions — not the generic default — so your work stops looking AI-generated.真实、各异的风格:几百种流派、品牌与传统 —— 不是通用默认脸 —— 你的作品不再「一看就是 AI 做的」。
No file wrangling: you never hand-write or hunt for a DESIGN.md; Codex fetches it live over MCP.不用折腾文件:你永远不用手写或到处找 DESIGN.md;Codex 通过 MCP 实时取来。
Example prompts示例 prompt
Search Curio for a clean fintech style and rebuild this dashboard component in it.在 Curio 里搜一个干净的金融科技风格,用它重写这个仪表盘组件。
Use the Memphis style from Curio to build the landing page hero for this product.用 Curio 里的孟菲斯风格,给这个产品做落地页的 hero 区。
FAQ常见问题
Does the CLI and IDE need separate setup?CLI 和 IDE 要分别配置吗?
No. The Codex CLI and IDE both read ~/.codex/config.toml, so a single MCP server entry there covers both. You only sign in once.不用。Codex 的 CLI 和 IDE 都读 ~/.codex/config.toml,所以那里加一条 MCP 服务条目就两边都生效,登录也只需一次。
Does fetching a style cost anything?取用一种风格要花钱吗?
Fetching a style's full spec uses one quota credit, the same as a download on the website. Free accounts get a set allowance; Pro and Max get more on a rolling window. Searching and reading metadata is free.取用一种风格的完整规范会消耗一个额度,跟网站上下载一次一样。免费账户有一定额度;Pro 和 Max 在滚动周期内更多。搜索和读元数据免费。
Does this work in other tools too?在别的工具里也能用吗?
Yes. The same MCP endpoint works in Claude Code, Cursor, VS Code, ChatGPT, and other MCP-capable clients. See the developer docs for per-client setup.能。同一个 MCP 端点在 Claude Code、Cursor、VS Code、ChatGPT 等支持 MCP 的客户端里都能用。逐客户端配置见开发者文档。