官方 Codex 桌面端
先安装官方 Codex，至少成功打开过一次。安装皮肤前把正在输入的内容保存好。
从下载到恢复 · 每一步都写清楚
跟着点、跟着复制，就能装好 Codex Skin。
不用会写代码。先选你的电脑，再按照编号一步一步做。每一步都告诉你该点哪里、该复制什么，以及看到什么才算成功。
最后核对：2026 年 7 月 17 日 · 上游提交 26c6c41 · 功能可能随更新变化。
开始前快速确认
- 第一次安装
- 约 10 分钟
- 不会改官方安装包
- 可恢复
- 两个平台都有教程
- Mac / Windows
第 0 步
先准备好这 3 样东西。
准备齐了再开始，安装过程中就不会因为缺文件来回找。
本站导出的皮肤 ZIP
在制作器点“导出”，下载以 .dreamskin.zip 结尾的文件。Mac 可以使用其中的 background.webp。
上游 Dream Skin 工具
本站不安装软件。下面的按钮会下载公开的 Fei-Away/Codex-Dream-Skin 源码压缩包。
把两个 ZIP 都放进“下载”文件夹
一个是你刚刚制作的皮肤，另一个是负责在电脑上运行皮肤的开源工具。不要把它们和 API Key、账号文件放在一起。
支持自己的图片
macOS 完整教程
Mac：双击文件就能装。
Mac 版会使用 Codex 自带并经过校验的 Node 运行时，不需要另外安装 Node.js。安装后会在桌面生成启动、定制、验证和恢复入口。
Mac 当前可以选择本站导出的 background.webp 作为主题图片。
- 01
先打开一次 Codex，再完全退出
打开官方 Codex，等首页出现。然后在屏幕左上角点“Codex”→“退出 Codex”，也可以按 Command + Q。
确认 Codex 窗口已经全部关闭，再继续下一步。看到这些就成功： 桌面上已经没有 Codex 窗口。 - 02
解压 Dream Skin 工具
打开“下载”文件夹，双击 Codex-Dream-Skin-main.zip。你会得到一个 Codex-Dream-Skin-main 文件夹。
依次打开 Codex-Dream-Skin-main → macos。看到这些就成功： 你能看到 Install Codex Dream Skin.command。 - 03
运行安装文件
按住 Control 点击 Install Codex Dream Skin.command，选择“打开”，弹窗里再点一次“打开”。终端窗口会自动完成安装。
如果它询问是否重启 Codex，先保存未发送的内容，再允许重启。看到这些就成功： 桌面出现 Codex Dream Skin、Customize、Verify、Restore 四个启动文件。如果系统提示无法验证开发者，请使用“Control 点击 → 打开”。不要关闭 Gatekeeper，也不要在系统设置里允许所有来源。 - 04
换成你自己制作的图片
双击你从本站下载的 .dreamskin.zip，把它解压。然后双击桌面的 Codex Dream Skin - Customize.command。
文件选择窗口出现后，进入刚解压的皮肤文件夹，选择 background.webp；接着输入一个主题名字并继续。看到这些就成功： Codex 重新打开，并显示你选择的背景。当前上游工具不会直接读取整个 .dreamskin.zip，也不会自动导入全部颜色参数；最简单的方式是选择里面的 background.webp。 - 05
运行验证，确认按钮真的能点
双击桌面的 Codex Dream Skin - Verify.command。脚本会在桌面生成并打开 Codex Dream Skin Verification.png。
回到 Codex，依次点侧栏、新任务、项目选择、输入框和一个 Diff，确认都能正常使用。看到这些就成功： 验证图片能打开，Codex 原有按钮、菜单和输入框都可以点击。 - 06
想恢复时，双击 Restore
双击桌面的 Codex Dream Skin - Restore.command。它会停止皮肤注入、关闭本机调试会话，并用普通方式重新打开 Codex。
不用主题时也建议执行一次 Restore。看到这些就成功： Codex 回到原来的外观，桌面启动仍可保留供下次使用。
PowerShell 安装
Windows 完整教程
Windows：复制 3 条命令。
Windows 版会检查 Microsoft Store 安装的官方 Codex 包，并用 PowerShell 创建桌面快捷方式。它需要 Node.js 22 或更高版本，调试端口只绑定本机 127.0.0.1。
先从 Node.js 官网下载 LTS 版本截至本页复核日期，Windows 上游版本暂不支持选择自己的图片。你可以安装和体验内置主题，但本站导出的 background.webp 目前不能直接导入。
- 01
安装 Node.js，并检查版本
打开上方 Node.js 官网，下载并安装 LTS 版本。安装过程一直点 Next，保持默认选项即可。安装完打开 Windows Terminal 或 PowerShell。
复制到终端node --version
看到这些就成功： 终端显示 v22、v23、v24 或更大的版本号。如果提示找不到 node，请关闭终端后重新打开；仍然不行就重启电脑。 - 02
解压工具并在正确文件夹打开终端
在“下载”文件夹右键 Codex-Dream-Skin-main.zip，选择“全部解压”。打开解压后的文件夹，再打开 windows 文件夹。
在 windows 文件夹空白处点鼠标右键，选择“在终端中打开”。如果没有这个选项，按住 Shift 再点右键，选择“在此处打开 PowerShell 窗口”。终端地址最后应该是 \windows。看到这些就成功： 输入 dir 后能看到 scripts 和 assets 文件夹。 - 03
关闭 Codex，然后运行安装命令
先把 Codex 完全关闭。复制下面整条命令，粘贴到刚打开的终端，按 Enter。
复制到终端powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\install-dream-skin.ps1"
看到这些就成功： 终端显示 Codex Dream Skin installed，桌面出现 Codex Dream Skin 和 Restore 快捷方式。脚本不应该要求你接管或替换 WindowsApps 文件。如果出现这种要求，请立刻停止。 - 04
双击桌面快捷方式启动皮肤
双击桌面的 Codex Dream Skin。若弹窗说需要重启 Codex，保存未发送的输入后点允许。
等待 Codex 打开，不要关闭一闪而过的启动窗口。看到这些就成功： 终端或日志提示皮肤在本机回环端口激活，Codex 显示内置粉紫主题。 - 05
生成验证截图
回到之前的 windows 终端，复制并运行下面命令。它会检查注入状态并把截图放到桌面。
复制到终端powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\verify-dream-skin.ps1" -ScreenshotPath "$HOME\Desktop\Codex Dream Skin Verification.png"
看到这些就成功： 桌面出现 Codex Dream Skin Verification.png，命令没有红色报错。 - 06
恢复官方外观
双击桌面的 Codex Dream Skin - Restore。确认后，它会关闭皮肤和调试会话，再正常打开 Codex。
如果桌面快捷方式丢失，也可以在 windows 终端运行下面的恢复命令。复制到终端powershell -NoProfile -ExecutionPolicy Bypass -File ".\scripts\restore-dream-skin.ps1" -RestoreBaseTheme -PromptRestart
看到这些就成功： Codex 重新打开并回到原来的外观。
最后花 1 分钟检查。
背景出现不代表安装完成。下面每一项都正常，才算真正装好。
- 左侧栏可以展开、切换和新建任务
- 项目选择按钮可以点击
- 输入框能输入文字、添加附件和提交
- 普通任务内容和工具状态看得清
- Diff 的红色、绿色语义仍然清楚
- 菜单、弹窗和键盘焦点没有被背景挡住
- 没有要求输入 API Key、Base URL 或账号密码
- Restore 已经亲自运行成功一次
Codex 更新后
先 Restore，再下载上游最新版本重新核对。旧选择器可能在新界面上失效。
遇到红色报错
先截图完整错误，再检查 Codex 是否关闭、Node 版本和终端所在文件夹。分享前遮住私人路径。
页面看起来不对
不要删除 Codex 官方文件。先运行 Restore，确认普通 Codex 能正常打开，再排查皮肤。
教程依据与当前限制
本教程逐项核对了公开仓库的 macOS README、Windows SKILL、安装、启动、验证和恢复脚本。上游目前只有 Mac 支持用户选图，两个平台都不会直接导入本站完整的 .dreamskin.zip。安装前仍建议打开仓库确认最新说明。
在 GitHub 打开 Fei-Away/Codex-Dream-Skin