给 Codex 换件衣服：Dream Skin 从安装到恢复的上手记录

Codex Dream Skin 官方红白主题演示界面

题图来自 Codex Dream Skin 官方仓库：原生侧栏和输入区仍然可交互，背景只负责营造氛围。

第一次看到 Codex Dream Skin 的效果图时，我以为它只是“换张壁纸，再把窗口调透明”这么简单。把仓库里的安装脚本、验证流程和恢复逻辑翻了一遍之后，才发现这个项目最值得讲的反而不是那些花哨皮肤，而是它尽量把换肤做成了一件随时可以反悔的事。

它不会去拆 Codex 的安装包，也不碰 .app、app.asar 或 WindowsApps。主题是在 Codex 启动后，通过只监听本机 127.0.0.1 的 CDP 注入进去的。侧栏还是原来的侧栏，输入框也还是原来的输入框，只是界面上多了一层背景和半透明样式。

这篇文章不准备把 README 从头到尾翻译一遍。我只说第一次安装真正需要知道的东西，以及几个很容易把效果做砸的地方。

本文按仓库提交 a1c48b3a84cc（2026-07-17）核对。这个项目更新很快，如果你看到的脚本名称有变化，以仓库最新说明为准。

先说结论：它适合谁？

如果你只是想把 Codex 从浅色改成深色，直接用官方外观设置更省事。Dream Skin 适合的是另一种需求：你想让一张完整的 16:9 图片铺在窗口下面，又不想把原生按钮和输入区域变成一张不能点的假截图。

它的工作方式大致是这样：Dream Skin 用带调试端口的方式启动官方 Codex，注入 CSS 和装饰层，并留一个小型注入器应对页面切换和刷新。点击 Restore 后，注入器退出，Codex 按普通方式重新启动。

这比直接修改安装包温和得多，但并不等于毫无风险。CDP 对同一用户下运行的本机程序没有额外认证，因此主题开着时，不要顺手运行来历不明的脚本。暂时不用，就恢复官方模式。

先把图片选对，能少折腾一半

Dream Skin 最常见的“翻车”并不是安装失败，而是导入了一张本来就不适合作背景的图。

下面这张图是仓库自带的构图素材。你会发现左边几乎没有重要内容，真正的视觉中心在右侧。这不是偶然：Codex 的侧栏、首页文案和项目选择器通常会占掉左侧和中部，背景如果到处都是人脸、文字和高亮细节，最后只能互相打架。

左侧留白、右侧保留主视觉的背景构图

仓库自带的纯背景示例：左侧留给原生内容，右侧承担视觉重点。来源：Codex Dream Skin。

我会优先选择这类图片：

16:9 横图，2560 × 1440 最省心；
左侧大约一半保持低对比、低细节；
人物、建筑或光源放在右侧，但别贴边；
图片里不要提前画上侧栏、输入框、按钮和标题；
浅色、暗色半透明层盖上去之后，仍能看见中间调细节。

一句话概括：准备“壁纸”，不要准备“Codex 效果截图”。把带界面的宣传图重新导进去，只会得到一层假界面压着一层真界面。

macOS：第一次安装其实只有三步

Mac 这边比较省心，不需要额外安装 Node.js。脚本会先检查官方 Codex 的签名、架构和自带 Node 版本，再决定是否继续。

开始前，先确认官方 Codex Desktop 至少打开过一次，~/.codex/config.toml 已经存在。然后下载仓库 ZIP 并完整解压，或者用 Git：

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

接下来双击 Install Codex Dream Skin.command。如果更习惯终端，也可以运行：

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

安装完成后，桌面会出现启动、定制、验证和恢复入口。先打开 Codex Dream Skin - Customize.command，从 Finder 选一张纯背景，再给主题起个名字。选图脚本会分析焦点和安全区，不需要手写配置。

如果只想看看它能不能跑，仓库内置了几套预设。命令行切换方式是：

~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh \
  --id preset-midnight-aurora

最后别急着欣赏背景，先打开 Codex Dream Skin - Verify.command。我最在意的不是“有没有变漂亮”，而是下面几件事：侧栏能不能点、项目选择器能不能切、输入框是否还能正常聚焦、窗口缩窄后有没有横向滚动条。

