ToolBox
返回开源工具列表
我的 Codex 灰了三个月,终于给它换了一张会呼吸的脸

我的 Codex 灰了三个月,终于给它换了一张会呼吸的脸

给 OpenAI Codex 桌面端换皮肤的开源工具:本机 CDP 注入 CSS,不碰官方安装包、不改签名,一键还原。每天泡在 AI 编程界面里的人值得拥有。

2026年7月28日8 分钟开源主题 · Codex · 桌面美化 · 开发工具

每天盯着 Codex 八小时,原厂那个灰底白字看久了是真腻。直到前两天看见有人把它整成了 2007 年的 QQ——云天蓝窗体、企鹅头像、我的资料侧栏,我当场决定:我的 Codex 也该装修了。

让我动手的,是 Codex-Dream-Skin 这个项目(作者 Fei-Away,MIT 协议)。它不 fork、不魔改官方包,而是在运行时给 Codex 的渲染进程"穿衣服"。

Codex-Dream-Skin 的换肤效果预览

它到底动了什么

启动官方 Codex 之后,它通过本机 Chromium DevTools Protocol(CDP)在 127.0.0.1 回环地址上连上渲染进程,注入一段 CSS 和少量装饰用的 DOM 节点。结果就是:侧栏、项目选择器、建议卡片、输入框、任务内容——全都是 Codex 原生控件,只是外面那层视觉皮被换掉了。文字照样能选,按钮照样能点。

划重点:它明确不是 OpenAI 官方产品,也不修改 .app / app.asar / WindowsApps,不动代码签名。换肤和中转 API 配置完全分开,它碰不到你的 API Key。

这点我特别看重——很多"美化工具"为了效果会牺牲原生交互,它没这么干。

装上要几步

仓库里按平台放了现成脚本,入口不同但效果一致:

平台 目录 入口
macOS(Apple Silicon / Intel) macos/ 双击 Install Codex Dream Skin.command
Windows windows/ scripts/install-dream-skin.ps1start-dream-skin.ps1

我按 README 梳理了一遍前置,省得你踩坑:

macOS

# 1. 先装并打开过官方 Codex.app 至少一次
# 2. 克隆仓库
git clone --depth 1 https://github.com/Fei-Away/Codex-Dream-Skin
cd Codex-Dream-Skin/macos
# 3. 安装(--no-launch 表示先不启动 Codex)
./scripts/install-dream-skin-macos.sh --no-launch

装完菜单栏会多一个控制项,自带两套开箱即用的预设。

Windows

# 前置:Microsoft Store 版 Codex + Node.js 22+,且 Codex 至少启动过一次、安装前已关闭
cd Codex-Dream-Skin\windows
scripts\install-dream-skin.ps1
scripts\start-dream-skin.ps1

装完系统托盘里同样能切换 / 暂停 / 导入。

几个 README 强调的安全动作:安装前确认 Codex 已完全关闭;备份 ~/.codex/config.toml(Windows 在 %LOCALAPPDATA% 下对应位置);它不会动你的 API Key / Base URL。

换图比写 CSS 省事多了

挑一张横向、宽不低于 2000px 的图(风景、插画、游戏壁纸、AI 生图都行),交给它当背景。项目会在本机分析这张图的主色、焦点、安全区、亮度,自动生成一套协调的配色和侧栏可放置的安全区,再压一层毛玻璃。也就是说——换一张图,就换一种心情,不用写一行 CSS。

在线编辑器 Studio 长这样,可以实时调:

主题在线编辑器 Studio

预设也挺能打。比如这套暗调哥特:

预设:哥特虚空远征

还有社区做的"桥本有菜"主题,浅色 / 深色都给了:

预设:桥本有菜(浅色) 预设:桥本有菜(深色)

看个真人实录

官方没放视频,但社区有人(Justin @interjc)录了一期 3 分钟完整换肤实录,比文字直观。点下面这张图跳转:

社区 3 分钟换肤实录,点图观看

跳转页里"视频教程"一节就是那段 X 视频,想看实操的别错过。

几个该知道的边界

不是无脑吹,实话实说:

  • 只针对桌面端:网页版 Codex 没本地渲染进程,CDP 注入无从谈起。
  • Windows 认 Store 版:脚本按 Microsoft Store 版校验,其他来源装不上。
  • Codex 大版本更新可能"脱妆":它本质是外观注入,和 DOM 结构耦合。官方改了界面,部分样式可能失效——好在作者一直在跟进兼容。
  • 运行期间会开一个本机 CDP 调试端口(只绑 127.0.0.1),官方建议这段时间别跑来路不明的本机程序。
  • 随时能一键回原厂:菜单 / 托盘里的 Restore 一按,注入器停掉、Codex 重启、回到原厂皮肤,不残留任何东西在官方安装目录里。这点比什么都重要——它把"可逆"当成了设计的一部分。

和站里工具能搭上

配主题时有两个动作站里工具能直接帮上忙:

  • 取强调色:看中一张图的某个颜色想当 accent,用 颜色转换 把色值转成 HEX / RGB 填进 theme.css
  • 预处理背景图:横图丢进 图片调整大小 拉到 2000px+ 宽,再用 图片压缩 压到合理体积,导入更快、渲染更稳。

一句话收尾

Codex-Dream-Skin 不是"也许有用"的玩具,是那种装上就回不去的桌面美化。最打动我的是它的分寸感:换皮但不碰官方包、原生控件永远是原生控件、而且随时能一键回原厂。源码可审计,作者还在持续更(写这篇时已经到 v1.5.6)。

给 Codex 换张脸,大概率比你想的省事。挑张图,Star 一下,开干。