Claude Code OpenDesign

用 Claude Code
在 OpenDesign
做设计。

在 OpenDesign 中使用 Claude Code 设计界面:以 CLAUDE.md 和 Frontend Design skill 作为约束条件,一项从 brief 到通过审阅的文件的工作区设置任务,以及 Figma 往返流程在何处止步。

本页内容 示例
  1. 示例
  2. 适用场景
  3. 兼容性
  4. 环境搭建
  5. 工作流
  6. 资源
  7. 局限性
  8. 常见问题

一次 Claude Code 设计演练

从简报到界面:一个 Claude Code 设计任务

本演练跟踪一个任务从交接开始的全过程:你给 Claude Code 的简报和约束、它返回的产物,以及在你签收前仍由你负责的检查。下面的界面是为本页构建的示意图,并非真实 Claude Code 会话的截图。

1设计 Brief 与约束条件

Brief

为一个小型 SaaS 团队设计工作区设置区域:常规、成员、通知和账单。从 CLAUDE.md 中的令牌提取值;不要手工调整的例外。它必须在桌面端和手机上都能站得住脚。

  • 设计系统来自 CLAUDE.md 的令牌与基础组件;Albert Sans;单一绿色强调色
  • 断点1440px 桌面端与 390px 移动端,无横向滚动
  • 交互分区切换、开关、未保存更改栏,以及键盘焦点顺序
  • 输出一个单一的自包含 HTML 文件,带有稳定的 data-od-id 钩子

2谁做什么:你、Claude Code 和 OpenDesign

  • 你

    你撰写简报、选择设计系统,并设定验收标准。

  • Claude Code

    Claude Code 规划布局,编写 HTML、CSS 和 JavaScript,然后按请求修订。

  • OpenDesign

    OpenDesign 提供设计系统和技能,渲染预览,并将每个版本保留为项目文件。

  • 审查

    在交接前,检查视觉层级、8px 网格上的间距、两个断点以及每个交互。

3Claude Code 输出:1440px 和 390px 下的设置屏幕

Claude Code 输出:1440px 和 390px 下的设置屏幕 — 桌面端
示意性示例

4交付前审查

Layout

网格与间距

子导航、表单和操作对齐到 8px 网格;粘性保存栏从不遮挡字段。

Hierarchy

视觉层级

分组标题比标签更重;强调色只出现在已启用的开关上。

Responsive

移动端布局

在移动端宽度下,子导航变为分段切换;开关保持 44px 的点击区域;保存按钮横跨整个宽度。

Interaction

交互检查

用 Tab 键遍历每个字段,切换一个控件,然后取消并确认未保存更改提示。

Fit

Claude Code 适合哪里——以及不适合哪里

Claude Code 适用场景

  • 设计系统优先。 在项目中放入 DESIGN.md / tokens / Tailwind 配置,让 Claude Code 匹配品牌,而不是滑向“AI 垃圾”。
  • 美学技能。 诸如 Anthropic 的 frontend-design 之类的技能会推动 Claude Code 在编写标记之前先选择排版/颜色/动效方向。
  • Figma → 代码。 连接 Figma MCP 服务器,Claude Code 就能将画框转变为带有真实令牌的生产组件。
  • 截图循环。 让 Claude Code 截取自己的 UI 截图,与参考进行比较并迭代——这就是智能体设计反馈循环。

选择其他工作流的场景

  • 你需要可编辑的矢量文件。 Claude Code 返回 HTML,而不是可编辑的设计文档。对于该资产格式,请使用单独的矢量工作流。
  • 你没有参考也没有约束。 没有设计系统或示例时,Claude Code 倾向于通用外观;先起草简报。
  • 你没有此代理所需的凭证。 需要:Anthropic API 密钥(自带密钥)或 Claude 订阅。OpenDesign 既不提供也不代理凭证。
  • 你的团队使用 Codex 或 Cursor。 这些代理有自己的页面;OpenDesign 跨代理保留一个工作区,但设置不同。参见 相关代理。

兼容性

开始前 Claude Code 的要求

本页将 Claude Code 视为通过 OpenDesign 桌面应用连接。已发布参考资料核查于 2026 年 9 月 6 日。

工具范围Claude Code,由 Anthropic 出品

