21st AI 是一个快速的 UI 草图工具，整体思路是“在这里起草，再去完成它”：根据提示词画出若干变体，预览它们，用自然语言对满意的那一个进行细化，然后把它对应的代码取回仓库。整个循环都通过 21st CLI（或对应的 MCP 工具）运行，因此无需离开编辑器。
【主要能力】 草图模式会生成自包含的 HTML + Tailwind 草稿（速度快，无需构建）。官方推荐交付方式是 copy-prompt：一段规格说明，指示你在目标项目的真实技术栈中重建该设计，而不是逐字粘贴原始 HTML。
【使用方式】 整个循环的命令如下： 1）Sketch——从提示词生成变体（即“takes”），会在浏览器中打开预览并打印 projectId： 21st generate "a pricing section with 3 tiers and a monthly/annual toggle" 2）列出所有变体（从 1 开始的编号，并显示每个是否已渲染）： 21st generation <projectId> 3）用自然语言修改某一个变体（就地编辑，计费）： 21st iterate <projectId> "make it enterprise-flavored, add an annual toggle" --take 3 4）提取代码到项目中（免费）： 21st take <projectId> --take 3 # 可直接粘贴的 copy-prompt（推荐） 21st take <projectId> --take 3 --code # 改为原始自包含 HTML 可在编辑器内置浏览器中打开预览 URL（由 generate 打印、由 iterate 返回），实时观察变体的渲染与就地更新。
各命令的适用时机：generate 用于从提示词全新开始，返回预览 URL 与 projectId；generation 用于列出变体，确定应对哪个 --take N 操作；iterate 用于细化已存在的变体（就地编辑，会追加新版本，便于在工作区中回退），用于修改已生成的内容而不是重新开始；take 用于提取变体代码，默认打印 copy-prompt（适配自身技术栈的规格），加 --code 打印原始 HTML，两者都免费且不限量。
【鉴权】 与 CLI 其它部分使用同一凭据：21st login（保存 token），或通过 --api-key / TWENTYFIRST_TOKEN 传入 21st_sk_ 密钥。21st usage（MCP 中的 get_usage）会显示账户层级、aiGenerationEnabled 以及剩余的每日免费组件代码检索额度，但不报告 AI 额度余额。在生成或迭代前，请检查 MCP 的 get_usage.aiGenerationEnabled 或 21st usage 中的 21st AI generation 行。CLI 1.17.1 也支持 21st usage --json。只有在 AI 被明确启用时才继续；状态缺失或未知不视为已授权。基础 Builder 订阅不会启用 AI。当该值为 false 时，应使用 search → get_component，并借助用户自己的智能体适配代码。不要尝试 generate 或 iterate_generation，包括通过 CLI 作为兜底也不要。
【计费】 generate 需要账户启用 AI 并有可用的 AI 额度；Builder 和 Team 默认关闭 AI，仅凭会员身份不会启用。iterate 按每次编辑的真实 token 成本计费（共享的 21st AI 额度池），每次调用都会进行真实的模型工作，因此建议把多项修改合并为一条清晰指令，而不是拆成许多小指令。generation（列表）和 take（取代码）免费。
【MCP 对应能力】 同一循环也以 MCP 工具形式提供给 MCP 宿主（Cursor、Claude Desktop、Claude Code）：generate（带 mode: "sketch"）、get_generation、iterate_generation 和 get_take。iterate_generation 还会返回刚编辑过的 html + copyPrompt，因此无需第二次调用即可取到代码。可用 21st init --client <name> --write 配置服务器。MCP 工具列表取决于账户：仅当 AI 启用时才列出 generate 和 iterate_generation；get_generation 和 get_take 仍可用于读取已有草稿。启用 AI 后，请刷新客户端的工具列表或重新连接 MCP 服务器。如果缓存中的工具调用返回 ai_subscription_required，应停止生成尝试，改用上述组件搜索与检索工作流。
【提示】 草图是草稿，不是生产代码——应把 copy-prompt 视为设计规格，在项目真实组件中重建；不要原样粘贴 HTML。引用变体时使用 generation 中从 1 开始的编号或预览中的“Take N”标签；--take 必须是大于等于 1 的整数（非法值会报错，而不是默默编辑 take 1）。只有你自己创建的草图生成才能被列出、编辑或获取。
【适用场景与限制】 适用于需要从提示词快速起草 UI、比较多个设计变体、用自然语言迭代设计，并把结果作为设计规格带回真实项目的场景。限制包括：generate 依赖账户启用 AI 与 AI 额度，Builder/Team 默认不启用；iterate 计费且每次调用都做真实模型工作；草图产物为自包含 HTML + Tailwind，官方不建议直接作为生产代码粘贴；仅能操作自己创建的生成。关于价格、免费额度具体数值、支持平台等更多信息暂未提供。