最近,很多用户都在给 Codex 做界面美化,但不少方案都踩中了同一个问题:直接替换 app.asar、覆盖官方资源文件,或者用整张截图覆盖整个界面。结果往往是客户端一升级就失效,严重时甚至会导致程序报错或无法正常使用。

今天要分享的这套方案,是一份可以直接落地使用的完整交付物——Codex Dream Skin。
它并不是简单的 CSS 代码片段,也不是单纯换一张背景图,而是一套适用于 Windows / MacOS 的 Codex 桌面版完整换肤方案。

Codex Dream Skin 是专门为 Codex Desktop 打造的完整主题美化方案。与传统 Codex 主题最大的区别是什么?
- 不修改官方
app.asar - 不覆盖官方资源文件
- 不影响原有功能
- 保留 Codex 原生交互逻辑
整个主题采用 CDP(Chrome DevTools Protocol)动态注入 的方式,在 Codex 启动完成后自动加载主题。因此:
- Codex 原有功能都能完整保留
- 升级官方客户端也不会污染程序本体
- 可以随时恢复为官方默认界面

很多人第一眼看到时,都会以为这又是“整图覆盖式”的界面美化。其实并不是。
Codex Dream Skin 的实现方式非常细致:
- 顶部 Banner 使用独立效果图裁切
- 下方四个功能卡片保持真实组件
- 「选择项目」区域依旧使用官方控件
- 输入框仍然保留 Codex 原生输入框
- 所有交互逻辑全部沿用官方实现
换句话说,整个界面本质上仍然是真实可用的 Codex,只是在视觉层面进行了重新设计和优化。
举个例子:Banner 可以单独替换,功能卡片依然可以正常点击,输入框可以正常输入内容,项目选择能够正常展开,原有快捷键也全部可用。所以不会出现那种“用一张图片遮住所有内容,结果什么都点不了”的尴尬情况。

整个主题方案最大的优势就是:完全不修改官方程序。
它的工作流程如下:
Codex 启动 → Codex Dream Skin → 连接本机 CDP → 动态注入 CSS → 动态插入 Banner → 完成换肤
也正因为如此,它不会去修改 exe、app.asar 或任何官方资源文件。即使官方客户端升级,后续也只需要重新启动 Dream Skin 即可再次注入主题,维护起来更加轻松省事。
Codex Dream Skin 支持:
- Windows / MacOS Codex Desktop 全平台支持
- 自动注入主题
- 保留官方全部交互能力
- 支持刷新、重启
- Codex 升级后可重新应用
- 一键恢复官方界面
这意味着你不需要在每次更新后都重新覆盖文件或重复修改客户端。
完整工具目录如下:
C:\Users\Administrator\.codex\skills\codex-dream-skin\
│
├── agents
├── assets
├── references
├── scripts
├── SKILL.md
整个目录就是完整的交付内容。请注意:不要只复制 CSS,不要只复制 Banner 图片,必须把整个 codex-dream-skin 目录一并交付,否则很多脚本和依赖将无法正常运行。
首次安装时,只需要运行 scripts\install-dream-skin.ps1。安装完成后,桌面会自动生成启动入口。之后再启动 Codex 时,无需重复执行安装脚本,直接使用 scripts\start-dream-skin.ps1 启动即可,主题会自动完成加载。
如果你想恢复默认界面,直接运行桌面上的 scripts\restore-dream-skin.ps1,即可恢复官方状态。整个过程不需要重新安装 Codex,也不会留下任何修改痕迹。
如果你想拥有一个更具个性化的 Codex 桌面环境,同时又不希望修改官方程序,那么 Codex Dream Skin 无疑是一种更稳定、更安全的实现方案。它通过 CDP 动态注入完成 Codex 换肤,不修改 app.asar,不覆盖官方资源,顶部使用独立 Banner,底部功能区、项目选择和输入框均保留 Codex 原生组件及交互逻辑。在提升界面美观度的同时,也确保了官方客户端的完整性与可维护性。对于后续升级和日常维护来说,这种方式也更加省心:支持重启、刷新以及 Codex 更新后的重新应用,并提供一键恢复官方界面的能力。交接时只需保留完整的 codex-dream-skin 文件夹,无需单独复制 CSS 或图片资源。
