To customize the OpenAI Codex desktop app, first use Settings → Appearance for native colors and fonts. If you want an actual image background, install an image-theme tool such as GptSkin and start with a free preset. These are separate from Codex CLI themes, which affect terminal syntax highlighting rather than the desktop workspace.
Choose the Right Kind of Customization
| What you want | Best route | Account needed? |
|---|---|---|
| Different colors or fonts | Codex Settings → Appearance | No extra account |
| A background image | GptSkin free preset | No |
| A theme from your own image | GptSkin custom image theme | Yes |
| CLI syntax colors | Codex CLI /theme | No |
OpenAI's own support response describes desktop customization as the options under Settings → Appearance, including theme and UI/code fonts. Start there because it is native, fast, and officially supported. Use a third-party route only when native settings do not cover the effect you want.
Step 1: Try Native Appearance Settings
- Open the Codex desktop app.
- Open Settings and select Appearance.
- Choose a base theme and adjust the available colors and fonts.
- Open a real project and check body text, code, muted labels, buttons, and the composer.
Native settings are the right answer for most solid-color setups. They do not provide a photo or artwork behind the workspace.
Step 2: Add an Image Theme
For an image-backed workspace, open Codex and send:
Install this skill and give Codex a new look: https://github.com/WendongAI/gptskin-skillYou need the Codex desktop app on Windows or macOS and Node.js 20+. Then try a free preset:
Apply the dark-void preset themeThe six presets require no GptSkin account. Compare them in our best Codex themes review, or jump to the best dark Codex themes.
Step 3: Create a Theme from Your Own Image
Attach a JPEG, PNG, or WebP image that you own and ask:
Use GptSkin to turn this image into a Daily Codex theme and apply it.“Daily” prioritizes readable text and restrained decoration. For a launch image or demo, ask for a “Showcase” result instead. The complete workflow is in how to create a Codex theme from any image.
Step 4: Test Readability
Do not judge a theme from its wallpaper alone. Test it with a long thread, an active composer, code blocks, selected navigation, warnings, and both focused and unfocused windows. Text should remain readable without relying on the image being darkened until it disappears.
Restore the Default Look
Tell Codex:
Restore the default Codex themeGptSkin removes its injected styles and decorative layers. It does not patch the official app package or app.asar. Read the security architecture for the exact boundary and disclosed loopback risk.
Windows, macOS, and CLI Are Different
Use the Windows installation guide or macOS installation guide for platform-specific checks. If you meant the terminal product, use our Codex CLI themes vs desktop themes guide; GptSkin supports the desktop app, not the CLI or VS Code extension.
FAQ
Can I customize Codex without installing anything?
Yes. Use Settings → Appearance for the native options. Install a third-party tool only for effects such as image backgrounds that the native controls do not provide.
Is there a free Codex desktop theme?
Yes. GptSkin includes six free presets with no account. Custom themes made from a new image use Credits.
Is GptSkin made by OpenAI?
No. GptSkin is independent and is not affiliated with, endorsed by, or sponsored by OpenAI.
