简体中文 · English
Codex NN，给 Codex 换套新衣服。
Codex 换肤神器 · 可视化操作 · AI 主题设计 · 一键切换
Important
Codex 暖暖是社区项目，并非 OpenAI 官方产品。项目不会修改 Codex 的官方安装包、程序文件或代码签名。
Codex 暖暖（Codex NN） 是为官方 Codex Desktop 打造的可视化主题管理器。
不用手动改文件，也不用反复执行脚本。打开 Codex 暖暖，选择喜欢的主题，然后一键启动或切换，就能为 Codex 换上全新的界面风格。
以下截图均为 Codex 新任务页的整窗效果。
- 可视化操作：主题预览、安装、切换、恢复都在桌面界面中完成
- 零门槛主题设计：只需描述想要的风格或提供概念稿，不懂配色、schema 和打包也能制作主题
- 内置主题设计 Skill：可为 Codex 或 Claude Code 安装随应用提供的主题设计插件，让 AI 自动完成概念稿、背景、配色、文案和主题包
- 边设计边看效果：Codex 或 Claude Code 可通过本地 MCP 安装、切换和诊断主题，在真实 Codex 界面中预览后继续对话调整
- 开箱即用：内置「云海远行图鉴」「初音未来 · 未来共创」「星莓绮梦」「苍蓝矩阵」和「瑞克与莫蒂 · 多元宇宙开发站」五个主题，安装后即可开始使用
- 一键切换：主题会话运行时支持热切换，不用重复配置
- 本地主题库：通过 ZIP 安装、更新和管理自己的主题包
- 完整控制：支持启动或重启 Codex、暂停主题和一键恢复官方外观
- 状态诊断：检查 Codex 安装、主题文件和本地端口，也可实时验证换肤结果
- 后台守护：关闭主窗口后驻留系统托盘，持续维护当前主题
- 自动更新：启动时自动检查 GitHub Releases，并可在应用内完成下载安装
- 跨平台：支持 macOS 与 Windows
- 安装并至少启动一次官方 Codex Desktop。
- 从 Releases 下载当前系统对应的 Codex NN 安装包。
- 安装并打开 Codex 暖暖。
- 在「主题库」中选择主题，点击「应用主题」。
- 通过 Codex 暖暖启动或重启 Codex，主题即可生效。
Tip
主题生效期间请让 Codex 暖暖在后台运行。关闭主窗口只会收进系统托盘；从托盘彻底退出时，当前主题会自动暂停。
| 平台 | 支持的 Codex 安装来源 | 安装包 |
|---|---|---|
| macOS | 官方 Codex Desktop 应用 | Universal .dmg / .app |
| Windows | Microsoft Store 官方 Codex | x64 .exe |
Linux 暂未支持。
在「主题库」中点击「安装主题包」，选择符合 Codex NN 规范的 ZIP 文件即可。安装完成后可以预览、切换、更新或删除主题。
一个最小主题包包含以下两个文件：
my-theme.zip
├── theme.json
└── background.webp
主题包仅包含声明文件和本地图片，不支持脚本、CSS、远程资源或加密文件。完整字段、图片规格和打包方法请查看 主题包 v1 规范。
从 Dream Skin macOS 迁移主题时，点击「导入 Dream Skin」，可以直接选择它的主题目录或双文件 ZIP。Codex NN 会保留 schema v1 的同名字段和缺省语义，并使用同步的 Dream Skin 1.2.0 渲染器；不会执行主题包中的脚本或 CSS。
不需要了解主题规范，也不需要手动制作配置文件：
- 在 Codex 暖暖中打开「设计主题」，点击「安装主题设计插件」。
- 在 Codex 中新建任务，用一句话描述想要的视觉风格，也可以附上概念稿。
- Codex 会先生成完整界面概念供你确认；确认后再制作背景、配色、文案和经过校验的 schema v1 ZIP。
- Codex 会通过本地 MCP 安装并切换主题。直接查看真实界面效果，继续告诉 Codex 哪里需要调整，满意后获取最终 ZIP。
主题设计插件可以随时从「设计主题」页面卸载。
Claude Code 插件复用同一套 Codex NN schema v1 规范和本地 MCP。Codex 暖暖只负责安装主题设计 Skill 和 MCP 连接，不接管 Claude Code 的账号或模型配置：
- 按 Claude Code 官方安装指南 安装 Claude Code，并自行完成登录、模型和接口配置。运行
claude --version确认命令可用。 - 在 Codex 暖暖的「设计主题」页面选择 Claude Code，然后点击「安装 Claude Code 插件」。
- 保持 Codex 暖暖运行并新建 Claude Code 会话，描述想要的主题或提供概念稿。Claude 会先展示完整界面概念；只有你明确确认后，它才会生成最终背景和 ZIP，并通过 MCP 安装、切换和诊断主题。
Skill 安装在 ~/.claude/skills/codex-nn-theme-designer。Claude Code 会继续使用你已有的登录态、模型和接口设置；Codex 暖暖不会读取或修改 ~/.claude/settings.json，也不会读取、保存或传输 Claude Code 的 API Key。
Codex NN 通过仅监听 127.0.0.1 的 Chrome DevTools Protocol（CDP）连接，为正在运行的 Codex 页面加载主题，并由后台守护进程维持主题状态。
- 不修改 Codex 官方安装目录
- 不替换官方二进制文件
- 不破坏应用代码签名
- 只连接经过校验、属于当前 Codex 进程的本机端口
- 可随时使用「完全恢复」回到官方启动方式和界面
主题会话运行时，Codex 会开放一个仅限本机访问的调试端口。Codex NN 会校验端口归属并拒绝非回环连接，但仍建议不要在主题会话期间运行来源不明的本机程序。
Codex 更新可能改变界面结构，导致部分主题暂时失效。遇到问题时可以先使用「诊断」检查状态，或点击「完全恢复」回到官方外观。
欢迎通过 Issue 反馈问题、提交主题兼容建议，或通过 Pull Request 改进 Codex NN。
Codex NN 基于 MIT License 开源。
主题引擎的部分实现参考并修改自 Codex Dream Skin Studio，详情请查看 第三方声明 与 对应许可文本。
Codex、OpenAI、Claude、Anthropic 及相关名称和标识归其各自权利人所有。本项目与 OpenAI 或 Anthropic 不存在隶属或背书关系。
如果 Codex 暖暖让你的工作台更有趣，欢迎点一个 Star ⭐