OPEN SOURCE · MIT · CDP 本机注入

Codex 换肤，一张图就是一套主题。

给 Codex 桌面版换一张会呼吸的脸。丢进一张你喜欢的图，它就是你的 Codex 皮肤；顶部菜单即点即换，深浅外观自动同步。本机 CDP 注入，不碰 app.asar 与签名，随时一键还原官方界面。

开始换肤 → 去 GitHub 点 Star

真机截图 · 非概念效果图  |  macOS 真机验证  |  Windows 跨版本自动化  |  不需额外 API Key

HeiGe Codex Skin Studio 是免费开源的 Codex 桌面版换肤工具：当前版本 5.2.1，内置 10 个真机验证主题，覆盖 macOS 与 Windows 两个平台，代码全部以 MIT 协议公开。

10
内置真机主题
Miku、原神、鸣潮、火影、恋与深空
0
修改 app.asar
不碰二进制与签名资源
2
支持平台
macOS + Windows
1
张图 = 一套皮肤
任意图片自动取色
02 为什么选它 · FEATURES

真正的主题化，不是截图贴皮，也不魔改二进制。

给 Codex 桌面版做的是运行时注入，界面还是那套界面，氛围换成了你的。

F/01

真·可交互

侧栏、建议卡、项目选择、输入框都是原生 Codex 控件，整个窗口保持可交互，功能一个也不少。

F/02

一张图 = 一个主题

任意 PNG / JPG / JPEG / WebP 直接生成皮肤，自动提取主色、辅色、面板底色和文字色，并按图片亮度同步深浅外观。

F/03

顶部菜单即点即换

应用皮肤后 Codex 顶部出现 🎨 菜单，所有已装主题和原生界面即点即换。嫌碍眼可收成一颗半透明小圆点。

F/04

安全边界清晰

主题通过仅绑定 127.0.0.1 的 Chrome DevTools Protocol 加载，完全不碰 app.asar、二进制和签名资源。菜单控制接口另有 token 与 schema 校验。

F/05

一键还原

随时切回官方外观，不留任何永久修改。由于官方安装目录从未被改动，还原即时且无损，Codex 更新后重启即可继续用。

F/06

AI 生成主题

把 Skill 交给 Codex，让它先用生图能力产出主图，再自动做成皮肤。全程不需要额外 API Key，一句话出一套新皮肤。

F/07

自带可选 Pet

安装包内附独立的 Miku Future 动画桌宠，含待机、奔跑、挥手、跳跃等动作，不覆盖 Codex 内置宠物，只装皮肤时也不强制启用。

F/08

你决定是否常驻

皮肤只在你显式打开顶部「皮肤常驻」开关后才跨启动保留。生命周期 pause / resume / restore 分离，主动权始终在你手里。

F/09

免费开源

MIT 协议，社区驱动。注入器每一行代码都可审计，欢迎贡献你自己的主题或 fork 出专属皮肤包。

03 几分钟装好 · INSTALL

下载开源安装器，运行，挑一张图。

需要已安装 Codex 桌面版。你的 API Key 和模型配置不会被读取或修改。

macOS 真机验证

1

从 GitHub 下载或克隆仓库。安装脚本会把工具放到 ~/.codex/heige-codex-skin-studio，默认应用 Miku 预设。

2

运行安装器（换肤时 Codex 会正常退出并以调试模式重开，请先保存任务）。

3

在 Codex 顶部 🎨 菜单里即点即换，或选「＋ 自定义图片」上传你自己的图。

open "<仓库路径>/scripts/install.command"

Windows 跨版本自动化

1

从 GitHub 下载或克隆仓库。入口位于 scripts\windows，仅写当前用户目录。

2

运行安装脚本，创建「HeiGe 皮肤启动器」开始菜单快捷方式。系统 Node.js 需 22 或更新版本。

3

启动后从顶部菜单切换主题；想下次启动仍保留皮肤，手动打开常驻开关。

powershell -ExecutionPolicy Bypass -File .\scripts\windows\install.bat

把换肤这件事交给 Codex

把 output/heige-codex-skin-studio.skill 交给 Codex，直接用一句话让它出图并换肤，无需额外 API Key。

「先生成一张蓝紫色赛博城市主图，再把它做成 Codex 皮肤并应用。」

