Claude Code OpenDesign

用 Claude Code
在 OpenDesign
做设计。

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

从 brief 到界面01 / Claude Code
您带来想法

“工作区设置遵循
我们的 token,而非模板。”

示意性界面 · 非实际产品录屏
本页内容 示例
  1. 示例
  2. 适用场景
  3. 兼容性
  4. 环境搭建
  5. 工作流
  6. 资源
  7. 局限性
  8. 常见问题

一个完整的 Claude Code 设计任务

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

一个完整呈现的单一任务:你交付的 brief 与约束条件、返回的产物,以及在任务完成前你仍需运行的检查。下方界面是为本页面构建的示例说明,并非记录下来的 Claude Code 运行结果。

1设计 Brief 与约束条件

Brief

为一个小型 SaaS 团队设计工作区设置区域:通用、成员、通知和账单。使用 CLAUDE.md 中的 token;不要手动调整任何内容。必须同时适配桌面端和手机端。

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

2分工:你、Claude Code 与 OpenDesign

  • 撰写 brief,选择设计系统并定义验收标准。

  • Claude Code

    规划布局,编写 HTML、CSS 和 JavaScript,并按要求进行修改。

  • OpenDesign

    提供设计系统与 skill,渲染预览,并将每个版本作为文件存储在项目中。

  • 审查

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

3Claude Code 产物:1440px 和 390px 下的设置界面

Claude Code 产物:1440px 和 390px 下的设置界面 — 桌面端
示意性示例

4交付前审查

Layout

网格与间距

子导航、表单与操作均对齐 8px 网格;悬浮保存栏不会遮挡任何字段。

Hierarchy

视觉层级

分组标题优先于标签;强调色仅用于标记已启用的开关,不用于其他任何元素。

Responsive

移动端布局

子导航变为分段切换器;开关保持 44px 的点击区域;保存按钮占满整个宽度。

Interaction

交互检查

用 Tab 键遍历每个字段,切换一个开关,取消并确认未保存更改的提示。

Fit

Claude Code 何时适合此任务,何时不适合

Claude Code 适用场景

  • 设计系统优先。 将 DESIGN.md/token/Tailwind 配置放入项目中,让输出匹配品牌,而不是默认生成“AI 味”的效果。
  • 美学 skill。 像 Anthropic 的 frontend-design 这类 skill,能让 Claude Code 在写任何标记之前先确定字体、色彩和动效方向。
  • Figma → 代码。 接入 Figma MCP 服务器后,Claude Code 会把 frame 转换为带有真实 token 的生产级组件。
  • 截图循环。 让它对自己的界面截图,与参考图对比并迭代——这就是 Agent 化的设计反馈循环。

选择其他工作流的场景

  • 你需要可编辑的矢量文件。 产物是 HTML,而非可编辑的设计文档。请查看其他矢量工作流以获取所需的资源格式。
  • 没有参考图也没有约束条件。 缺少设计系统或示例时,输出往往趋于千篇一律;请先写好 brief。
  • 你没有该 Agent 所需的凭证。 需要:Anthropic API key(自带密钥)或 Claude 订阅。OpenDesign 不提供也不代理凭证。
  • 你的团队使用 Codex 或 Cursor 工作。 这些 Agent 有各自的页面,工作区相同,设置方式不同。请参见相关 Agent

兼容性

开始前的 Claude Code 要求

本指南涉及通过 OpenDesign 桌面应用连接的 Claude Code。已发布参考资料的核对日期为 2026 年 9 月 6 日。

工具范围Claude Code,由 Anthropic 出品

Claude Code 是 Anthropic 的 Agent 化命令行工具:你用自然语言描述任务,它会在你的项目中读取、编写并运行代码,直到任务完成。本页介绍的是通过 OpenDesign 使用 Claude Code 设计界面,而不是 Claude Code 本身的界面。OpenDesign 的设置说明列出了可用的 Agent。

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

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

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

使用界面:终端 CLI、VS Code / Cursor / JetBrains 扩展、桌面应用、网页端。桌面版本请查看下载页面。源码 quickstart 中的 Node.js 和 pnpm 要求适用于从源码运行,而非安装桌面软件包。最低兼容的 Claude Code 版本:本文未验证。

连接检查成功的标志

