安装与第一次使用

从正确的客户端安装包开始，找到首页、设置和项目，完成第一次可继续修改的创作。

安装客户端

从 OpenDesign 官网下载适合系统的安装包。macOS 按芯片选择 Apple Silicon 或 Intel；Windows 使用下载页提供的对应版本；其他平台先核对官网当前支持范围。安装后启动客户端。

完成一次通用设置

从首页侧栏打开 Settings（设置）→ Models & providers（模型与服务商）。你可以接入已经在用的 AI 服务，也可以直接使用 OpenDesign Cloud，按自己的情况选择：

已经在用 AI Agent，或有兼容的订阅：Agent 是能执行任务的 AI 工具，例如帮你编写和修改代码。可以尝试接入 Claude Code、Codex 等本机 Agent。CLI 是“命令行工具”，也就是安装在电脑上运行的工具；OpenDesign 可以调用受支持的 Agent 来完成你的需求。通常需要先登录该 Agent，能否使用已有订阅取决于工具和服务商的支持情况。
已经有模型服务商的 API Key：选择 BYOK（Bring Your Own Key，意思是“自带密钥”），把服务商提供的 Key 填入 OpenDesign，就能调用其模型；费用由该服务商收取。注意，聊天网站的会员不一定包含 API 调用权限。
暂时没有上述服务：可以选择 OpenDesign Cloud，登录后订阅 OpenDesign 付费计划，使用该计划包含的托管模型，无需再向其他服务商申请 API Key。查看付费计划。

使用自己的本机 Agent 或 BYOK，不需要登录 OpenDesign，但接入的服务可能需要单独登录或付费。Free 不提供周期性的 Cloud 模型额度，仍可接入本机 Agent 和 BYOK。具体设置步骤见选择 AI 接入方式。

认识首页

Home：选择创作类型，写需求，或先看内置示例。
All projects：重新打开已有项目，而不是每次从头生成。
Design systems：管理可复用的视觉规范。
Plugins：查找扩展工作流。
Settings：配置模型、媒体服务、MCP、语言与其他偏好。

先做一个小任务

选择 Prototype 或 Motion design，再说明用途、内容、风格和输出要求。只想讨论时写明“先出方案，不开始制作”；需要产物时要求在当前项目完成文件。选择原型或Motion继续。

创作分类只是起点，不会限制最终产物。没有合适分类时也可以直接写需求，例如简单网页小游戏；需要重新设计现有 App 时，把截图粘贴或拖进对话，并说明希望保留和改变的内容。

把参考资料交给 AI

输入需求时，使用 Add context 中的 Attach files 附上需求文档、参考界面或素材。已有可复用的视觉体系时，从 Design system 选择，并写明需要保持一致的颜色、字体和组件。Working directory 让代理读取选中的本地文件夹，不等于自动把里面所有文件导入 Design Files。

附上资料后仍需说明它的用途，例如“沿用这份规范的字体和按钮，重新设计任务列表”。首次任务先收敛到一个可检查的结果，再在同一项目中继续修改。

确认版本和界面语言

在 Settings → About 查看版本，用 Check again 检查更新；更新就绪时按照提示安装并重启。本文保留部分 0.25.0 设置截图，画布与反馈指南使用 0.26.0。按钮和可用能力以实际版本及图注为准；模型 ID 则以服务商当前文档为准。

网页使用、平台与历史版本

常规使用方式是官网提供的桌面端；需要在浏览器运行创作环境时，可参考仓库 README 自行用 Docker 部署。Cloud 网页控制台用于账户/API/用量管理，与完整创作环境不同。

桌面平台支持以官网下载当前说明为准；社群支持说明目前不承诺正式 Linux 桌面支持，不要把自部署等同于官方 Linux 客户端支持。历史安装包见 GitHub Releases。

查找项目、模板与通知

在 All projects 找回已有作品；侧边栏 Search（支持时可用 Cmd/Ctrl+K）用于查找客户端中的资源，与帮助中心的搜索不同。
在 Community 浏览案例和模板。原型教程以 OpenDesign Landing 说明 Use 与 Remix 的区别。
账户区域的 Message center 用于查看通知。未读提示不代表生成仍在运行；任务进度以项目对话为准。