正文

如果你使用 Windows 版 Codex Desktop,又想加入图片背景、透明层和预设主题,Codex Dream Skin 是一个可尝试的第三方方案。它通过本机 CDP 注入渲染层,侧栏、项目选择器、建议卡和输入框仍然是 Codex 原生控件。

先说明边界:Dream Skin 不是 OpenAI 官方产品,也不是破解工具。它不会修改 WindowsApps、app.asar、官方二进制或代码签名。安装前请保存任务,并记住 Restore 的位置。

确认 Codex 来源

Windows 版本应来自官方 Microsoft Store 包。项目会检查 OpenAI.Codex 的包身份,避免把调试端口误连到其他程序。不要把来历不明的绿色版、破解包或别人打包的启动器混在一起。

安装 Node.js 22 或更高版本

Windows 版当前要求 Node.js 22+。从 Node.js 官网安装 LTS 后,打开新的 PowerShell:

输出 v22.x.x 或更高版本即可。若提示找不到命令,重新打开终端,或检查 Node.js 是否加入 PATH。

node --version

关闭 Codex

安装脚本会备份外观配置,要求 Codex 完全退出。请先保存或发送任务,再从系统托盘退出 Codex,而不是只关闭窗口。

下载完整项目

没有 Git 时,也可以从 GitHub 下载 ZIP 并解压。不要只复制 CSS 或背景图,因为安装、注入、验证和恢复脚本必须配套使用。

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

运行安装脚本

脚本会检查 Node.js 和 Store 包,初始化 %LOCALAPPDATA%\CodexDreamSkin,备份外观配置,并创建桌面和开始菜单快捷方式。若不想创建快捷方式,可加 -NoShortcuts。

脚本不会自动替你关闭正在运行的 Codex。看到提示后退出客户端,再重新执行安装。

powershell -ExecutionPolicy Bypass -File .\windows\scripts\install-dream-skin.ps1

启动主题

默认首选端口是 9335。端口被占用时,未显式指定端口会自动寻找空闲端口;手动指定的端口被其他程序占用则会安全失败。Codex 已经打开但没有调试端口时,脚本会要求你先退出,或明确使用 -RestartExisting。

powershell -ExecutionPolicy Bypass -File .\windows\scripts\start-dream-skin.ps1

验证安装结果

成功标准不是“窗口打开”,而是首页有连续背景,侧栏、项目选择器和输入框仍可交互。再打开一个普通任务,确认代码、消息和输入区域清晰可读。日志在 %LOCALAPPDATA%\CodexDreamSkin。

powershell -ExecutionPolicy Bypass -File .\windows\scripts\verify-dream-skin.ps1 -ScreenshotPath "$PWD\dream-skin-check.png"

常用恢复操作

不需要主题时运行:

需要恢复安装前的官方外观设置时加 -RestoreBaseTheme;需要把配置精确恢复为备份字节时使用 -RecoverConfigBackup。确认不再使用后,才考虑加 -Uninstall 删除快捷方式。

powershell -ExecutionPolicy Bypass -File .\windows\scripts\restore-dream-skin.ps1

安全提醒

CDP 只绑定 127.0.0.1,不会直接暴露给局域网,但同一用户运行的其他本机程序可能访问调试端口。换肤期间只运行可信软件,不要做端口映射。完成体验后用 Restore 关闭调试会话。

Codex 更新后不要修改 WindowsApps。重新运行 install 和 start,脚本会动态发现当前 Store 包。遇到身份不匹配或恢复失败时,保留日志,不要反复强杀未知 Node 进程。

常见问题

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

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

如果换肤后界面异常,先做什么?

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

来源与延伸阅读