Codex Dream Skin macOS 安装教程：从下载到成功启动

正文

macOS 版 Codex Dream Skin 适合想给 Codex Desktop 加图片背景、半透明层和预设主题的用户。它通过本机回环 CDP 注入渲染层，不修改官方 .app、app.asar 或代码签名。你仍然使用官方 Codex，工具只负责启动和加载主题。

这是一款非 OpenAI 官方产品。安装前请先记住 Restore 启动器的位置，并保存正在进行的任务。

项目需要读取 ~/.codex/config.toml。请先正常打开官方 Codex Desktop 一次，再完全退出。没有这个文件时，安装器会提示你先启动 Codex。

macOS 版本支持 Apple Silicon 和 Intel。项目会优先使用 Codex 自带、经过校验的 Node.js，不要求全局安装 Node.js。

下载 ZIP 也可以，但要进入完整的 macos 目录。不要只拿 CSS 或图片，注入器、验证器和恢复脚本缺一不可。

git clone https://github.com/Fei-Away/Codex-Dream-Skin.git
cd Codex-Dream-Skin/macos

可先运行测试：

然后安装：

安装后的引擎位于 ~/.codex/codex-dream-skin-studio，状态、日志和个人图片位于 ~/Library/Application Support/CodexDreamSkinStudio。桌面上会创建启动、Customize、Verify 和 Restore 四个启动器。

如果希望安装后直接启动，可以去掉 --no-launch。安装器不会覆盖一个不是项目创建的同名桌面文件。

./tests/run-tests.sh

./scripts/install-dream-skin-macos.sh --no-launch

安装后可以切换精选预设：

也可以选择较克制的 preset-midnight-aurora。预设背景是纯壁纸，不包含侧栏、按钮、输入框或文字。README 里的实机截图只作预览，不能导入为背景。

~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh --id preset-romantic-rose

双击 Codex Dream Skin.command，或运行：

然后双击 Codex Dream Skin - Verify.command。检查首页背景是否连续、侧栏和输入框是否可点击，再打开普通任务确认代码和消息没有被背景遮挡。

~/.codex/codex-dream-skin-studio/scripts/start-dream-skin-macos.sh --port 9341 --prompt-restart

双击 Codex Dream Skin - Customize.command 可以导入自己的纯背景。推荐 2560 × 1440、16:9 图片，左侧保持低对比，主体放在右侧。图片不能内置窗口、文字、Logo、水印或 Codex 控件。

想在菜单栏切换主题、暂停和恢复，可以运行：

这是可选功能，需要 SwiftBar，不影响桌面启动器和命令行使用。

./Install\ Menu\ Bar.command

Restore 会停止注入器、移除页面主题层、删除运行状态，并按选项重新打开官方 Codex。若无法验证保存的 CDP 端点，脚本会安全停止而不是强行杀掉未知进程。

~/.codex/codex-dream-skin-studio/scripts/restore-dream-skin-macos.sh --restore-base-theme --restart-codex

CDP 监听在 127.0.0.1，不会直接接受局域网连接，但没有同一用户级别的额外认证。只运行可信本机软件，完成体验后使用 Restore 关闭调试会话。不要从网盘下载打包脚本，也不要直接运行未检查的 curl | sh。

这篇教程适合直接照做吗？

可以作为操作参考，但执行命令前应先确认来源、平台路径、当前 Codex 版本和恢复方式。

如果换肤后界面异常，先做什么？

先停止当前自定义会话并运行 Restore，不要继续叠加新主题或手工删除配置。