常见问题
Codex 主题常见问题
关于安装、生效、恢复、升级失效等高频问题的解答。
Codex 主题怎么装？
用开源项目 Codex Dream Skin。macOS 上双击仓库里的 Install Codex Dream Skin.command（或终端运行 ./scripts/install-dream-skin-macos.sh），引擎装到 ~/.codex/codex-dream-skin-studio/ 并在桌面生成四个启动器。注意 macOS 不用单独装 Node——直接复用 Codex.app 内置的签名 Node。Windows 需先装 Node.js 22+，再运行 scripts/install-dream-skin.ps1。详见本站换肤教程。
在 Mac 上能换 Codex 主题吗？
可以，而且自定义能力最全。Codex 桌面端是 Electron 应用，macOS 上能选自己的背景图、自定义配色（用 Customize 命令），并通过本机 CDP 注入换肤。Windows 目前只能用内置的固定粉紫皮肤，暂不支持自定义图片。
Codex 主题没生效怎么办？
Codex 必须以调试参数启动（脚本会自动加 --remote-debugging-port=9341）。完全退出 Codex（不是最小化）后，双击 Start Codex Dream Skin.command 重新启动并注入；确认 9341 端口没被占用（冲突时会自动扫描到 9441）。如果某段文字在背景上看不清，重跑 Customize 调整 --accent/--secondary/--highlight 配色。
Codex 升级后皮肤失效了怎么办？
Codex 版本升级后，皮肤有可能短暂失效，因为换肤引擎依赖的界面结构可能变化。双击 Restore Codex Dream Skin.command 一键回到默认界面，或重新 Install + Start 再次应用；引擎每次启动都会重新探测官方 Codex 包，支持跟随升级，不影响 Codex 正常更新。
换肤会修改我电脑上的 Codex 官方安装包吗？
不会。换肤只通过本机回环地址 127.0.0.1 注入 CSS/JS，在界面层面叠加装饰，不修改 Codex 官方的 .app 安装包与代码签名，因此也不会影响后续官方更新，更不会触碰你的代码与项目文件。
Codex 换肤安全吗？
换肤只走你自己电脑的本机回环地址，不涉及外部网络通信，也不上传任何数据，只是给界面叠一层视觉效果。需要注意：CDP 在本机是免认证的，所以主题运行期间别同时跑来路不明的本机程序，用完用 Restore 关掉调试口即可。请遵守 Codex 使用条款，优先用开源可审查的脚本。
怎么一键还原 Codex 默认界面？
macOS 双击桌面的 Restore Codex Dream Skin.command 即可（它运行 restore-dream-skin-macos.sh --restore-base-theme --restart-codex），一条命令清除注入、回到默认界面，不影响后续更新。Windows 用 PowerShell 运行 powershell -File windows/scripts/restore-dream-skin.ps1 -RestoreBaseTheme。建议升级 Codex 前或主题异常时优先用它。
本站的 Codex 主题免费吗？
本站展示的主题配色方案均可免费参考使用——配色与文字配置不涉及版权，你可以直接照着配色和教程自己生成。如果你不想自己找图、调色，我们的代定制服务可以帮你生成专属主题包，一次到位。
怎么自己做一个 Codex 主题？
macOS 上运行 Customize 命令：选一张背景图、填名字和三个配色（--accent/--secondary/--highlight），脚本会写出 theme.json 并自动套用。例如初音：customize-theme-macos.sh --image miku.png --name "Hatsune Miku" --accent "#39C5BB" --secondary "#FF61C7" --highlight "#00B4DC"。不满意就改配色重跑，或直接手改 theme.json。
哪里可以下载 Codex 主题包？
需要先说清一个事实：开源项目本身没有主题商店，也不存在'导入主题'的命令。一套主题本质上就是一个文件夹——里面一份 theme.json（配色+文字配置）加一张背景图。所以获取方式有两种：① 自己用 Customize 命令选图+配色生成；② 拿到别人的 theme.json + 图片文件夹，丢进 ~/Library/Application Support/CodexDreamSkinStudio/themes/<名字>/ 再用 switch-theme-macos.sh --id 切换。本站提供各主题的配色方案，照着填即可。
Codex 换肤支持哪些操作系统？
支持 macOS 和 Windows（Codex 桌面端是 Electron 应用，没有 Linux 版）。两者有差别：macOS 能自定义背景图与配色（复用 Codex 内置 Node，无需另装）；Windows 目前是固定粉紫皮肤、需自装 Node.js 22+，暂不支持自定义图片。
Codex 桌面宠物也能换吗？
Codex 的桌面宠物同样支持自定义。你可以把宠物和主题搭配起来，做成一套联动的视觉风格。本站后续也会整理桌宠相关资源，敬请关注主题画廊与资源页的更新。