提示：非 OpenAI 官方产品，换肤与 API 配置完全独立。若提示「端口未就绪」多半是旧实例没退干净，完全退出 Codex 再重跑脚本即可。

04 透明边界 · TRANSPARENCY

把每一条边界写在明处。

适用应用
OpenAI Codex Desktop（ChatGPT 桌面端）
注入方式
Chrome DevTools Protocol，调试端口仅绑定本机回环 127.0.0.1:9341。Codex 桌面端是基于 Electron 构建的应用，app.asar 是 Electron 应用的标准资源包，本工具对它只读不改
不做的事
不修改 app.asar、应用二进制或签名资源；不读取、不改写 API Key 与模型配置
内置主题
10 个（1 个高精度 Miku 488137 + 8 个游戏轻量主题 + 1 个彩蛋「大佬 · 点烟」）
运行时依赖
零 npm 运行时依赖；使用系统 Node.js 时要求 22 或更新版本
协议
代码采用 MIT 许可证（全文见仓库 LICENSE）；角色素材权利归各自权利人，逐文件来源见 ASSET_PROVENANCE
05 常见问题 · FAQ

给 Codex 换肤前，大家最常问的。

Q1 什么是 Codex 皮肤？＋
Codex 皮肤是 Codex 桌面版的视觉主题，在运行时把自定义背景、配色和文案注入界面。侧栏、建议卡、项目选择和输入框都保持原生 Codex 控件，变的只是外观。
Q2 换肤安全吗？会弄坏 Codex 吗？＋
换肤通过仅绑定本机回环地址 127.0.0.1 的 Chrome DevTools Protocol 在运行时注入，不修改 app.asar、二进制或签名资源。关闭常驻后本次会话仍保留皮肤，下次正常启动回到官方原生界面，还原即时无损。CDP 本身无认证，本机同权限进程仍在威胁边界内，完整说明见仓库 SECURITY.md。
Q3 会改动我的 API Key 或模型配置吗？＋
不会。换肤与 API 配置完全独立，安装器不读取、不改写你的 API Key、Base URL 或模型供应商设置。
Q4 预览图是真机截图还是概念效果图？＋
本站画廊标注 LIVE 的都是真实注入 Codex 后的真机截图，控件全部原生。内置的 8 款轻量预设使用同场景的无文字干净壁纸，即装即用。另有一组 4K 概念图单独标注，只表达设计方向，不作为可导入背景。
Q5 怎么用自己的图片做 Codex 主题？＋
三条路：顶部菜单选「＋ 自定义图片」直接上传，自动按图片取色并同步深浅外观；双击 customize.command 走图形界面；或命令行 node src/cli.mjs create --image 图片路径 --name 主题名。任意 PNG、JPG、JPEG、WebP 都能生成皮肤。
Q6 支持 Windows 吗？＋
支持。提供传统安装脚本，并实现了 Microsoft Store / MSIX 的确定性发现与系统激活路径。Windows 自动化覆盖 PowerShell 5.1、PowerShell 7、32 位解析与隔离任务，Microsoft Store 真机仍标记为待验证。使用系统 Node 运行时要求 Node.js 22 或更新版本。
Q7 Codex 更新版本后皮肤还能用吗？＋
多数只更新内容的版本不需要重新打补丁，因为本项目不修改安装包。CDP 启动参数、renderer 分类和界面选择器属于兼容边界，未来 Codex Desktop 变化时可能需要更新本项目。升级后失败先运行 doctor 并在 Issue 附上脱敏结果。
Q8 收费吗？和其它换肤方案有什么不同？＋
完全免费，代码使用 MIT 协议开源，注入器每一行都可审计。区别在于：这里给的是真机验证的主题和即装即用的干净壁纸，不是只能远观的概念图；换肤全程不碰 app.asar，一键无损还原。角色与第三方素材权利归各自权利人。
06 一起做主题 · COMMUNITY

Codex 皮肤共创交流群

这是一个纯技术交流、非盈利的微信群。分享你做的主题、聊实现、提问题都欢迎。二维码过期了就在仓库开个 Issue，我会换新的。

Codex 皮肤共创交流微信群二维码
WECHAT · 扫码进群
挑一张图，今天就给 Codex 换肤。

免费开源是底线，一键还原是后路。和一群开发者一起，给你的编程智能体一点个性。

去 GitHub 开始 → 查看安装教程