CCodex Skin
中文

STEP-BY-STEP CODEX SKIN GUIDE

How to install a Codex skin

Based on Fei-Away/Codex-Dream-Skin: external themes, local injection, and no changes to the official application package.

01

MACOS · APPLE SILICON / INTEL

Install a Codex skin on macOS

  1. Download the repository.Download and extract the ZIP from GitHub, or clone the repository with Git.
  2. Open the macos folder.Double-click Install Codex Dream Skin.command, or use the Terminal method below.
  3. Install to the stable local path.
    cd macos
./scripts/install-dream-skin-macos.sh --no-launch
  4. Switch to a theme.
    ~/.codex/codex-dream-skin-studio/scripts/switch-theme-macos.sh \
  --id preset-midnight-aurora
  5. Add the optional menu bar tool.Double-click Install Menu Bar.command to apply, pause, import, and switch Codex themes from the 🎨 Skin menu.
02

WINDOWS · POWERSHELL

Install a Codex skin on Windows

  1. Open PowerShell at the repository root.Keep the complete windows directory structure in place.
  2. Run the installer.
    powershell -ExecutionPolicy Bypass -File .\windows\scripts\install-dream-skin.ps1
  3. Start the tray application.
    powershell -ExecutionPolicy Bypass -File .\windows\scripts\start-dream-skin.ps1
  4. Choose a Codex theme.Open Saved Themes from the system tray and select a repository preset. Use Change Background to import your own clean image.
03

CUSTOM CODEX BACKGROUND

Prepare your own theme image

2560 × 1440Recommended 16:9 master
Left 50%–58%Keep it quiet and low contrast
Right 58%–88%Place the visual subject here
Background onlyNo UI, text, logos, or watermarks

On macOS, run customize-theme-macos.sh. On Windows, choose Change Background from the tray. Image analysis runs locally in Canvas and is not uploaded to an external service.