Codex Dream Skin

中文 · English

给 Codex 桌面端换一张会呼吸的脸。
外部主题 / 换肤工具 · 本机 CDP 注入 · 不改官方安装包

一张图，一种心情 · 写代码，也要有氛围感

非 OpenAI 官方产品。不修改 .app / app.asar / WindowsApps。

先从这里开始：做你自己的皮肤

这个 Fork 不是某个角色或人物的主题下载站。它要解决的是一条真实可走通的工作流：把你自己的背景图变成一套可安装、可换图、可验证、可排错、可恢复的 Codex 皮肤。

Windows 最短路径：

1. 准备一张不带侧栏、按钮、输入框或文字的纯背景图。
2. 下载并解压仓库，双击 windows/Install Codex Dream Skin.cmd。
3. 从系统托盘选择「更换背景图」，导入自己的图片。
4. 检查新建任务页、普通任务页和输入框；满意后保存当前主题。
5. 需要退出时，使用 Restore 快捷方式恢复官方 Codex。

如果你准备直接对 AI 说“学习这个仓库，打造一个某某皮肤”，先看 《尽量一次成功：自定义 Codex 皮肤工作流》。它会先区分视觉皮肤、效果图、悬浮组件和可发行预设，再固定平台、构图、UI 边界、验收与恢复。

Windows 的实际操作与常见报错见 《从一张图做出自己的 Codex 皮肤》；全部文档见文档导航。

_{大耳兽只用于展示这套流程的最终效果，不是默认皮肤、背景下载或独立主题包}

安装、启动或恢复失败时，错误会保留在弹窗和 %LOCALAPPDATA%\CodexDreamSkin\*-error.log。部分 Microsoft Store 环境需要约 1.8GB 的本机启动副本；它不是主题素材，已被 Git 忽略，也不会进入 GitHub 或 Release。细节见指南的故障说明。

赞助商

更智能的连接 · 更热爱的创造
_{热爱驱动 · 无限可能 · Connect AI · Power Creation}

感谢 passion8.cc 赞助本项目。
满血 AI 中转：官方模型直连，无降智、无套壳；一行配置接入 Codex / Claude Code / Grok。

_{换肤与 API 配置互相独立，本项目不会自动改写你的模型供应商设置。}

实测精选预设：桥本有菜

下面这套「桥本有菜 / Arina Hashimoto」已经在真实 Codex 首页分别验证浅色和暗色外观。用户提供的源 PNG 为 1672 × 941，主题包在保持源图近 16:9 构图的前提下派生导出 2560 × 1440 JPEG，并不代表增加了源图细节。截图中的侧栏、卡片、项目选择和输入框都是 Codex 原生控件。

_{浅色 · 真实注入截图（未发送输入已在截图时遮蔽，仅预览）}

_{暗色 · 真实注入截图（未发送输入已在截图时遮蔽，仅预览）}

从仓库安装并一键切换（macOS）：

cd macos
./scripts/install-dream-skin-macos.sh --no-launch
~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh \
  --id preset-romantic-rose

Windows 使用本地主题仓库与系统托盘，并会预置同一套「桥本有菜」。首次从仓库使用：

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

启动后可直接从「已保存主题 → 桥本有菜」切换；不需要跨目录手动导入。托盘里的「更换背景图」仍可导入你自己的纯背景，保存后继续一键切换。

可下载的用户源图是 docs/images/presets/romantic-rose-source.png（1672 × 941）；macOS 一键预设使用 macos/presets/preset-romantic-rose/background.jpg（规范化派生 2560 × 1440）。上面两个效果图包含真实 UI，只作预览，绝不能当背景导入。背景为用户提供的 AI 生成示例，不代表 OpenAI/Codex 官方视觉或背书；公开再分发前请确认人物与素材权利。

概念效果图（不可直接导入）

下面八张图用于表达可实现的视觉方向，但它们是带界面的概念效果图，不是可直接使用的主题背景。需要同类效果时，先按参考生图提示词生成无 UI 的 2560 × 1440 素材；八种风格的详细拆解见概念图提示词。

_粉系定制

_{财神打工版}

_红白科幻

_清透定制

_{灵感小宇宙}

_紫夜限定

_{青蓝虚拟歌姬}

_舞台黑金

它能做什么

• 真·可交互：侧栏、建议卡、项目选择、输入框都是原生控件，不是整窗假截图贴上去
• 真背景层：一张 16:9 纯壁纸连续铺满整窗，首页突出氛围，任务页自动降低干扰
• 可换图：换一张喜欢的纯背景，自适应焦点、安全区和配色后变成你的主题
• 可存主题：macOS 菜单栏与 Windows 系统托盘都能保存/切换本地主题
• 可恢复：一键还原官方外观
• 相对安全：本机回环 CDP 注入，不改官方二进制与签名

快速开始

仓库内按平台放了现成脚本（实现细节不同，效果都是「主题化 Codex」）：

平台	目录	入口
Apple Silicon / Intel Mac	macos/	双击 Install Codex Dream Skin.command
Windows	windows/	双击 Install Codex Dream Skin.cmd

更细的说明：

• Mac：macos/README.md
• Windows：windows/SKILL.md
• 路径对照：docs/platforms.md
• 可直接复制的参考生图模板：docs/reference-background-prompt-guide.md
• 八种概念方向详细提示词：docs/background-generation-prompts.md
• 项目记录：docs/PROJECT.md

反馈与贡献

• Issue： 请用 Issue 模板（Bug / 功能）；已关闭空白 Issue。提交前建议先跑 Verify / Restore 自检。
• PR： 请按 PR 模板 写清改动，并勾选对应自测（如 macos/tests/run-tests.sh、verify / restore）。

安全边界

• CDP 只绑 127.0.0.1，主题运行期间勿跑来路不明的本机程序
• 不修改官方安装目录与代码签名
• 不会自动改写 API Key / Base URL；中转与换肤分开

许可与声明

• 见 LICENSE（MIT）与 NOTICE.md
• 非 OpenAI 官方产品；Codex 及相关权利归其权利人
• 随仓库预设及效果图中的人物 / IP 素材仅作主题示意；商用或公开再分发请自行确认肖像、素材与商标权利

---

Star 一下，然后挑一张图，把你的 Codex 变成今天想要的样子。