Studio
全部教程
Codex Dream Skin 使用教程

在 Windows 安装 Codex Dream Skin

为 Microsoft Store 的 Codex 官方应用安装 Dream Skin，验证真实界面，并保留安全回退。

简短答案

Windows 版 Dream Skin 需要 Microsoft Store 的 Codex、PowerShell 5.1 或更高版本，以及 Node.js 22 或更高版本。程序文件、主题、日志和保存的设置都位于 %LOCALAPPDATA%\CodexDreamSkin。

运行条件

  • 从 Microsoft Store 安装、并注册到当前 Windows 用户的 OpenAI.Codex 官方应用。
  • Windows PowerShell 5.1 或更高版本，且 PATH 中可找到 Node.js 22+。
  • 安装前完全退出 Codex；正常安装不需要管理员权限，也不需要接管 WindowsApps。
01

检查项目说明和运行前提

打开 Codex Dream Skin 项目主页中的 Windows 安装说明，并在安装前确认 Node 和当前用户的 Store 应用。

node --version
Get-AppxPackage -Name OpenAI.Codex
预期结果：Node 返回 v22 或更高版本，Get-AppxPackage 返回当前用户的 OpenAI.Codex 官方包。
失败时：应用包不存在、Node 版本过低，或安装器要求管理员接管 WindowsApps、API Key、供应商地址或无关 Codex 配置时，停止执行。
02

从 windows 目录安装

命令中的 Bypass 只作用于这一次安装命令。安装器会检查 Store 应用和 Node、保存可恢复的外观设置、校验复制文件，并创建启动、托盘和恢复快捷方式。

powershell.exe -NoProfile -ExecutionPolicy Bypass -File .\scripts\install-dream-skin.ps1
预期结果：程序文件出现在 %LOCALAPPDATA%\CodexDreamSkin\engine，并创建 Codex Dream Skin、Tray 和 Restore 快捷方式。
失败时：不要降低系统或企业策略。Windows 或杀毒软件阻止文件时，先保持隔离并核对项目的最新说明。
03

启动并选择主题

使用 Codex Dream Skin 快捷方式。已保存主题位于 %LOCALAPPDATA%\CodexDreamSkin\themes\<theme-id>；theme.json 和引用图片通过内置检查后，会出现在托盘的“已保存主题”菜单。

powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File "$env:LOCALAPPDATA\CodexDreamSkin\engine\scripts\start-dream-skin.ps1" -PromptRestart
预期结果：确认重启后，Codex 带着主题打开；托盘可以切换、暂停、保存或重新应用主题。
失败时：Codex 已打开时先关闭它或使用重启提示。不要为了释放端口而结束身份不明的进程。
04

完成自动和人工检查

项目附带的检查会确认主题属于当前 Codex 应用、原生侧栏和输入框仍在，以及装饰层不会拦截点击。之后还要手动检查首页和普通任务。

powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File "$env:LOCALAPPDATA\CodexDreamSkin\engine\scripts\verify-dream-skin.ps1" `
  -ScreenshotPath "$env:TEMP\codex-dream-skin.png"
预期结果：命令成功完成；截图没有溢出或难辨文字，侧栏、项目菜单、滚动、Diff、焦点和输入框交互全部正常。
失败时：查看 %LOCALAPPDATA%\CodexDreamSkin 下的日志，重装或修改主题前先恢复。
05

恢复官方启动方式

普通恢复会关闭托盘和 Dream Skin，恢复原来的外观，并重新打开官方应用。完整配置恢复是另一项仅供最后使用的操作。

powershell.exe -NoProfile -ExecutionPolicy RemoteSigned -File "$env:LOCALAPPDATA\CodexDreamSkin\engine\scripts\restore-dream-skin.ps1" `
  -RestoreBaseTheme -PromptRestart
预期结果：Codex 正常重新打开且皮肤消失；除非明确删除，主题和导入图片仍会保留。
失败时：只有 config.toml 已损坏且普通外观恢复失败时才使用 -RecoverConfigBackup；它会恢复范围更大的安装前备份。

项目参考资料

准备选择主题了吗？

应用到本地前，先预览素材和界面可读性。

浏览免费主题
在 Windows 安装 Codex Dream Skin | Codex Skin Lab