Claude Code 是 Anthropic 的智能体命令行工具:用自然语言描述任务,它就会在项目中读取、写入并运行代码,直到任务完成。它独立于 Anthropic 托管的 Claude Design 产品;Claude Design 对比 涵盖了该选择。本页讲的是通过 OpenDesign 使用 Claude Code 设计界面,而不是 Claude Code 自身的界面。OpenDesign 的 设置说明 列出了可用代理。

账户与身份验证Anthropic API key(BYOK)或 Claude

Anthropic API 密钥(BYOK)或 Claude 订阅。你使用自己的 Anthropic API 密钥(BYOK)或 Claude 订阅进行身份验证——没有任何内容通过我们代理。本页不承诺任何配额或价格。

系统与版本桌面应用或源码

可作为终端 CLI、VS Code / Cursor / JetBrains 扩展、桌面应用和 Web 使用。对于桌面版构建,请参阅下载页面。源代码快速开始中的 Node.js 和 pnpm 要求适用于从源代码运行,而不适用于安装桌面软件包。最低兼容 Claude Code 版本:此处未验证。

连接检查成功的标志

使用你所安装版本显示的连接说明,然后尝试一个适度的任务。确认 Claude Code 完成了该任务,并且产物可以打开。仅下载代理并不能证明连接可用。

从桌面应用开始

三步完成 Claude Code 设置

从下载开始,完成你所安装版本的 Claude Code 设置,然后验证一个适度结果。遵循此路径不需要从源代码构建 OpenDesign。

  1. 1

    下载 OpenDesign 桌面应用

    选择适合你机器的软件包,安装它,然后打开桌面应用。

    下载 OpenDesign
    检查点
    桌面应用打开。如果已安装,请前往下一步;无需再次下载。
  2. 2

    准备你的 Claude Code 连接

    遵循随你所安装版本提供的 Claude Code 说明。使用你的 Anthropic API 密钥(BYOK)或 Claude 订阅进行身份验证——没有任何内容通过我们代理。

    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

    摘自已发布指南中的 Claude Code 设置说明;请在供应商文档中核实当前命令。

    检查点
    确认你打算使用的代理和账户。如果 Claude Code 不可用,请在转向更大任务前查看兼容性。
  3. 3

    运行第一个小型 Claude Code 任务

    让第一个简报保持适度,以便你评判完整循环,包括一次修订。

    入门 brief

    构建一个带有个人资料表单和保存确认的设置屏幕。遵循我的设计规则。在桌面端和移动端宽度下检查它。

    检查点
    打开产物,演练保存状态,并请求一项具体更改。生成只是开始审查;它并不结束审查。

若要从源代码运行 OpenDesign,请改用 技术快速开始。

Claude Code 设计工作流

Claude Code 设计工作流:从简报到已审查文件的五个步骤

一个工作区设置任务,从简报追踪到已验证文件。每一步都展示你交付什么、Claude Code 做什么、OpenDesign 贡献什么,以及你检查什么。

  1. 1

    设计 Brief

    用平实语言,三到六行。说明受众、屏幕的用途以及平台。

    • 您撰写简报;有参考截图时附上它。
    • Claude Code阅读简报和 CLAUDE.md;当有歧义时提问。
    • OpenDesign提供项目、提示界面以及适用于该产物类型的匹配技能。
    • 检查确认简报包含验收标准。现在添加它们比生成后添加成本更低。
  2. 2

    设计约束

    一个设计系统和几条硬性规则。这种组合正是将符合品牌的产品与通用外观区分开来的关键。

    • 您选择一个设计系统;说明断点及必须使用的组件。
    • Claude Code在编写任何标记之前,将 DESIGN.md 令牌和姿态规则加载到上下文中。
    • OpenDesign提供设计系统库,并将所选设计系统绑定到 skill 模板中。
    • 检查确认 token 与您的品牌相符:单一强调色、正确的字体、正确的圆角。
  3. 3

    生成界面

    Claude Code 生成一个自包含的 HTML 文件:布局、样式、交互和稳定的钩子。

    • 您等待即可,或回答澄清性问题。无需进行任何配置。
    • Claude Code规划各个区块,编写 HTML、CSS 和 JavaScript,运行该文件并修复失败之处。
    • OpenDesign将产物保存到项目文件夹中,并为预览建立索引。
    • 检查此步骤暂无需检查。请在文件渲染后进行判断,而非查看源代码。
  4. 4

    预览

    该文件在你指定的宽度下在 OpenDesign 内渲染。设计就是在这里接受评判。

    • 你切换宽度,点击交互,在元素上留下评论。
    • Claude Code读取你在预览上留下的评论,并准备下一版修订。
    • OpenDesign渲染预览,并暴露 data-od-id 目标以供评论和编辑。
    • 检查层级结构、对比度、390px 下的溢出、焦点状态,以及强调色是否使用得克制。
  5. 5

    修订与验证

    通过在预览中指向元素来请求更改。每次修订都会生成一个新文件;任何内容都不会被静默覆盖。

    • 你把评论转化为请求;决定任务何时完成。
    • Claude Code就地应用更改并重新运行该文件。
    • OpenDesign将各版本并排保留;完成后导出图片或 HTML。
    • 检查只重新检查发生变化的区域,然后在每个断点上完整检查一次整页。

