首页 > 教程资讯 > 教程详情

Onlook 的开源桌面工具:画布上跑真实应用,接入自己的 Claude Code 或 Codex

AI 与前沿 极客小林 2026-11-21
文章分享

据 Onlook 在 GitHub 仓库 README 中的说明,Onlook 是面向设计师的开源开发工具,可在画布上制作网站、原型和设计,并定位为 Figma、V0、Replit Agent、Base 44、Webflow 等产品的开源替代。发布方写明不自带模型:用户连接自己的 Claude Code 或 ChatGPT/Codex 账号,由该 agent 修改仓库里的真实文件。桌面应用在本机运行,代码留在用户电脑上。

在真实仓库上设计

README 称,Onlook 可打开本机任意 Git 仓库(也可导入),并像在终端里一样启动用户自己的开发服务器。正在运行的应用会出现在无限画布的多个框里,手机、平板和桌面尺寸可以并排查看,方便对照页面、尺寸和方案。因为用的是项目自有工具链,它适用于开发服务器已经支持的各种 Web 框架或语言。多个项目可以以标签页并行打开。

发布方描述的流程是:指向本机上的 Git 仓库或导入一个,代码仍留在原处;Onlook 在本地启动开发服务器;应用以框的形式出现在画布上;用户在对话里描述想要的改动,请求会交给已连接的 Claude Code 或 ChatGPT/Codex 账号,由该 agent 编辑仓库中的真实文件;开发服务器重新加载后,改动出现在画布上,Git 记录全部变更。README 称它使用安全的 worktree 副本,用户的文件夹不会被改动。

同一节还列出:可以导入 GitHub 仓库,也可以从零开始新建代码库,并支持一键发起 pull request(从检查到合并)。示例流程中,在项目页左上角点击 New Draft,即可开始一个空项目;在屏幕右下角输入框写下想设计的内容,回答 agent 的澄清问题并等待它构建。

用自己的 agent 改画布上的元素

README 把「自带 agent」写成产品的一部分:不提供自有模型,用户接入已有的 Claude Code 或 ChatGPT/Codex 方案。还可通过 MCP 连接器接入更多工具,并把所需上下文带进创作流程;可以同时处理跨仓库、跨页面的多项设计任务。

在画布上可以询问任意元素。agent 可以为用户排布画布,包括变体、状态和流程,也可以引用画布上的参考图。点选单个框,可把它作为后续提示的上下文;双击某个元素,则使用行内对话,引导 AI 编辑该元素。仓库之外,还可以用 Artifact 做快速 HTML 草图。

导出、系统支持与技术栈

成果可导出为独立的 HTML、PNG、JPEG 或 PDF,用于交接、评审或发布。示例里,选中要分享的框,让 agent 转成 Artifact,再用框右上角的导出按钮导出为 HTML/CSS 或 PNG,然后粘贴到 Slack、邮件或其他通讯工具。技术栈表写明:PNG 与 JPEG 使用 Electron 的 capturePage,PDF 使用 Electron 的 printToPDF 以及 pdf-lib。

桌面应用目前支持 macOS(Apple Silicon 与 Intel x64),安装页提供下载。Windows 版标明 Coming soon,开放候补名单,有更新时会发邮件。Linux 暂无发布的安装包,开发方仍在评估需求,同样提供候补名单。从源码构建的说明覆盖在 Mac 上构建和运行;README 称这一路径不需要 Onlook 账号、云端密钥或 .env 文件。

桌面层使用 Electron、React 19、设计系统 Astryx、React Flow、Zustand 和 CodeMirror。项目侧用 Git 直接操作仓库,用 node-pty 运行开发服务器和 shell。工具链还包括 Bun 与 Turborepo。

许可、使用统计与先前版本

源码采用 Apache 2.0 许可。README 说明,许可覆盖源代码,不包括仓库中的全部素材:图标来自 Iconists 的 Central Icons,授权给 Onlook 用于其自身产品,该授权不延伸到 fork;品牌标识、DMG 美术和音效也不在许可范围内。分叉时需替换的内容见仓库中的 ASSETS.md。

官方下载版默认开启使用情况统计,用于改进应用;从源码构建时会先询问。可在 Settings 中关闭,或设置 STUDIO_TELEMETRY=0 后运行或构建。细节见其隐私政策。

仓库页面另给出先前版本的位置:浏览器版 Onlook v1 在本仓库的 v1 分支;最初的 Electron 桌面版在 onlook-dev/desktop。

来源