最近,GitHub 上一个名为 Codex Dream Skin 的开源项目迅速走红——上线 24 小时内即获得 4.4K Star。作为对比,VS Code 最受欢迎的主题之一 One Dark Pro 用了数年才积累百万 Star。

这并非产品驱动的增长,而是社区情绪的自然爆发。一个解决开发者日常痛点的工具,往往比精心策划的营销更能打动人心。

为什么 Codex 需要换肤?
在了解项目之前,先看一个核心痛点:Codex 的 UI 定制能力几乎为零。

作为 OpenAI 推出的 AI 编程桌面端,Codex 功能强大,但在个性化方面非常保守:
- 没有插件系统 → 不能装主题
- 没有主题商店 → 不能换皮肤
- 没有 CSS 自定义 → 不能改字体/颜色/布局
- 唯一能改的:深色/浅色模式
对于每天面对编辑器 8 小时以上的开发者来说,这种单调感是切实存在的痛点。Codex Dream Skin 正是从这里切入。
项目简介
Codex Dream Skin 是一个为 Codex 桌面端换肤的外部工具。其核心思路是通过本机 CDP(Chrome DevTools Protocol)向 Codex 窗口注入 CSS 和装饰性 DOM,实现侧栏、建议卡、项目选择等区域的视觉换肤。
关键在于,它不修改官方 .app、app.asar 或代码签名,属于纯外部注入方案——相当于给 Codex 套了一层"滤镜",外观焕然一新,内核依然原装。
核心功能
真·可交互,不是假截图
很多换肤工具只是贴个背景图,交互完全失效。Codex Dream Skin 不同:
- 侧栏是原生控件,点击正常响应
- 建议卡可以正常滚动、点击
- 项目选择下拉框完全可用
- 输入框照常输入
换一张图,就能变个主题
项目提供多种主题效果:
- 🎨 粉系定制:清新柔和色调
- 🧧 财神打工版:红色喜庆风格
- 🚀 红白科幻:赛博朋克科技感
- 💎 清透定制:简约玻璃拟态效果
- 🌌 灵感小宇宙:星空背景
- 🌙 紫夜限定:神秘紫色调
- 🎤 初音未来:二次元风格
- 🖤 舞台黑金:高级质感
同时支持自定义背景图,用户可以上传自己喜欢的照片,打造独一无二的主题。
一键恢复,无后顾之忧
提供一键恢复功能,随时可以还原成官方外观,零风险试错。
技术原理
Codex 桌面端基于 Electron,本质上是一个 Chromium 窗口。这使得开发者可以通过 Chrome DevTools Protocol 注入 CSS 和 DOM 元素。
工作流程:
用户运行脚本
│
▼
启动 Codex Desktop + 本机 CDP(127.0.0.1)
│
▼
通过 CDP 连接 Codex 的 Chromium 渲染进程
│
├──→ 注入 CSS(覆盖主题样式)
│
└──→ 注入装饰 DOM(背景图、宠物等)
│
▼
Codex 正常运行,UI 被"换肤"
这种方案的优点:
- 安装简单(双击脚本即可)
- 不破坏官方文件
- 一键恢复方便
缺点:如果 Codex 更新 DOM 结构,注入的 CSS 选择器可能失效。不过项目团队在持续维护以确保兼容性。
快速上手
项目支持 macOS 和 Windows 双平台。
macOS 用户
- 打开终端,进入项目目录的 macos 文件夹
- 双击运行
Install Codex Dream Skin.command - 按照提示完成安装
- 运行
start-dream-skin.sh启动换肤后的 Codex
详细步骤:macOS 安装文档
Windows 用户
- 打开 PowerShell
- 运行
scripts/install-dream-skin.ps1安装 - 运行
start-dream-skin.ps1启动
详细步骤:Windows 安装文档
恢复官方外观
如需恢复原样,运行对应的 restore 脚本:
- macOS:
restore.sh - Windows:
restore.ps1
项目地址:https://github.com/Fei-Away/Codex-Dream-Skin