Fei-Away/Codex-Dream-Skin · 上手攻略

  • 仓库：Fei-Away/Codex-Dream-Skin
  • 链接：https://github.com/Fei-Away/Codex-Dream-Skin
  • 分类：桌面美化 · Codex 主题定制
  • 作者：Tom
  • 更新：2026-07-17

是什么

Codex Dream Skin 是一个非官方的 Codex 桌面端主题美化工具。它通过本机 CDP（Chromium DevTools Protocol）循环注入方式，在不修改官方 .app / app.asar / WindowsApps 任何文件的前提下，为 Codex 换上自定义图片主题——包括 Banner 图片、低噪点背景、磨砂内容层，同时保留侧栏、建议卡、项目选择器、输入框等所有原生控件的完全可交互性。

本质上是：一张图 → 一套 Codex 主题。

最新内置主题包括：粉系定制、财神打工版、红白科幻、清透定制、灵感小宇宙、紫夜限定、初音未来、舞台黑金等，并支持用户自行替换图片。

解决什么问题

  1. 官方 Codex 只支持有限配色：Codex 桌面端的官方外观设置无法自定义背景图和氛围感。
  2. 不想折腾修改官方二进制：传统"换肤"需要拆包改 app.asar，有更新失效和签名被破坏的风险。
  3. 想要有氛围感的工作环境：一张喜欢的图作为背景，可以改善长时间编码时的心情和专注度。
  4. 主题与 API 配置解耦：换皮肤不会影响你使用第三方 API 中转（如 Passion8），两者完全独立。

快速安装

macOS（Apple Silicon / Intel）

前置条件： - macOS 系统 - 官方 Codex Desktop 已安装并至少启动过一次（~/.codex/config.toml 已存在）

步骤 1：运行安装脚本

# 克隆仓库（如果还没有）
git clone https://github.com/Fei-Away/Codex-Dream-Skin.git
cd Codex-Dream-Skin/macos

# 安装到稳定路径并创建桌面快捷方式
./scripts/install-dream-skin-macos.sh --no-launch

步骤 2：自定义主题图片（可选）

~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh \
 --image "/path/to/your-image.png" \
 --name "My Theme" \
 --accent "#7cff46" \
 --secondary "#36d7e8" \
 --highlight "#642a8c"
  • 支持格式：PNG / JPEG / HEIC / TIFF / WebP
  • 建议宽度 ≥ 2000 px；宽图效果最佳
  • 图片大小 ≤ 50 MB，prepared 后 ≤ 16 MB

步骤 3：启动主题

安装后，桌面会出现四个 .command 文件（双击即可）：

文件 作用
Codex Dream Skin.command 应用主题并启动 Codex
Codex Dream Skin - Customize.command 重新选择图片自定义主题
Codex Dream Skin - Verify.command 验证主题应用是否正确
Codex Dream Skin - Restore.command 一键还原官方外观

可选：菜单栏插件（SwiftBar）

./Install\ Menu\ Bar.command
# 右上角菜单栏出现 🎨 Skin 图标，可快捷切换/暂停主题

重置为内置演示主题：

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

Windows

前置条件： - Windows 系统 - 官方 Codex Desktop（Store 版）已安装 - 安装 Node.js 22+

步骤 1：安装

# 关闭 Codex Desktop
git clone https://github.com/Fei-Away/Codex-Dream-Skin.git
cd Codex-Dream-Skin/windows
.\scripts\install-dream-skin.ps1

步骤 2：启动

.\scripts\start-dream-skin.ps1
# 如果 Codex 已在运行，加 -RestartExisting 参数
.\scripts\start-dream-skin.ps1 -RestartExisting

步骤 3：验证

.\scripts\verify-dream-skin.ps1 -ScreenshotPath "C:\temp\verify.png"

步骤 4：还原

.\scripts\restore-dream-skin.ps1
# 完整卸载（删除快捷方式）
.\scripts\restore-dream-skin.ps1 -Uninstall

核心用法

切换不同主题图片

macOS 用户直接在 Finder 中运行 Customize.command 或用命令行指定图片。Windows 用户重新运行 install-dream-skin.ps1 后再 start-dream-skin.ps1。

验证主题完整性

每次应用主题后建议运行 Verify 脚本。macOS：

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

Windows PowerShell：

.\scripts\verify-dream-skin.ps1 -ScreenshotPath "path\to\screenshot.png"

检查点包括：Banner 是否正确显示、侧栏是否保留原生交互、建议卡是否可点击、注入标记是否存在。

回归官方主题

# macOS
~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh --restore-official
# 或直接双击桌面 "Restore.command"

# Windows
.\scripts\restore-dream-skin.ps1

典型适用场景

  • 个性化 Codex 工作环境：将喜欢的图片设为 Codex 背景，提升长时间使用的愉悦感。
  • 品牌定制：团队或企业可将 Logo 图设为 Codex Banner，用于内部品牌展示。
  • AI 绘画用户：将自己的 AI 生成图设为 Codex 背景，实现工具氛围统一。
  • 节日/活动主题切换：根据不同节日换上不同主题图片（如初音未来、紫夜限定等内置主题）。

坑与注意

  1. CDP 安全风险：CDP 在本机回环（127.0.0.1）上无同用户认证。主题运行期间，只跑可信的本机程序；用完后立刻 Restore 关闭注入 session。
  2. Codex 更新后需重装：每次 Codex 桌面端更新，注入路径可能变化。需重新运行安装脚本。脚本会自动发现当前安装的包（Windows）或验证签名（macOS），无需手动指定路径。
  3. 图片有要求：宽图效果最佳，建议 ≥ 2000 px 宽度；图片仅影响 Banner 和背景区域，不会覆盖原生控件。
  4. macOS 不需要全局 Node.js：macOS 版使用 Codex 自带的经过签名验证的捆绑 Node.js，减少依赖。
  5. Windows 版要求 Node.js 22+：如果 node --version < 22，先升级 Node.js。
  6. Windows 默认端口 9335：如果该端口被占用，脚本会自动扫描空闲端口；如果显式请求占用端口则失败关闭。
  7. 非 OpenAI 官方产品：项目已声明与 OpenAI 无关联，Codex 商标归其权利人所有。
  8. 效果图中的 IP 形象：内置主题效果图中的角色形象（如初音未来）仅作主题示意，商用或公开再分发请自行确认肖像权与商标授权。

与同类对比

工具 修改官方二进制 保留原生控件 支持平台 复杂度
Codex Dream Skin ❌ 不修改 ✅ 完全保留 macOS + Windows 低（一键安装）
手动修改 app.asar ✅ 会修改 ⚠️ 易破坏 仅 macOS 高
第三方 Codex 主题包（社区） ⚠️ 部分修改 不确定 有限 中

Codex Dream Skin 的核心价值在于安全可逆——一键安装、一键还原，不破坏官方二进制，不影响 Codex 更新，也不影响 API/Key 配置。

一句话推荐结论

如果你每天长时间使用 Codex 桌面端，想要一点氛围感但不想折腾改包，Codex Dream Skin 是目前最安全、最可逆的选择——一张图、一键换肤、不留痕迹。