每天长时间使用 Codex Desktop，默认界面虽然简洁，但很难体现个人工作习惯和视觉偏好。

这篇文章介绍一个开源项目 Codex Dream Skin：通过本机 CDP 为 Codex Desktop 加载主题，让首页横幅、任务页背景和内容层拥有自己的视觉风格，同时保留侧栏、建议卡、项目选择器、菜单和输入框等原生交互。

项目地址：https://github.com/YYssong/Codex-Dream-Skin

这是非官方外部主题工具，不隶属于 OpenAI。项目不会修改官方 .app、app.asar、WindowsApps 或代码签名。

一、它和普通“截图皮肤”有什么区别

Dream Skin 不是把一张完整界面截图盖在软件上。

主题运行后：

• 侧栏仍然可以切换任务；
• 建议卡和项目选择器仍然可以点击；
• 输入框仍然可以正常输入；
• 页面路由变化后会重新应用主题；
• 不喜欢当前效果时可以暂停或完整恢复。

它的核心思路是：让 Codex 以仅监听本机回环地址的 CDP 调试端口启动，再由本地注入器向预期的 Codex 页面加载主题。官方安装包本身不会被改写。

二、开始前必须准备什么

无论使用 Mac 还是 Windows，都要先完成两件事：

1. 安装官方 Codex Desktop；
2. 至少正常启动一次，让 Codex 创建配置文件。

对应配置文件位置：

• macOS：~/.codex/config.toml
• Windows：%USERPROFILE%\.codex\config.toml

本文在准备环节参考了 CODELINK 教程中心整理的 Codex 安装与配置说明。需要说明的是，相关教程、API 服务和 Dream Skin 换肤工具相互独立；使用主题不要求更换模型供应商，Dream Skin 也不会自动修改 API Key 或 Base URL。

三、macOS 安装方法

Mac 版本支持 Apple Silicon 和 Intel Mac，并提供一键选图定制。

下载项目并解压后，进入 macos 目录，双击：

Install Codex Dream Skin.command

也可以在终端中安装：

cd Codex-Dream-Skin/macos
./scripts/install-dream-skin-macos.sh

安装器会查找并校验官方 Codex、备份主题相关配置、安装主题引擎，并创建桌面入口。

安装完成后，桌面会出现四个常用入口：

• Codex Dream Skin.command：启动或重新应用主题；
• Codex Dream Skin - Customize.command：选择自己的图片并生成主题；
• Codex Dream Skin - Verify.command：验证实时界面并生成截图；
• Codex Dream Skin - Restore.command：恢复安装前的官方外观。

如果 macOS 首次阻止打开 .command 文件，请在 Finder 中右键文件并选择“打开”。不要关闭系统安全功能，也不要执行来源不明的解除隔离命令。

换成自己的图片

双击：

Codex Dream Skin - Customize.command

然后在 Finder 中选图并输入主题名称。

建议使用：

• 宽度 2000 像素以上的横图；
• PNG、JPEG、HEIC、TIFF 或 WebP；
• 原图不超过 50 MB；
• 左侧相对简洁，避免首页文字难以阅读；
• 不包含假按钮、假输入框或完整软件界面的图片。

需要精确设置颜色和主题文字时，可以运行：

~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh \
  --image "/图片的绝对路径/theme.png" \
  --name "我的 Codex 主题" \
  --tagline "把喜欢的画面变成工作台" \
  --accent "#7cff46" \
  --secondary "#36d7e8" \
  --highlight "#642a8c"

四、Windows 安装方法

Windows 版本面向 Microsoft Store 安装的官方 Codex。目前支持安装、启动、验证、截图和恢复，但还没有 Mac 版本同等的一键选图入口。

开始前先确认 PowerShell 可以运行 Node.js：

node --version

进入项目的 Windows 目录：

cd "C:\你的路径\Codex-Dream-Skin\windows"

如果当前 PowerShell 会话禁止运行本地脚本，可以只为当前会话临时放行：

Set-ExecutionPolicy -Scope Process Bypass

关闭 PowerShell 后，该设置会自动失效，不需要修改全系统执行策略。

安装主题：

.\scripts\install-dream-skin.ps1

建议先正常退出已经打开的 Codex，再启动主题：

.\scripts\start-dream-skin.ps1

Windows 默认使用本机端口 9335。启动器会动态查找最新的 OpenAI.Codex Store 包，不会写死某个 WindowsApps 版本目录。

五、不要只看背景图，要验证真实交互

主题显示出来不代表已经验收完成。至少需要检查：

1. 首页横幅、侧栏和内容区域没有横向溢出；
2. 建议卡能够点击；
3. 项目选择器能够打开；
4. 输入框可以输入并清空文字；
5. 打开一个任务后可以返回 New Task；
6. 缩窄窗口后核心控件没有被遮挡。

macOS 可以双击桌面的验证入口，也可以运行：

~/.codex/codex-dream-skin-studio/scripts/verify-dream-skin-macos.sh \
  --reload \
  --screenshot "$HOME/Desktop/Codex Dream Skin Verification.png"

Windows 验证命令：

.\scripts\verify-dream-skin.ps1 `
  -ScreenshotPath "$env:USERPROFILE\Desktop\Codex-Dream-Skin-Verification.png"

六、如何恢复官方外观

macOS 可以直接双击：

Codex Dream Skin - Restore.command

命令行完整恢复：

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

Windows 恢复基础主题配置：

.\scripts\restore-dream-skin.ps1 -RestoreBaseTheme

同时删除项目创建的快捷方式：

.\scripts\restore-dream-skin.ps1 -RestoreBaseTheme -Uninstall

恢复操作不会删除官方 Codex，也不会删除已有任务。

七、安全边界

使用这类外部主题工具时，应明确它的安全边界：

• CDP 只应绑定 127.0.0.1，不要暴露到局域网或公网；
• 主题运行期间不要执行来源不明的本机程序；
• 不要上传 .codex/auth.json、API Key 或包含隐私的截图；
• 公开使用人物、角色或品牌图片前，应确认授权；
• 主题图片不能代替真实控件，装饰层不能拦截点击。

总结

Codex Dream Skin 更适合把 Codex Desktop 做成个人化工作台，而不是做一层只能看的截图覆盖。它保留了原生交互，也提供验证与恢复路径。

完整源码和中文教程：

https://github.com/YYssong/Codex-Dream-Skin

建议第一次安装前保存当前任务，完成后依次验证侧栏、项目选择器、建议卡和输入框；确认真实交互正常，再开始日常使用。