Tutoriels
Un guide détaillé pour appliquer votre première skin Codex tout en restant réversible.
Avant de commencer
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.
-
Installez un moteur une fois
Clonez ou téléchargez un moteur de skins comme Codex Dream Skin, ou utilisez un gestionnaire comme Codex Skin Manager. Une seule configuration sur votre machine.
-
Trouvez une skin dans l'index
Parcourez les catégories ou cherchez par ambiance et couleur. Ouvrez la page de la skin pour la description, les plateformes compatibles et le prompt d'installation exact.
-
Copiez et appliquez
Cliquez sur Copier sur le prompt d'installation, collez-le dans Codex Desktop ou exécutez la commande CLI. Le workspace se met à jour instantanément.
-
Vérifiez et conservez la source
Confirmez le nouveau look, puis mettez la source en favori. Si Codex se met à jour et casse une skin, relancez l'étape de restauration pour revenir à l'état d'origine.
Astuces
- Start with a featured skin — it is the most likely to apply cleanly through the engine's default preset.
- Copiez le prompt tel quel ; de petites modifications peuvent changer le résultat appliqué par le moteur.
- Gardez le lien de la source à portée pour pouvoir restaurer ou réappliquer après une mise à jour de Codex.
- Utilisez les filtres de catégorie et d'ambiance pour réduire les 100+ skins à quelques-unes qui vous plaisent.
Choisir un moteur
Le moteur décide comment les skins sont appliquées et quels formats vous pouvez utiliser. Tous sont gratuits et open source.
| Moteur | Plateformes | Style d'installation | Notes |
|---|---|---|---|
| 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. |
Dépannage
Les quatre problèmes les plus fréquents et leurs solutions.
-
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.