codex-skin.dev

Codex Dream Skin macOS 安装教程（分步图文）

原理与安全边界

Codex Dream Skin 通过本地回环 CDP（Chrome DevTools Protocol）为官方 Codex Desktop 应用注入自定义视觉主题。它不会修改官方 .app 包体、app.asar 或代码签名，保持安装安全可逆。

所有原生功能保持完整：侧边栏、建议卡片、项目选择器、编辑器和菜单均完全可交互。仅横幅与背景图层被定制。

前置条件

分步安装

1. 下载 Dream Skin 仓库

打开终端并克隆仓库：

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

2. 执行安装脚本

安装到稳定路径并在桌面创建启动器：

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

该脚本会：

3. 定制你的主题

运行定制脚本（不指定图片时会打开 Finder 选择器）：

~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh

或直接指定图片：

~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh \
  --image "/path/to/your/image.png" \
  --name "我的主题" \
  --accent "#7cff46"

图片建议：

4. 启动皮肤

双击桌面上的 Codex Dream Skin.command，或运行：

~/.codex/codex-dream-skin-studio/scripts/start-dream-skin-macos.sh

脚本会：

验证生效

启动后，检查以下标志：

  1. 自定义横幅：首页顶部显示你选择的图片
  2. 主题背景：任务视图显示你的自定义背景
  3. 原生控件保留：侧边栏、项目选择器、编辑器按钮正常工作

你也可以使用验证脚本：

~/.codex/codex-dream-skin-studio/scripts/verify-dream-skin-macos.sh

恢复官方外观

双击桌面上的 Codex Dream Skin - Restore.command，或运行：

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

这会：

你的配置和对话历史不受影响。

常见问题排查

Codex 无法启动或立即崩溃

启动后主题未显示

官方 Codex 更新后皮肤失效

这是预期行为。Codex 更新可能改变内部渲染器目标。解决方法：

  1. 拉取最新版 Dream Skin 仓库：cd ~/path/to/Codex-Dream-Skin && git pull
  2. 重新运行安装脚本：./macos/scripts/install-dream-skin-macos.sh --no-launch
  3. 再次启动皮肤

如果仍然无效，请回到本画廊查看兼容性状态更新，或等待上游适配。

权限拒绝错误

脚本需要执行权限。如果看到权限错误，运行：

chmod +x ./scripts/*.sh

想切换到其他图片

直接再次运行定制脚本：

~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh

然后在 Finder 选择新图片，或用 --image 参数直接指定。定制后需重启皮肤脚本（双击 Codex Dream Skin.command）使新主题生效。

相关资源：