Tutorial
Una guida più lunga per applicare la tua prima skin Codex mantenendola reversibile.
Prima di iniziare
Skins style Codex at the visual layer only, over <code class="font-mono text-fg-2">127.0.0.1</code>. No app files are modified and your API key is never touched.
-
Installa un motore una volta
Clona o scarica un motore di skin come Codex Dream Skin, oppure usa un manager come Codex Skin Manager. È una configurazione una tantum sulla tua macchina.
-
Trova una skin nell'indice
Esplora le categorie o cerca per mood e colore. Apri la pagina della skin per descrizione, piattaforme compatibili e il prompt di installazione esatto.
-
Copia e applica
Clicca Copia sul prompt di installazione, incollalo in Codex Desktop o esegui il comando CLI. Il workspace si aggiorna immediatamente.
-
Verifica e conserva la sorgente
Conferma il nuovo look, poi aggiungi ai segnalibri il link alla sorgente. Se Codex si aggiorna e una skin si rompe, ripeti il passaggio di ripristino per tornare all'originale.
Suggerimenti
- Start with a featured skin — it is the most likely to apply cleanly through the engine's default preset.
- Copia il prompt esatto; piccole modifiche possono cambiare ciò che il motore applica.
- Tieni a portata il link alla sorgente per ripristinare o riapplicare dopo un aggiornamento di Codex.
- Usa i filtri di categoria e mood per ridurre 100+ skin a poche che si adattano al tuo gusto.
Scelta del motore
Il motore decide come vengono applicate le skin e quali formati puoi usare. Tutti sono gratuiti e open source.
| Motore | Piattaforme | Stile di installazione | Note |
|---|---|---|---|
| Codex Dream Skin | macOS, Windows | Agent prompt / preset | Core open-source engine; local CDP injection, no app modification. |
| Codex Skin Manager | macOS, Windows | Built-in manager | 14 built-in themes plus a theme creator and Codex Skill. |
| Codex Themes (desktop) | macOS | .codextheme import | Gallery and creator center at theme.codexguide.ai. |
| ReTheme | macOS, Windows | Signed themes | Tauri-based; signed, updatable, community themes. |
| Codex Themes CLI | Cross-platform | CLI /theme | Validate, preview, apply, rollback, export palettes. |
| Codepilot | Cross-platform | Built-in TUI /skin | Codex CLI distribution with 16 built-in TUI skins. |
Risoluzione problemi
I quattro problemi più comuni e le relative soluzioni.
-
Prompt applies but nothing visibly changes
Confirm the engine is running and pointed at the right Codex window. Restart Codex Desktop, then re-apply.
-
Skin looks different from the preview
Previews approximate the source palette. Check the source link for the exact theme file and version.
-
Codex updated and the skin stopped working
Use the engine's restore-to-default option, then re-apply. Keeping the source link makes this a two-minute fix.
-
CLI /theme says no themes installed
Run the port install script first, then reopen the CLI prompt. Some ports cache colors at startup.
Need the short version? See the install guide, the FAQ, or the full install blog post.