资源

Claude Code 设计资源

限制

Claude Code 的局限性、人工检查与后备方案

  • 适用范围它是一个编程智能体,而不是设计工具——然而设计正是其最突出的涌现用途之一。在具备合适的技能以及上下文中的设计系统时,它能够生成可用于生产的 HTML/CSS/React,基于截图进行迭代,并维护设计令牌。本页讲述的是作为连接到 OpenDesign 的智能体的 Claude Code,而非 Claude Code 的每一项功能。
  • 使用限额使用限制与费用取决于你使用的凭据(Anthropic API 密钥或 Claude 订阅)。此处不对免费额度作任何声明。
  • 网络本地项目文件并不代表离线推理。在分享敏感输入之前,请检查你的 Agent 供应商设置和数据政策。
  • 输出为 HTML产物是 HTML 文件,而非矢量设计文件。Figma 往返需通过 Claude Code 自身的 Figma 集成完成。
  • 人工审查你需要在预览中审查无障碍性、真实内容、品牌契合度与交互正确性。智能体所做的任何自检都应视为初步检查。
  • 后备方案如果 Agent 不可用或任务失败,请检查所安装版本的连接说明和身份验证。在更改配置前,请保留错误信息和最后一个可用的产物。

常见问题

关于 Claude Code 与 OpenDesign 的常见问题

Claude Code 适合用于设计工作吗?
是的——它被普遍认为是前端审美最佳的编程 Agent,能够针对代码库做出具体的十六进制颜色值、间距和字号比例的决策。在 Frontend Design skill、设计系统以及真实参考图像的上下文加持下,它能生成生产级、响应式的 UI,并可在浏览器中进行验证。若缺少这些上下文,它往往会默认呈现通用外观,这正是 OpenDesign 填补的空白。
使用 Claude Code 进行设计需要 Claude 订阅吗?
您可以使用 Anthropic API key(BYOK,通过 Console 获取),也可以使用 Claude 订阅(Pro / Max)。无论哪种方式,OpenDesign 都不会代理您的凭证——它们始终由您本机上的 Agent 直接使用。
前端设计该选 Claude Code 还是 Codex?
两者都很出色。Claude Code 以具体、贴合代码库的设计决策和前端推理见长;Codex 则拥有出色的视觉打磨能力,擅长委托式、沙盒化的构建。许多团队同时使用两者——OpenDesign 让您无需改变设计工作流即可切换 Agent。
如何将 Claude Code 与 Figma 连接?
通过 claude plugin install figma@claude-plugins-official 安装官方 Figma 插件。之后,您可以利用设计上下文在代码中实现 Figma frames,并通过“发送到 Figma”将正在运行的 UI 推送回可编辑的 Figma frames。Dev Mode MCP 需要付费 Figma 计划。
什么是 skill 和 CLAUDE.md?
CLAUDE.md 是位于项目根目录的 markdown 文件,Claude Code 会在每次会话开始时读取它——这是编码您的设计规范的地方。Skill 则封装了可重复使用的指令与资源,供 Claude 按需加载,其中包括 Anthropic 官方的 Frontend Design skill。OpenDesign 提供两者的精选库,让您省去逐项目配置的步骤。
Claude Code 究竟是什么
Claude Code 是 Anthropic 的智能体编程工具。它会读取你的代码库、编辑文件、运行命令,并与你的开发工具集成——从自然语言任务出发进行规划、编写和验证,而不只是逐行自动补全。

