Codex Dream Skin 是一个免费开源的 Codex App 换肤 Skill。它可以为 Codex Desktop 安装可交互的背景皮肤:macOS 支持本地图片、CDN Banner 和主题库,Windows 支持本地图片与托盘切换;两个平台都支持运行验证和恢复官方外观。
不要下载 ZIP,不要打开终端,不要自己退出或重新打开 Codex。
把下面整段复制给 Codex:
请安装或覆盖更新这个 GitHub 仓库里的 codex-dream-skin Skill:
https://github.com/aithink001/Codex-Dream-Skin-Themes/tree/main/skills/codex-dream-skin
安装后请完整读取新版 SKILL.md,并按 Ordinary-user path 操作。
如果我还没有指定主题,只问我选择哪一种:
1. 世界杯主题
2. 使用我自己的图片
我选世界杯主题时,直接执行一键安装流程;我选自己的图片时,等我上传图片或粘贴 HTTPS 图片地址后,再执行自定义图片一键安装流程。
除一次“安装主题”确认弹窗外,不要让我运行任何命令,不要让我手动退出或重新打开 Codex。请自动完成安装、一次受控重启、主题应用和 Verify;只有 Verify 真正通过后才能告诉我成功。
接下来只需要:
- 回复 “1” 使用世界杯主题,或回复 “2” 后发送自己的图片。
- 看到系统弹窗后,点击安装。
- 等待 Codex 自动重新打开,不要手动操作。
两种方式都会自动使用适合背景图片的沉浸式深色外观,不受用户当前浅色或深色设置影响,也不会出现整层发白的背景。
看到选择的背景,并且 Codex 确认 Verify 通过,才算安装完成。如果没有变化,不要再次重启,只需要对 Codex 说:
检查 Dream Skin 主题安装结果并自动诊断,不要重启 Codex,也不要让我运行命令。
主题选择与一键安装目前用于 macOS。Windows 用户请看Windows 简单用法。
原生侧栏、项目选择、建议卡片、任务内容和输入框仍然可以正常点击与输入;主题图片只用于 Banner 和装饰背景,不会把一张假界面截图盖在 Codex 上。
没有合适的背景图?打开 Codex Dream Skin Banner 在线生成器
第一次使用 · 其他主题 · 功能对比 · 效果预览 · 验证与恢复 · 常见问题
直接使用本文最上方的主题选择提示词。Codex 会安装或更新 Skill,再根据你的选择自动完成主题应用和验证。
高级用户:手动安装 Skill
如果你熟悉终端,也可以手动安装:
git clone --depth 1 https://github.com/aithink001/Codex-Dream-Skin-Themes.git
mkdir -p ~/.codex/skills
cp -R Codex-Dream-Skin-Themes/skills/codex-dream-skin ~/.codex/skills/安装后可以通过 $codex-dream-skin 使用主题定制、切换、验证和恢复功能。
准备一张横向图片,建议宽度不低于 2000px。可以直接把本地图片路径或 HTTPS CDN 地址交给 Skill:
使用 $codex-dream-skin,把这张图片设置为我的 Codex 主题:
https://cdn.example.com/my-codex-banner.png
主题名称叫「Purple Night」。应用完成后运行 Verify 并保存验证截图。
还可以继续告诉 Codex:
使用 $codex-dream-skin 列出我保存的主题,并切换到「Purple Night」。
macOS 支持:
- 本地 PNG、JPEG、HEIC、TIFF、WebP;
- HTTPS CDN 图片;
- 主题名称、标语、引用文字和强调色;
- 保存多套主题并快速切换;
- SwiftBar 菜单栏控制;
- 暂停皮肤、重新应用、验证截图和完整恢复。
Windows 会先安装一套可用的内置主题,并提供系统托盘控制器:
使用 $codex-dream-skin 在 Windows Codex App 中安装主题,完成后运行 Verify。
安装后,在系统托盘的 Codex Dream Skin 菜单中选择“更换背景图”,即可使用本地 PNG、JPEG 或 WebP。托盘还支持保存当前主题、切换已保存主题、暂停/继续、重新应用和完整恢复。
| 功能 | macOS | Windows |
|---|---|---|
| 安装 Codex Dream Skin | ✅ | ✅ |
| 保留原生侧栏、任务和输入框 | ✅ | ✅ |
| 自定义本地图片 | ✅ | ✅ |
| 使用 HTTPS CDN Banner | ✅ | 需先下载到本地 |
| 保存和切换多套主题 | ✅ | ✅ |
| SwiftBar 菜单栏控制 | ✅ | — |
| 系统托盘控制 | — | ✅ |
| 自定义调试端口 | ✅ | ✅ |
| Verify 实时验证 | ✅ | ✅ |
| 输出验证截图 | ✅ | ✅ |
| 恢复 Codex 官方外观 | ✅ | ✅ |
| 构建可分发 ZIP | ✅ | — |
完整命令和高级选项见 codex-dream-skin/SKILL.md。
下面的图片适合用来选择配色、构图和氛围。最终主题会保留 Codex 原生控件,实际效果以 Verify 截图为准。
![]() Pink Custom · 粉系定制 |
![]() God of Wealth · 财神打工版 |
![]() Red-White Sci-Fi · 红白科幻 |
![]() Clear Custom · 清透定制 |
![]() Inspiration Universe · 灵感小宇宙 |
![]() Purple Night · 紫夜限定 |
![]() Miku Future · 虚拟歌姬未来 |
![]() Stage Black-Gold · 舞台黑金 |
选择一个风格并生成自己的 Codex Dream Skin Banner
Skill 会启动官方 Codex Desktop,并通过只监听 127.0.0.1 的 Chromium DevTools Protocol 注入主题 CSS 和装饰层。它不会修改、替换或重新签名官方应用文件。
Codex Dream Skin Skill
↓
启动官方 Codex + 本机回环 CDP
↓
注入主题 CSS、Banner 和装饰背景
↓
原生侧栏、项目、任务和输入框保持可交互
运行时固定到已检查的提交 a1c48b3a84cc64532196e624fdf33ee1277cb018,下载后会再次核对 Git commit。主题运行期间,请避免运行来路不明的本机程序;不再使用时可以随时运行 Restore 关闭主题和调试会话。
发送下面的提示词:
使用 $codex-dream-skin 验证当前主题,并保存一张验证截图。
Verify 会检查:
- 主题 CSS 和注入标记是否存在;
- 原生侧栏与输入框是否仍然可见;
- 首页 Banner、建议卡和项目选择是否正常;
- 是否出现横向溢出或装饰层遮挡点击;
- 页面重新加载后主题是否可以重新应用。
只有 Verify 通过,才表示当前 Codex Dream Skin 已正常运行。
发送:
使用 $codex-dream-skin 恢复 Codex 官方外观,并关闭主题调试会话。
恢复功能会移除主题 CSS 和装饰层,并恢复安装前保存的外观设置。macOS 还可以删除桌面启动器,Windows 可以选择恢复完整的安装前配置备份。
不是。这是面向 Codex Desktop 的非官方开源换肤工具,与 OpenAI 没有隶属、认可或赞助关系。
不会。主题通过本机回环 CDP 运行,不会修改 .app、app.asar、WindowsApps 或官方代码签名。
支持。Windows 可以通过系统托盘选择本地图片、保存和切换主题、暂停或重新应用皮肤,也可以运行 Verify、保存验证截图并恢复官方外观。
可以。macOS 支持本地图片和 HTTPS CDN 地址;Windows 支持从系统托盘选择本地 PNG、JPEG 或 WebP。建议使用横向构图,并让左侧保持简洁,以免影响原生标题和控件的可读性。
这是早期版本的首次安装初始化错误,当前版本已修复。请更新或重新复制 codex-dream-skin Skill,关闭 Codex 后重新运行安装;新版本会自动创建默认主题,不需要手动清理缓存或编写 theme.json。
重新运行安装、启动和 Verify。Codex 更新可能改变界面结构,因此每次更新后都建议重新验证。
普通方式重新打开 Codex 不会携带主题所需的启动参数。不要反复手动重启;使用 Skill 的一键安装流程,让它自动完成一次受控重启、应用和验证。
这是旧版世界杯主题跟随 Codex 浅色外观造成的。请覆盖更新本仓库中的 Skill,再按页面顶部的一键安装提示操作;新版会自动使用适合该图片的深色外观,不需要修改系统设置。
不会。展示图片全部通过 HTTPS CDN 加载,仓库不提交 JPG、PNG、WebP 等图片二进制。
skills/codex-dream-skin/SKILL.md— install, customize, switch, verify, package, and restore workflows.skills/codex-dream-skin/scripts/dream-skin-macos.sh— macOS command wrapper.skills/codex-dream-skin/scripts/dream-skin-windows.ps1— Windows command wrapper.prompts/themes.json— machine-readable Codex theme Banner prompts.
仓库代码与文本采用 MIT License。外部 CDN 图片不随仓库许可证自动授权。Codex、OpenAI 以及相关商标归各自权利人所有;人物、角色或商标素材用于公开再分发或商业项目时,请自行确认相应授权。
English: Open-source Codex Dream Skin Skill for Codex Desktop themes on macOS and Windows. Install a reversible skin, use custom images on both platforms, verify the live native interface, and restore the official appearance at any time.