按照你所安装版本显示的连接说明操作,然后运行一个小任务。确认 Claude Code 已处理该任务,且产物能够打开。仅下载并不能建立有效连接。

从桌面应用开始

三步完成 Claude Code 设置

先下载,完成你所安装版本的 Claude Code 设置,然后检查一个小结果。按照此路径操作无需从源码构建 OpenDesign。

  1. 1

    下载 OpenDesign 桌面应用

    选择适合您电脑的软件包,安装并打开该应用。

    下载 OpenDesign
    检查点
    桌面应用会打开。已经安装过?请进入下一步;无需再次下载。
  2. 2

    准备你的 Claude Code 连接

    按照你所安装版本中的 Claude Code 说明操作。使用你的 Anthropic API key(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 设置说明;请查看供应商文档以获取当前命令。

    检查点
    确认目标 Agent 与账户。如果不可用,请在尝试更大任务之前先检查兼容性。
  3. 3

    运行一个小型 Claude Code 任务

    使用一个小 brief,以便您评估整个流程,包括一次修改。

    入门 brief

    构建一个设置页面,包含个人资料表单和保存确认提示。使用我的设计规则。在桌面和移动端宽度下进行检查。

    检查点
    打开结果,测试保存状态,并提出一个具体的修改请求。生成的文件是评审的开始,而不是结束。

若要从源代码运行 OpenDesign,请参阅技术快速入门

Claude Code 设计工作流

Claude Code 设计工作流的五个步骤

同一个设置界面任务,从 brief 到通过验证的文件全程记录。每一步都列出你提供的内容、Claude Code 所做的工作、OpenDesign 贡献的部分,以及你需要检查的内容。

  1. 1

    设计 Brief

    用简明语言写三到六行,说明目标受众、该界面要完成的任务,以及适用的平台。

    • 撰写 brief;如有参考截图,请附上。
    • Claude Code读取 brief 和项目的指令文件;遇到含糊之处会提问。
    • OpenDesign提供项目、prompt 界面,以及对应产物类型的 skill。
    • 检查确认 brief 中已写明验收标准。现在补充比生成之后再补充成本更低。
  2. 2

    设计约束

    一套设计系统加几条硬性规则。正是这些将符合品牌调性的产出与千篇一律的效果区分开来。

    • 选择一个设计系统;说明断点及必须使用的组件。
    • Claude Code在写下任何一行之前,将 DESIGN.md 的 token 和风格规则加载到上下文中。
    • 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 的局限性、人工检查与后备方案

  • 适用范围它是一个编程 Agent,而不是设计工具——但设计恰恰是其最突出的涌现能力之一。在正确的 skill 和上下文中的设计系统配合下,它能生成可用于生产的 HTML/CSS/React,基于截图进行迭代,并维护设计 token。本页只涉及作为 OpenDesign 所连接 Agent 的 Claude Code,并不涵盖 Claude Code 的全部功能。
  • 使用限额使用限额和费用取决于你所使用的凭证(Anthropic API key 或 Claude 订阅)。本页不对免费额度作任何说明。
  • 网络本地项目文件并不代表离线推理。在分享敏感输入之前,请检查你的 Agent 供应商设置和数据政策。
  • 输出为 HTML产物是 HTML 文件,而非矢量设计文件。Figma 往返需通过 Claude Code 自身的 Figma 集成完成。
  • 人工审查可访问性、真实内容、品牌契合度和交互正确性均由你在预览中审查。将 Agent 的任何自检视为初步检查。
  • 后备方案如果 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 开始第一个设计任务

从一个小任务开始,评估往返效果,然后再提交真实的 brief。请选择与您的环境相符的选项;本页不会自动检测。

你目前处于设置流程的哪个阶段?
下载 OpenDesign 查看安装清单

OpenDesign 桌面客户端

一套设计系统,让每一次创作都保持品牌一致

在完整的 Vibe Design Workspace 中,用同一套品牌规则生成网页、PPT、可交互原型、数据看板、图像与 HTML 视频。连接本地 Codex、Claude Code、Cursor 等编程助手,即可免费创作。

  • 覆盖网页、PPT、原型、数据看板、图像与视频
  • 140+ 设计系统,以及完整模板与技能库
  • 连接本地 Codex 与 21+ 款编程助手 · 免费使用
免费下载

支持 macOS 与 Windows