So importierst du ein eigenes Theme in der Codex-Desktop-App
Eine versionsbewusste Checkliste zum Importieren eines nativen Codex-Themes, zum Prüfen der Lesbarkeit und zum Wiederherstellen der vorherigen Darstellung.
Kurze Antwort
Öffne die Codex-Einstellungen, gehe zu Darstellung, nutze das Steuerelement zum Importieren eigener Themes, füge den vollständigen codex-theme-v1:-Share-String ein, prüfe die Vorschau und wende ihn an. Die genaue Bezeichnung des Steuerelements kann sich zwischen App-Builds ändern.
Diese Schritte wurden am 17. Juli 2026 mit der Codex-App 26.707.72221 auf macOS geprüft.
Vor dem Import
Vergewissere dich, dass es sich um ein natives Theme handelt, nicht um einen externen Skin-Installer. Ein nativer Theme-String sind reine Darstellungsdaten. Er sollte dich nicht auffordern, Shell-Befehle auszuführen, einen Debugging-Port zu aktivieren oder eine ausführbare Datei herunterzuladen.
Prüfe Quelle, Prüfdatum, getestete Plattform und Codex-Build auf der Theme-Seite. Notiere den Namen deines aktuellen integrierten Themes, damit du einen einfachen Rückkehrpunkt hast.
Importieren und prüfen
- Öffne eine veröffentlichte Theme-Seite im Theme-Katalog.
- Nutze Theme kopieren auf der Theme-Seite, um den Share-String zu kopieren.
- Öffne in Codex Einstellungen > Darstellung.
- Füge den vollständigen Share-String in das Importfeld ein.
- Kürze oder bearbeite weder das Präfix noch die JSON-Nutzlast.
- Prüfe die helle oder dunkle Variante vor dem Anwenden.
Prüfe nach dem Anwenden Überschriften, Fließtext, dezente Beschriftungen, Buttons, ausgewählte Zustände, Diff-Hinzufügungen, Diff-Entfernungen, Skills und Codeblöcke. Starte die App neu und vergewissere dich, dass das Theme erhalten bleibt.
Häufige Fehler
Ein Fehler wegen eines ungültigen Strings bedeutet meist, dass Präfix oder JSON verändert wurden. Eine nicht passende Variante bedeutet, dass Share-String und aktives Hell-/Dunkel-Importziel auseinanderlaufen. Eine nicht passende Code-Theme-Angabe bedeutet, dass die referenzierte Highlighting-Familie in dieser App-Version nicht verfügbar ist. Ein Zwischenablagefehler lässt sich umgehen, indem du den zurückgegebenen String markierst und manuell kopierst.
Wenn das Ergebnis unlesbar ist, wähle sofort ein integriertes Codex-Theme. Native Darstellungsänderungen erfordern kein externes Bereinigungsskript. Für weitergehende Fehlersuche lies wie du ein Theme zurücksetzt oder entfernst.