Tutoriais
Um tutorial mais longo para aplicar sua primeira skin Codex mantendo a possibilidade de reverter.
Antes de começar
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.
-
Instale uma engine uma vez
Clone ou baixe uma engine de skins como Codex Dream Skin, ou use um gerenciador como Codex Skin Manager. É uma configuração única na sua máquina.
-
Encontre uma skin no índice
Navegue por categorias ou busque por estilo e cor. Abra a página da skin para ver descrição, plataformas compatíveis e o prompt de instalação exato.
-
Copie e aplique
Clique em Copiar no prompt de instalação, cole no Codex Desktop ou execute o comando CLI. O workspace atualiza imediatamente.
-
Verifique e guarde a fonte
Confirme o novo visual e salve o link da fonte. Se o Codex atualizar e a skin quebrar, basta refazer o passo de restauração para voltar ao padrão.
Dicas
- Start with a featured skin — it is the most likely to apply cleanly through the engine's default preset.
- Copie o prompt exatamente; pequenas edições mudam o que a engine aplica.
- Mantenha o link da fonte à mão para restaurar ou reaplicar após uma atualização do Codex.
- Use os filtros de categoria e estilo para reduzir 100+ skins a algumas que combinam com você.
Escolhendo uma engine
A engine decide como as skins são aplicadas e quais formatos você pode usar. Todas são gratuitas e open source.
| Engine | Plataformas | Estilo de instalação | Notas |
|---|---|---|---|
| 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. |
Resolução de problemas
Os quatro problemas mais comuns e suas soluções.
-
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.