安装 Codex Design。

01 / 安装之前

你需要支持插件的 Codex、Codex CLI、Git，以及 MCP 进程 PATH 里的 Node.js 22.12 或更高版本。安装前先检查一下：

codex plugin --help
git --version
node --version

默认安装包面向 macOS 和 Linux。安装包里也带了 PowerShell 启动器和 .mcp.windows.json，供原生 Windows 使用，但 Windows 还没有经过完整验证。做针对平台的修改之前，请先说明这一限制。

02 / 给 agent 的安装说明

插件通过 main 分支上公开的 ummydev/codexdesign Git marketplace 发布，不需要 GitHub 账号，也不需要私有仓库权限。

从这个远程仓库的 Git marketplace 安装，按顺序运行下面的命令：

codex plugin marketplace add ummydev/codexdesign --ref main
codex plugin add codexdesign@codexdesign-github
codex plugin list

公开仓库是 ummydev/codexdesign，插件标识是 codexdesign，marketplace 名称是 codexdesign-github。发布版本位于 main 分支的 plugins/codexdesign/。

如果 marketplace 已经存在，先查看 codex plugin marketplace list，确认仓库和分支一致，然后运行：

codex plugin marketplace upgrade codexdesign-github
codex plugin add codexdesign@codexdesign-github
codex plugin list

如果之前从 ummydev/codexcanvas 安装过早期私有预览版，请按 纯文本指南 里的说明迁移 marketplace。确认插件已安装并启用，如果能查到版本号就一并报告。任何必要的命令失败时，报告命令和报错，不要说安装成功。

• 使用远程 Git marketplace，不要用本地开发目录或个人 marketplace。
• 不要在工作区、marketplace 快照或插件缓存里运行 npm install、npm ci 或任何构建命令。
• 不要手动安装 React Flow 或其他依赖。插件自带预先构建好的 MCP 服务和前端。
• 不要为了绕过报错而克隆到个人 marketplace，或从源码构建。
• 如果缺少某个前置条件，说明缺的是什么，不要悄悄安装另一个运行环境。
• 保留用户的画布项目和设置。

03 / 重启，然后开始创作

安装完成后，完全退出并重启 Codex。新开一个对话，让插件的技能和工具加载进来，然后试试：

用 Codex Design 为登录页探索三个设计方向，
并打开画布。

给 agent：提醒用户重启。不要假定当前对话已经有新工具。只有在用户明确要求、并且宿主支持时，才另建任务。

保持工作台为最新版本

画布后台进程独立于 Codex 运行。更新之前，如果旧版 Codex Design 后台进程还在运行，找到已安装的插件，在它的目录里运行 node scripts/start.cjs stop。然后用上面的命令刷新 marketplace 并重新安装，再重启 Codex、新开一个对话。

不需要额外的 API key，作品始终属于你。

插件没有单独的额度。Codex 的使用权限、套餐限制和相应的用量费用照常适用，这不是无限免费的模型用量。

画布项目和素材保存在本地，默认位置是 ~/.codex-design-plugin/projects。这不会改变 Codex 处理你提供的上下文或文件的方式。更新插件不需要删除项目数据。