Codex-Dream-Skin README

The project's README from github.com/Fei-Away/Codex-Dream-Skin. As one markdown file: README.md.

Codex Dream Skin

中文 · English

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

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

官方主题库:DreamSkin.cc · 主题库 Gallery · 在线 Studio

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

🤝 独家赞助

Passion8 感谢 Passion8 独家赞助本项目!Passion8 是一家面向开发者的 AI API 中转服务商,为个人开发者与团队提供稳定、低成本的主流大模型接入。

满血 AI · 触手可及:OpenAI、Claude 全系列原版模型,无降智、无套壳;使用前沿 AI 模型仅需官方价格的一小部分,充值 1:1,1$ = 1¥。保留原有官方 SDK,只把 Base URL 换成 Passion8,Claude Code、Codex、Grok 以及任意 OpenAI 兼容客户端都能直接跑——一行配置,代码不用改。 全球节点加速:Cloudflare 全球边缘 + 多线路 BBR 加速,低延迟、高可用、稳定如一;7×24 稳定中转,99.9% SLA,首 Token 目标 1 秒内。 安全可靠:独立 API Key、密钥加密存储、全链路 HTTPS,隐私优先。

Passion8 为本项目用户准备了专属福利:通过此链接注册,首次充值自动赠送 10% 额度,无需申请,30 分钟内到账。有问题联系 [email protected]。

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

直接安装

普通用户只需先安装并退出一次官方 Codex / ChatGPT,然后从 GitHub Releases 下载:

不需要 clone 源码、安装 Node.js 或手动运行 .sh / .ps1。首次未签名放行、更新和卸载步骤见 macOS 安装说明 / Windows 安装说明。

主题库与社区

DreamSkin.cc

DreamSkin.cc · 本项目的官方主题库与创作平台
Make your workspace yours.

浏览主题库 →  ·  在线 Studio →

社区主题「悟空(WUKONG)」在桌面模拟器里的实机效果
「悟空(WUKONG)」by JamesOpsLab
社区主题「DeepSeek-鲸鱼娘」在桌面模拟器里的实机效果
「DeepSeek-鲸鱼娘」by powerdog996

在 DreamSkin.cc 在线 Studio 里调好的一套自定义背景效果
在线 Studio · 换一张喜欢的背景图,调好焦点与配色,就是你自己的主题

macOS 菜单栏和 Windows 托盘都有「主题库 Gallery」和「在线 Studio」入口,可以直接打开。

一键换肤

在 DreamSkin.cc 上看到喜欢的主题,点「一键换肤」就能让本机客户端直接装上,不用先下载再手动导入。 需要 v1.5.0 或更新的客户端(建议 v1.5.5 及以上)。

流程与安全边界:

只有完整满足当前主题包契约(背景图 + theme.json + 非空 theme.css + 声明 safe-css 能力)的主题 才会显示一键换肤按钮;不满足的走下面的手动导入。

实测精选预设

Gothic Void Crusade / 哥特虚空远征

特别感谢 @seansong-ideogram 为社区设计并贡献这套精美、极具氛围感的原创哥特科幻作品。 它是当前实测精选的第一套预设,也是 macOS 全新安装时默认启用的主题。

哥特虚空远征主题实机效果
真实 Codex 首页注入效果(仅预览)

安装后可直接从 macOS 菜单栏的「已保存主题」切换。

桥本有菜 / Arina Hashimoto

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

桥本有菜主题浅色实机效果
浅色 · 真实注入截图(未发送输入已在截图时遮蔽,仅预览)

桥本有菜主题暗色实机效果
暗色 · 真实注入截图(未发送输入已在截图时遮蔽,仅预览)

这组人物素材留在源码仓库用于参考与权利核验,不进入公开 DMG / Setup.exe;公开安装包只预置已确认 可分发的 Gothic Void Crusade。普通用户仍可从菜单里的「更换背景图」导入自己有权使用的纯背景, 保存后继续一键切换。

可下载的用户源图是 docs/images/presets/arina-hashimoto-source.png(1672 × 941);源码参考预设使用 macos/presets/preset-arina-hashimoto/background.jpg(规范化派生 2560 × 1440)。上面两个效果图包含真实 UI,只作预览,绝不能当背景导入。背景为用户提供的 AI 生成示例,不代表 OpenAI/Codex 官方视觉或背书;未确认人物与素材权利前不得把它打进公开安装包。

它能做什么

快速开始

普通用户:下载安装包

不需要 clone 仓库,也不需要安装 Node.js 或运行 .sh / .ps1。从 GitHub Releases 下载对应平台的最新安装包, 按平台文档完成一次图形界面安装:

平台 下载 安装说明
macOS CodexDreamSkin-vX.Y.Z.dmg docs/install-macos.md
Windows CodexDreamSkin-Setup-vX.Y.Z.exe docs/install-windows.md

