macOS · Codex Dream Skin

macOS 安装教程

支持 Apple Silicon 与 Intel Mac。无需全局安装 Node.js——引擎在校验签名后使用 Codex 自带的签名版 Node。

需要 Windows 教程？→

Codex Dream Skin running on macOS — themed Codex desktop app

开始之前

  • 已安装官方 Codex 桌面端并至少启动过一次（即 ~/.codex/config.toml 已存在）
  • 一张你喜欢的宽幅图（建议宽度 ≥ 2000px，≤ 50 MB，支持 PNG / JPEG / HEIC / WebP）
01

下载引擎

下载最新源码 ZIP，或用 git 克隆：

git clone https://github.com/Fei-Away/Codex-Dream-Skin.git
cd Codex-Dream-Skin/macos
02

运行安装器

在 Finder 中双击 “Install Codex Dream Skin.command”。它会把引擎装到 ~/.codex/codex-dream-skin-studio 并在桌面创建启动器。也可以在终端运行：

./scripts/install-dream-skin-macos.sh --no-launch
03

选择你的图片

双击 “Customize Codex Dream Skin.command”（或运行下面的脚本），在 Finder 选图。引擎会用这张图生成横幅、背景与毛玻璃层。

~/.codex/codex-dream-skin-studio/scripts/customize-theme-macos.sh
04

启动带皮肤的 Codex

用桌面的 “Codex Dream Skin.command” 启动或重新应用。可选：安装 SwiftBar 菜单栏组件，在顶部 🎨 图标里应用 / 暂停 / 换图。

05

随时还原

双击 “Restore Codex Dream Skin.command” 即可回到官方外观。官方安装目录从未被修改，还原干净且即时。

选图技巧

  • 图片左侧尽量保持安静——原生首页标题会渲染在那里。
  • 图片只作为横幅 + 背景，UI 永远不会被假窗口覆盖。
  • 随时可用 “Verify Codex Dream Skin.command” 自检。

完整文档与源码： Fei-Away/Codex-Dream-Skin ↗ · 直接下载 ZIP