它以多种形态发布,但共用同一套引擎:终端 CLI、适用于 VS Code、Cursor 和 JetBrains 的 IDE 扩展、带可视化差异审查的桌面应用,以及用于长时间运行任务的网页端体验。你的 CLAUDE.md 文件、设置和 MCP 服务器在所有形态之间通用。

指令文件:Claude Code 会在每次会话开始时读取项目根目录下的 CLAUDE.md 文件——这正是写入你的设计规范、令牌和审查清单的天然位置。

技能:Agent Skills 把可重复使用的指令、脚本和资源打包起来,由 Claude 按需加载,其中就包括 Anthropic 官方用于提升品味的 Frontend Design 技能。

规划与子智能体:它可以在行动前先做规划,并派生并行处理任务不同部分的子智能体,从而让大型 UI 重构保持连贯。

凭据:Anthropic API 密钥(BYOK,通过 Console)或 Claude 订阅(Pro / Max)

厂商:Anthropic
为什么 Claude Code 擅长设计
在各类编程智能体中,Claude Code 在前端工作上以品味著称。有几个原因可以解释这一点。

决策具体而非含糊:Claude Code 倾向于给出确定的选择——精确的十六进制色值、间距尺度、字体层级和组件层级——而不是含糊带过,这正是真正的界面与占位效果之间的分界。

理解代码库的推理:凭借较大的工作上下文,它能一次性重构跨多个文件的 UI,复用你现有的组件和令牌,而不是另造一套一次性的样式。

官方前端技能:Anthropic 提供了 Frontend Design 技能,它让 Claude 先写出设计方向,并有意识地避开通用的系统字体和可预料的紫色渐变。

品味来自你提供的三类输入:一套设计系统、一项技能,以及真实的参考图。

这里的道理与 Anthropic 对其自身模型的说法一致:Claude 默认并没有品味——放任不管,它会收敛到网页设计的统计中心(Inter、紫色渐变、柔和阴影)。只有你给出约束,它才能产出好的设计。OpenDesign 恰恰把这些输入打包好了,这也是二者契合的原因(详见下文)。
从零开始为设计工作配置 Claude Code
配置顺序:安装 → 身份验证 → 配置 CLAUDE.md → 添加 Frontend Design 技能 → 启用浏览器验证。

把你的设计规则写进去:将令牌、基础组件和约定放入 CLAUDE.md 并让 Claude 参照它们,这样输出就会贴合品牌,而不是默认落入通用外观。

加入浏览器验证:接入 Playwright 或 Chrome MCP,让 Claude 在真实浏览器中渲染并跨断点检查自己的输出,而不只是确认构建能通过。

命令与版本相关的细节请以当前的配置章节为准,这些内容可能会变化。

# 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 # 3. Generate project context /init # creates a CLAUDE.md for this project # 4. Add the official Frontend Design skill claude plugin install frontend-design@claude-plugins-official # 5. Wire the Figma MCP server (optional, for design handoff) claude plugin install figma@claude-plugins-official
这是上一版指南中的历史命令示例;请到所链接的厂商文档中核对当前语法。
CLAUDE.md 与 Skills 工作流
用 Claude Code 做设计时,效率最高的循环是:喂给它真实参考图加上你的设计上下文,然后反复迭代直到 UI 对得上——同时用 CLAUDE.md 和 Skills 承载约束,这样就不必每次提示都重新解释一遍。

从你手头最清晰的视觉参考出发——并且要包含多种状态(桌面端与移动端、悬停、空状态、加载中),而不只是一张主视觉图。

提示要具体;即便智能体很强,含糊的提示也只会产出通用的 UI。

把设计系统和约定放在 CLAUDE.md 里,并告诉 Claude 令牌和标准基础组件位于何处。

添加 Frontend Design 技能,让 Claude 在写代码之前先确定一个真正的美学方向。

接入浏览器验证,让 Claude 渲染、缩放到各个断点,并与参考图比对——而不只是确认它能构建成功。

把参考图拖进会话,用具体约束来提示:

同时运行一个开发服务器,让提示保持小而聚焦,并提交好的迭代 / 回退坏的迭代(回退时告知 Claude),这样每一轮都建立在一个干净的基础上。较大的重构请使用计划模式,以便在任何文件改动之前先审阅方案。

