Como importar um tema personalizado no app de desktop do Codex
Um checklist ciente de versões para importar um tema nativo do Codex, verificar a legibilidade e restaurar a aparência anterior.
Resposta rápida
Abra as Configurações do Codex, vá em Aparência, use o controle de importação de tema personalizado, cole a string de compartilhamento completa codex-theme-v1:, revise a visualização e aplique. O rótulo exato do controle pode mudar entre builds do app.
Estas etapas foram revisadas com o Codex App 26.707.72221 no macOS em 17 de julho de 2026.
Antes de importar
Confirme que o item é um tema nativo, e não um instalador externo de Skin. Uma string de tema nativo é apenas um dado de aparência. Ela não deve pedir que você execute comandos de shell, ative uma porta de depuração ou baixe um executável.
Verifique a fonte, a data de verificação, a plataforma testada e o build do Codex na página do tema. Anote o nome do seu tema integrado atual para ter um ponto de retorno simples.
Importar e verificar
- Abra uma página de tema publicada no catálogo de temas.
- Use Copiar tema na página do tema para copiar a string de compartilhamento.
- No Codex, abra Configurações > Aparência.
- Cole a string de compartilhamento completa no campo de importação.
- Não corte nem edite o prefixo ou o payload JSON.
- Revise a variante clara ou escura antes de aplicar.
Depois de aplicar, inspecione títulos, texto corrido, rótulos esmaecidos, botões, estados selecionados, adições de diff, remoções de diff, skills e código em bloco. Reinicie o app e verifique se o tema persiste.
Falhas comuns
Um erro de string inválida geralmente significa que o prefixo ou o JSON foi alterado. Uma incompatibilidade de variante significa que a string de compartilhamento e o destino de importação claro/escuro ativo são diferentes. Uma incompatibilidade de tema de código significa que a família de realce referenciada não está disponível naquela versão do app. Uma falha da área de transferência pode ser contornada selecionando a string retornada e copiando-a manualmente.
Se o resultado ficar ilegível, escolha imediatamente um tema integrado do Codex. Mudanças nativas de aparência não exigem um script externo de limpeza. Para uma solução de problemas mais ampla, leia como redefinir ou remover um tema.