CodexSkin/安装教程

安装教程

如何安装 Codex 皮肤。

快速答案：在 CodexSkin Studio 制作皮肤，选择 Mac 或 Windows，解压下载文件，然后打开可见安装入口。不需要克隆 Git 仓库，也不需要手动输入终端命令。

引擎模板 1.2.0。查看 SHA-256

制作可安装皮肤阅读步骤

开始之前

Codex 皮肤安装要求

要求macOSWindows
官方 Codex 应用已经安装并至少打开一次已经安装 Microsoft Store 版本
Node.js无需单独安装Node.js 22 或更高版本
安装前关闭 Codex关闭 Codex
安装包由 Studio 使用上游 1.2.0 生成的自定义 ZIP
  • 只使用你拥有或获准使用的图片。
  • 关闭或重新启动 Codex 前保存当前工作。
  • Studio 会显示每个生成 ZIP 的 SHA-256。
  • 需要完整供应链控制时，检查原始 GitHub 源码。
macOS

Apple Silicon 与 Intel Mac

不需要全局安装 Node.js。安装器会校验并使用已签名 Codex 应用自带的 Node 运行时。

  1. 生成 macOS 安装包。打开 CodexSkin Studio，选择或拖入图片，检查预览，选择 macOS，然后下载皮肤。
  2. 解压下载文件。在 Finder 中打开生成的文件夹，其中已经包含处理后的图片和主题设置。
  3. 打开可见安装入口。双击 Install Codex Dream Skin.command。如果 macOS 阻止运行，请按住 Control 点击文件，选择打开并确认。
  4. 完成安装并应用皮肤。引擎会复制到 ~/.codex/codex-dream-skin-studio，选择你的自定义预设，然后启动皮肤会话。
  5. 保留 Restore 入口。需要恢复官方界面时，使用桌面上的 Restore。
检查上游 macOS 源码
Windows

Microsoft Store Codex 应用

Windows 流程需要 Node.js 22 或更高版本。安装器会把完整引擎和你的图片保存在稳定的本机目录。

  1. 生成 Windows 安装包。打开 CodexSkin Studio，选择图片，检查预览，选择 Windows，然后下载皮肤。
  2. 安装 Node.js 22 或更高版本。如果系统中没有 Node.js，ZIP 内包含官方网站链接。
  3. 关闭 Codex 并解压安装包。保存当前工作，关闭 Codex，然后打开生成的文件夹。
  4. 打开可见安装入口。双击 Install Codex Dream Skin.cmd。它会安装图片，把引擎复制到 %LOCALAPPDATA%\CodexDreamSkin\engine，并创建桌面快捷方式。
  5. 启动并检查。使用 Codex Dream Skin 快捷方式，检查首页和普通任务。
检查上游 Windows 源码

确认真实界面仍然可用。

  • 侧栏导航仍然可以点击。
  • 项目选择器可以正常打开。
  • 建议卡片和输入框可以正常交互。
  • 任务正文和 Diff 保持清晰。
  • 背景图片没有遮挡原生控件。

在需要之前先练习 Restore。

使用桌面上的 Codex Dream Skin - Restore 入口。macOS 和 Windows 的恢复流程都会停止保存的皮肤会话，并正常打开 Codex。

安全提示

CDP 在本机运行，但仍然具有高权限。

引擎把 CDP 绑定到 127.0.0.1，且不会修改官方应用包或签名。Chromium CDP 没有同一用户身份验证，因此皮肤运行时不要同时打开来源不明的本机程序。

阅读完整 Codex 皮肤安全指南

非官方项目CodexSkin 是独立无代码工具。Codex 和 OpenAI 商标归各自权利人所有。

Codex 皮肤安装常见问题

Codex 皮肤安装安全吗？

上游项目不会修改官方应用包或代码签名，并把 CDP 绑定到 127.0.0.1。CDP 仍然具有高权限，因此请检查源码，只使用原始仓库，并在皮肤运行时避免打开来源不明的本机程序。

如何在 Mac 安装自定义 Codex 皮肤？

在 CodexSkin Studio 制作皮肤，解压 macOS 安装包，然后打开 Install Codex Dream Skin.command。它会安装图片和引擎，应用皮肤，并创建启动与恢复入口。

如何在 Windows 安装自定义 Codex 皮肤？

在 CodexSkin Studio 制作皮肤，安装 Node.js 22 或更高版本，关闭 Codex，解压 Windows 安装包，然后双击 Install Codex Dream Skin.cmd。

Codex 皮肤会修改 app.asar 吗？

不会。文档中的 macOS 和 Windows 流程不会修改 app.asar、官方应用包、WindowsApps 文件或官方代码签名。

如何卸载皮肤或恢复官方界面？

在 macOS 或 Windows 使用 Codex Dream Skin - Restore 入口。恢复流程会停止保存的 CDP 会话，并正常打开 Codex。

主要来源

CodexSkin 打包开源 Dream Skin 引擎

CodexSkin Studio 提供无代码预览和本地打包流程，底层皮肤引擎来自固定版本的开源仓库。