快速开始

三步让 Open CoDesign 在你的电脑上跑起来。

1. 安装

用包管理器（推荐）

# macOS
brew install --cask opencoworkai/tap/open-codesign

# Windows — Scoop
scoop bucket add opencoworkai https://github.com/OpenCoworkAI/scoop-bucket
scoop install open-codesign

# Windows — winget（等 microsoft/winget-pkgs#363055 合并）
winget install OpenCoworkAI.OpenCoDesign

或者直接下载

从 GitHub Releases 挑对应平台：

平台	文件
macOS（Apple Silicon）	open-codesign-*-arm64.dmg
macOS（Intel）	open-codesign-*-x64.dmg
Windows（x64）	open-codesign-*-x64-setup.exe
Windows（ARM64）	open-codesign-*-arm64-setup.exe
Linux	open-codesign-*-x64.AppImage

v0.1 说明

v0.1 安装包未签名。macOS Sequoia 15+：右键 → 打开 已绕不过 Gatekeeper，装完跑一次 xattr -cr "/Applications/Open CoDesign.app"（0.1.2 及之前路径是 /Applications/open-codesign.app）。Windows：SmartScreen → 更多信息 → 仍要运行。希望已验证的构建？从源码自行编译，参见架构。

2. 添加 provider

首次启动会打开设置页面，三种入口二选一：

• 从 Claude Code 或 Codex 导入 — 一键导入，我们直接读 ~/.codex/config.toml 和 ~/.claude/settings.json，把 provider、model、API Key 一次带过来。
• 手动添加 — 粘贴任意 API Key，provider 根据前缀自动识别（sk-ant-… → Anthropic，sk-… → OpenAI，等等）。
• Keyless — IP 白名单代理（企业网关、本地 Ollama），Key 留空即可。

开箱支持：Anthropic Claude、OpenAI GPT、Google Gemini、DeepSeek、OpenRouter、SiliconFlow、本地 Ollama，以及任何 OpenAI 兼容端点。凭证通过 Electron safeStorage 加密存储于 ~/.config/open-codesign/config.toml，不会上传。

3. 输入第一条提示

从 Hub 选一个内置 demo，或者自由描述。第一版几秒内就会出现在沙箱 iframe 里——HTML 或实时 React 组件，取决于提示内容。

接下来试试

• 行内评论 — 在预览中点击任意元素，留下评论。模型只重写该区域。
• 可调滑块 — 模型主动给出值得调的参数（颜色、间距、字体），拖动即可微调，无需重发提示。
• 切换设计 — 最近 5 个设计的预览 iframe 常驻内存，切换零延迟。
• 导出 — HTML、PDF（本机 Chrome）、PPTX、ZIP、Markdown，全部本地生成。

从源码构建

git clone https://github.com/OpenCoworkAI/open-codesign.git
cd open-codesign
pnpm install
pnpm dev

需要 Node 22 LTS 与 pnpm 9.15+。仓库结构参见架构。

继续阅读

• 架构 — 包如何组合。
• 路线图 — 按版本规划。
• GitHub Issues — 报 bug 或提需求。