STEP-BY-STEP GUIDE
如何给 Codex 换肤
基于 Fei-Away/Codex-Dream-Skin。外部主题、本机注入、不修改官方安装包。
01
MACOS · APPLE SILICON / INTEL
macOS 安装
- 下载仓库。从 GitHub 下载 ZIP 并解压,或使用 Git 克隆。
- 打开 macos 目录。直接双击
Install Codex Dream Skin.command,也可以用下面的终端方式。 - 安装到稳定路径。
cd macos ./scripts/install-dream-skin-macos.sh --no-launch - 切换主题。
~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh \ --id preset-midnight-aurora - 可选菜单栏。双击
Install Menu Bar.command,即可从 🎨 Skin 菜单应用、暂停、导入和切换主题。
02
WINDOWS · POWERSHELL
Windows 安装
- 在仓库根目录打开 PowerShell。保持
windows目录结构完整。 - 运行安装脚本。
powershell -ExecutionPolicy Bypass -File .\windows\scripts\install-dream-skin.ps1 - 启动托盘程序。
powershell -ExecutionPolicy Bypass -File .\windows\scripts\start-dream-skin.ps1 - 选择主题。从系统托盘进入“已保存主题”,选择仓库预置主题;“更换背景图”可以导入自己的纯背景。
03
CUSTOM WALLPAPER
导入自己的背景
2560 × 1440推荐 16:9 母版
左侧 50%–58%保持安静、低对比
右侧 58%–88%放置视觉主体
纯背景不要有 UI、文字、Logo 或水印
macOS 可运行 customize-theme-macos.sh,Windows 可从托盘选择“更换背景图”。图片分析在本机 Canvas 内完成,不会上传到外部服务。
04
VERIFY & RESTORE
验证与恢复
Codex Dream Skin 会验证官方应用签名与架构,通过仅绑定 127.0.0.1 的 CDP 把主题注入预期的 app:// 页面。它不会修改应用二进制、签名、API Key 或 Base URL。
如果显示异常,先运行桌面上的 Codex Dream Skin - Verify.command。要停止换肤并恢复官方外观,运行 Codex Dream Skin - Restore.command。