不喜欢，或者 Codex 更新后显示异常，直接打开 Codex Dream Skin - Restore.command。终端恢复命令也很直白：

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

Windows：多一个 Node.js，但流程差不多

Windows 版要求从 Microsoft Store 安装的官方 OpenAI.Codex，并且需要 Node.js 22 或更高版本。先在 PowerShell 里确认：

node --version
Get-AppxPackage -Name OpenAI.Codex

安装前要把 Codex 完全退出。进入仓库的 windows 目录，运行：

powershell.exe -NoProfile -ExecutionPolicy Bypass `
  -File .\scripts\install-dream-skin.ps1

安装器不会接管 WindowsApps，也不要求管理员权限。完成后，桌面上会有三个比较重要的入口：

Codex Dream Skin：启动或重新应用主题；
Codex Dream Skin - Tray：在托盘里换背景、保存和切换主题；
Codex Dream Skin - Restore：回到官方外观。

第一次启动后，建议顺手生成一张验证截图：

powershell.exe -NoProfile -ExecutionPolicy Bypass `
  -File .\scripts\verify-dream-skin.ps1 `
  -ScreenshotPath "$env:TEMP\codex-dream-skin.png"

Windows 版导入图片有明确上限：文件不能超过 16 MB，单边不能超过 16384 像素，总像素不能超过 5000 万。普通壁纸基本碰不到上限，但从相机或设计工具导出的超大 PNG 值得留意。

需要恢复时执行：

powershell.exe -NoProfile -ExecutionPolicy Bypass `
  -File .\scripts\restore-dream-skin.ps1 `
  -RestoreBaseTheme -PromptRestart

如果连 Dream Skin 创建的快捷方式也不想保留，再追加 -Uninstall。

我更推荐从抽象背景开始

人物和复杂场景确实吸睛，但第一次调主题，抽象渐变反而最容易成功。下面这张“午夜极光”是项目用程序生成的预设，没有人物、文字和第三方素材；它能很直观地说明什么叫“不抢内容的背景”。

深蓝、青色和紫色组成的午夜极光抽象背景

项目内置的程序生成预设“午夜极光”。来源：Codex Dream Skin。

这类背景有两个好处：窗口比例变化时，裁掉一点边缘也不心疼；任务页降低透明度之后，代码和对话依然容易读。等安装、验证、恢复都跑通了，再换人物或复杂场景，会少很多“到底是脚本有问题，还是图片不合适”的猜测。

几个实际会遇到的问题

主题突然没了。 先确认这次是不是从 Dream Skin 的启动入口打开 Codex。普通方式启动 Codex，不一定会带上需要的 CDP 会话。

Codex 更新后不生效。 退出托盘或菜单栏程序，拉取仓库最新代码，再跑一次安装和启动。两个平台的脚本都会重新发现当前官方应用，不应该继续依赖旧版本路径。

背景有了，但字看不清。 先换低对比背景，不要马上改一堆 CSS。首页可以有氛围，任务页最终还是要看代码和长对话。

Windows 报 Node 找不到。 node --version 如果没有结果，或版本低于 22，升级后要重新打开 PowerShell，让新的 PATH 生效。

端口被占用。 默认启动器会寻找空闲端口。手动指定端口时如果冲突，换一个 1024～65535 之间的端口，不要为了换肤去结束身份不明的监听进程。

最后，先测试恢复，再认真装修

我对这类桌面增强工具的判断标准一直很简单：漂亮只能算加分，能不能干净地回去才是底线。

所以第一次装完，不妨马上做一次 Verify，再做一次 Restore。确认 Codex 能回到官方外观之后，再重新启动 Dream Skin、挑背景、调焦点。这样以后遇到 Codex 更新、主题不兼容或者单纯看腻了，都不会慌。

另外提醒一句：Dream Skin 与模型供应商配置是两回事。它不会替你修改 API Key、Base URL 或模型；任何声称“装主题顺便帮你配置中转”的第三方包，都应该单独审查。

项目入口和更详细的资料放在这里：