安装后从菜单栏(macOS)或系统托盘(Windows)使用。更新时下载新安装包覆盖安装,主题和图片会保留; 未签名的新下载文件在个别系统上仍可能再次出现一次安全提示,文档列出了放行方法。

导入下载的主题

从 DreamSkin.cc 装主题优先用一键换肤。下面是手动导入 .zip 的兜底路径,也适用于任何 其他来源的主题包。

在 macOS 菜单栏选择“导入主题 ZIP…”,或在 Windows 托盘选择同名菜单。只支持普通 .zip, 不支持 .dreamskin 后缀,也不要仅改后缀伪装。正式 Studio 主题包包含 manifest.json、 theme.json、非空 theme.css 和恰好一张 background.webp|jpg|png;还可包含 LICENSE.txt 和预留的 manifest.sig。这些文件可以位于 ZIP 根目录或唯一一层主题目录。导入器会核对适用平台、最低客户端 版本,以及清单中每个负载文件的大小和 SHA-256。theme.css 必须通过本机 Safe CSS 校验,导入后只会 作用于 12 个注册部件;每次切换/应用仍会重新校验。manifest.sig 当前不参与签名验证。

本地简化 ZIP 也必须恰好包含非空 theme.json、非空 theme.css 和其引用图片;该格式没有正式清单的 完整性与兼容性声明,只应从可信来源使用。压缩包最大 32 MiB、最多 32 个条目、解压后最多 64 MiB。 导入成功后主题只会加入“已保存的主题”,不会自动替换当前主题;相同内容不会重复写入。同 ID 的新版本会在 确认旧目录身份后原地更新,并仅清理语义指纹完全一致、已确认属于同一主题的旧版 -2/-3 重复目录;无法 确认身份时会拒绝覆盖,也不会根据名称猜测并删除其他主题。

也可以先手动解压,再把包含 theme.json、theme.css 和背景图的完整主题目录移动到本机主题库:

菜单里有“打开主题文件夹”快捷入口。移动后重新打开菜单/托盘即可;不要再套一层目录,也不要放链接、 嵌套压缩包或缺少三件套的文件夹。手动目录不会经过 ZIP 导入器的归档校验,请只使用可信内容。升级前 已经保存且没有 CSS 的 legacy 主题仍可切换,但不会注入额外 CSS。

开发者:从源码运行

仓库内按平台放了现成脚本(实现细节不同,效果都是「主题化 Codex」):

平台 目录 入口
Apple Silicon / Intel Mac macos/ 双击 Install Codex Dream Skin.command
Windows windows/ scripts/install-dream-skin.ps1 → start-dream-skin.ps1

更细的说明:

反馈与贡献

安全边界

许可与声明


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

Codex-Dream-Skin (Fei-Away/Codex-Dream-Skin)

theme
Searching Database…

What is this?Codex Dream Skin is an external theming tool that re-skins the Codex (and ChatGPT) desktop client with custom backgrounds and CSS, without modifying the official app package.
Is this a theme pack or does it modify the app itself?It is a standalone companion app that injects CSS/background into the Codex client via local Chrome DevTools Protocol (CDP) at runtime; it never edits the official .app, app.asar, or WindowsApps files.
How do I install and use it?Quit the official Codex/ChatGPT app once, then download CodexDreamSkin-vX.Y.Z.dmg (macOS) or CodexDreamSkin-Setup-vX.Y.Z.exe (Windows) from GitHub Releases and run the installer; afterwards use the macOS menu bar or Windows tray to pick or import themes.
Is the one-click theme install from DreamSkin.cc always available?One-click apply only works on client v1.5.0+ (v1.5.5+ recommended) and only for themes that fully satisfy the theme package contract (background, theme.json, non-empty theme.css, declared safe-css support); otherwise you must import the .zip manually.
Does it support both Apple Silicon and Intel Macs, plus Windows?Yes, it supports Apple Silicon and Intel Macs as well as Windows.
What does it actually let me customize?You can swap the 16:9 background wallpaper behind the Codex UI, adjust safe CSS styling affecting 12 registered widgets, save and switch multiple local themes, and restore the original official appearance at any time.
What is DreamSkin.cc?It is the project's official theme gallery and online Studio where you can browse community-reviewed themes, preview them in a desktop simulator, create your own by adjusting background/colors/Safe CSS, and export or submit theme .zip packages.
What is the default preset on a fresh macOS install?Gothic Void Crusade, an original gothic sci-fi theme contributed by community designer seansong-ideogram, ships as the default enabled theme on new macOS installs.
Does importing a theme ever auto-replace my current theme?No, a successfully imported theme is only added to your saved themes list and never automatically replaces the currently active theme.
Creator
Fei-Away
Size
30.1 MB
Stars
15.1K
Age
3mo
Commits · 90 Days