macOS 安装
在 macOS 安装 Codex Dream Skin
通过本站独立教程了解上游为 Apple Silicon 与 Intel Mac 记录的主题流程。
支持与要求
- Apple Silicon 或 Intel Mac
- 已安装并至少启动过一次官方 Codex 桌面端
- 本机存在 ~/.codex/config.toml
- 不需要另外安装全局 Node.js
获取第三方工具
打开原始仓库的 macos 目录，检查源码，并按照上游当时列出的获取方式操作；不要使用来历不明的下载镜像。
安装 Dream Skin
在 Finder 双击 Install Codex Dream Skin.command。下面的源码命令可以只安装而不立即启动。
./scripts/install-dream-skin-macos.sh --no-launch启动与定制
使用 Codex Dream Skin.command 启动或重新应用主题；使用 Codex Dream Skin - Customize.command 通过 Finder 选择图片。
~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh验证结果
双击 Codex Dream Skin - Verify.command，并检查主页和普通任务页，确认原生侧栏、项目选择、输入框和任务内容仍可使用。
~/.codex/codex-dream-skin-studio/scripts/doctor-macos.sh背景图片建议
- 支持 PNG、JPEG、HEIC、TIFF 和 WebP
- 源文件不超过 50 MB
- 处理后文件不超过 16 MB
- 建议使用宽度至少 2000px 的横图
- 左侧尽量简洁，为原生主页标题留出空间
恢复 Codex
双击 Codex Dream Skin - Restore.command。恢复流程只停止记录的注入器和匹配的主题 Codex 会话，然后重新打开官方应用。
./scripts/restore-dream-skin-macos.sh