macOS · Codex Dream Skin
macOS 安装 Codex Dream Skin 教程
支持 Apple Silicon 与 Intel Mac。无需全局安装 Node.js——引擎在校验签名后使用 Codex 自带的签名版 Node。
开始之前
- 已安装官方 Codex 桌面端并至少启动过一次（较新的 macOS 版本可能显示为 ChatGPT.app；签名 bundle id 仍是 com.openai.codex）
- 一张不含 UI 的 16:9 图片（推荐 2560 × 1440；处理后 ≤ 16 MB、单边 ≤ 16384px、总像素 ≤ 50MP）
安装步骤
01
下载引擎
按下面的命令用 git 克隆；若下载 ZIP，请改为进入 Codex-Dream-Skin-main/macos 目录：
git clone https://github.com/Fei-Away/Codex-Dream-Skin.git
cd Codex-Dream-Skin/macos 02
运行安装器
在 Finder 中双击 “Install Codex Dream Skin.command”。它会把引擎装到 ~/.codex/codex-dream-skin-studio 并在桌面创建启动器。也可以在终端运行：
./scripts/install-dream-skin-macos.sh --no-launch 03
选预设或自己的图片
全新安装会内置 2 个实测预设：「哥特虚空远征」（默认）和「桥本有菜」。用 Customize 导入不含 UI 的图片，构图分析全程留在本机。
~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh 04
启动带皮肤的 Codex
用桌面的 “Codex Dream Skin.command” 启动或重新应用。可选：安装 SwiftBar 菜单栏组件，在顶部 🎨 图标里应用 / 暂停 / 换图。
05
自检（可选）
确认注入已生效并保存截图留证（桌面快捷方式没建出来也能用）：
~/.codex/codex-dream-skin-studio/scripts/verify-dream-skin-macos.sh --reload --screenshot ~/Desktop/dream-skin-verify.png 06
随时还原
双击 “Restore Codex Dream Skin.command”，或直接运行下面的命令。官方安装目录从未被修改，还原干净且即时。
~/.codex/codex-dream-skin-studio/scripts/restore-dream-skin-macos.sh --restore-base-theme --restart-codex视频教程
来自社区的 3 分钟完整换肤实录，由 Justin（@interjc） 在 X 上分享，感谢！
录了一个 Codex 换肤的简单教学视频
— Justin (@interjc) 在 X 上观看 ↗
选图技巧
- 优先使用不含 UI 的 2560 × 1440 图片；左半边保持安静，主体放在右侧。
- 同一张壁纸连续铺在侧栏与内容区下方，原生 UI 始终在它上面。
- 随时可用第 5 步的 Verify 命令自检。
完整文档与源码： Fei-Away/Codex-Dream-Skin ↗ · 直接下载 ZIP
现在就能安装的主题