claude "Implement reference-desktop.png and reference-mobile.png in React + Vite + Tailwind + TypeScript. Reuse the design-system components and tokens described in CLAUDE.md. Match spacing, layout, and hierarchy; make it responsive. Render it in the browser, verify it matches the references across breakpoints, and iterate until it does."
这是上一版指南中的历史命令示例;请到所链接的厂商文档中核对当前语法。
Claude Code + Figma:设计 ↔ 代码双向往返
2026 年 2 月,Anthropic 与 Figma 通过 Figma MCP 服务器推出了一等的双向集成。两个方向都能用。

设计 → 代码:在 Figma 中选中一个画框,或把链接粘贴到 Claude Code,拉取设计上下文,然后让它用你现有的组件库实现该设计。Code Connect 会让输出与你真实的组件保持一致。

代码 → 设计:在浏览器中构建并预览某项功能,然后说 “Send this to Figma”,即可把运行中的 UI 捕获为可编辑的 Figma 图层——可以是整个屏幕,也可以是选中的元素。

用 claude plugin install figma@claude-plugins-official 安装一次即可(Dev Mode MCP 需要付费的 Figma 方案)。同一个 Figma MCP 可供 Claude Code、Codex、Cursor 和 VS Code 使用——正是 OpenDesign 旨在编排的那种可移植、多智能体能力。
设计上 Claude Code、Codex 与 Cursor 的对比
设计工作没有唯一的赢家——每个智能体各有不同的强项,经验丰富的团队会把它们叠起来用。一个公允的总结:

Claude Code —— 具体的设计决策(色值、间距、字体)与理解代码库的 UX 推理 —— 前端推理与大规模上下文重构

Codex —— 出色的视觉打磨与图像理解;沙盒化异步构建 —— 委派的异步构建与可移植的 AGENTS.md 规则

Cursor —— 带实时预览和行内编辑的“边构建边看”视觉循环 —— 在 IDE 内进行紧凑的迭代-观察式 UI 工作

社区反复得出的结论是:品味来自人。如果没有技能、参考图和约束,这三者都会默认落入通用的审美。这才是真正要解决的问题——而且它属于设计工具层面的问题,不是模型层面的问题。

智能体 — 设计强项 — 最适合
常见坑,以及如何避免“AI 味”外观
即便 Claude Code 以品味著称,关于 AI 生成设计最常见的抱怨仍是它看起来千篇一律——Inter 字体、白底紫色渐变、柔和阴影、过大的圆角,一种“一看就是 AI 做的”审美。Anthropic 自己把这一点归因于分布收敛:安全的选择主导了网页训练数据。其他被报告的问题还包括移动端布局错乱,以及指令泄漏进 UI 文案。

安装 Frontend Design 技能:它会迫使 Claude 确定一个真正的方向,并明确避开 AI 过度使用的字体和渐变。

启用浏览器验证:让 Claude 渲染并跨断点自查,这样布局就不会在移动端悄无声息地崩掉。

提供令牌与参考图:真实的设计令牌和参考截图是影响输出质量最大的一个杠杆。

把规则写进 CLAUDE.md:把“不要 hero 卡片、最多两种字体、品牌优先的层级”这类规则放在智能体每次运行都会读到的地方。

注意,每一项缓解措施本质上都是给智能体一份精心整理的设计上下文。逐个项目手工维护这份上下文,正是 OpenDesign 要消除的苦差事。
在 OpenDesign 内用 Claude Code 做设计
OpenDesign 就是上述工作流一再需要的那层开源设计层。它把 Claude Code 当作一等适配器,并为其加上精心整理的技能与设计系统库、结构化渲染流水线以及本地桌面 UI——因此让 Claude Code 表现出色的设计上下文从第一次运行起就已就位,而无需每次手工拼装。

安装 OpenDesign,并选择 Claude Code 作为你的智能体。

用你的 Anthropic API 密钥(BYOK)或 Claude 订阅完成身份验证——凭据留在你的机器上,绝不经过我们的代理。

挑选一套设计系统和一项技能,然后生成品味一致的演示文稿、原型和落地页。

每个产物和 DESIGN.md 文件都存放在你自己的仓库中,而不是托管的云上。

同样的 Claude Code 智能体、同样的密钥——外加围绕它的真实、可移植、开源的设计工作流。它本地优先且采用 Apache-2.0,因此你的工作和凭据都不会离开你的机器。
这是 Anthropic 的官方产品吗?
不是。OpenDesign 是一个独立的开源项目。Claude Code 是 Anthropic 的商标;我们以一等适配器的身份与它集成。