How to Change Your Codex Background in 2 Minutes

Ever pasted a prompt into the wrong window because the Codex and ChatGPT desktop apps look almost identical? One Codex user on GitHub described exactly that — the two dark sidebars are so alike that content keeps landing in the wrong app (issue #21841). In another thread, users ask for more built-in themes because the official options are too few (issue #11073). Community posts on daily.dev ask for the missing piece directly: let me put my own image behind my workspace.

The good news: you can change your Codex background in about two minutes. This tutorial walks through it step by step — free presets first, then your own custom image — using GptSkin, an open-source Codex Skill plus website built for exactly this job.

What Codex Offers Natively

Since March 2026, the Codex desktop app has built-in appearance settings: open Settings → Appearance to adjust colors and fonts (see the official Codex documentation). If a different color scheme or font is all you need, start there — it takes seconds.

What native settings cannot do is image backgrounds. No photos, no artwork, nothing from your own files. If you want a real background image in Codex, read on.

Before You Start

Make sure you have:

• The Codex desktop app on macOS or Windows. This tutorial does not apply to the Codex CLI or the VS Code extension — GptSkin themes the desktop app only.
• Node.js 20 or later. Verify your version with:

node -v

• For the six free presets: nothing else. No account, no sign-up.

Step 1: Install the GptSkin Skill (About 1 Minute)

The fastest path is a single sentence. Open Codex and say:

Install this skill and give Codex a new look: https://github.com/WendongAI/gptskin-skill

Codex downloads the open-source Skill and sets it up for you.

Prefer to install by hand? The manual route is three commands:

git clone https://github.com/WendongAI/gptskin-skill.git ~/.codex/skills/gptskin-theme
cd ~/.codex/skills/gptskin-theme
npm install

Then restart Codex so it picks up the new Skill. The same steps work on macOS and Windows. If anything goes wrong here, the installation guide covers the process in full detail.

Step 2: Apply a Free Preset Theme (About 30 Seconds)

Six preset themes are free for everyone, no account required. Pick one and either tell Codex:

Apply the dark-void preset theme

or run the Skill's script yourself:

node ~/.codex/skills/gptskin-theme/scripts/apply-theme.mjs --preset dark-void

The Skill applies the theme to your running Codex interface. The six presets — swap the name in the command above to try another, and click any name to preview it:

• dark-void
• sunset-glow
• aurora-borealis
• snow-peak
• city-lights
• minimal-light

Not feeling it? Apply a different preset, or skip ahead to restoring the default look below.

Step 3: Use Your Own Image as a Background (Paid)

This is where it gets personal: almost any image can become your Codex background. Custom image themes are the paid feature — each new image theme costs 20 Credits — and reapplying a theme you already built is free.

1. Register at gptskin.best. New accounts receive bonus Credits, valid for 30 days.
2. Copy your API Key from the console.
3. Save the key in the Skill:

node ~/.codex/skills/gptskin-theme/scripts/apply-theme.mjs --key YOUR_API_KEY

4. Build and apply your theme from an image file:

node ~/.codex/skills/gptskin-theme/scripts/apply-theme.mjs --image /absolute/path/theme.png "Theme Name"

Image requirements: JPEG, PNG, or WebP, up to 4 MiB. No image at hand? Ask Codex imagegen to generate one locally first, then pass that file to the same --image flow — the Skill treats both sources identically. Want inspiration before you spend Credits? Browse the showcases to see finished themes.

How to Restore the Default Theme

Changed your mind? Tell Codex:

Restore the default Codex theme

Every injection is removed and Codex returns to the stock look. The whole system is designed to be reversible with a single command, so you can experiment freely.

Troubleshooting

The first row is the most common hiccup: a Codex app update can knock out an applied theme. It takes under a minute to pull the latest Skill and reapply.

Is It Safe?

A fair question — you are letting a third-party tool touch your coding environment. Here is exactly what GptSkin does and does not do:

• No modification of the official app. The installation package, app.asar, and code signatures are never touched.
• No access to your credentials. Your Codex API Key and Base URL are never touched.
• Loopback-only connection. Themes are applied through a Chrome DevTools Protocol (CDP) launch flag that binds only to the loopback address (127.0.0.1) — it is never exposed to the network.
• No reading your conversations. The Skill never reads your Codex conversation content.
• Fully open source. Every line is auditable at github.com/WendongAI/gptskin-skill.
• Fully reversible. One command removes everything.

The security docs explain the full model. And to state it plainly: GptSkin is an independent product and is not affiliated with, endorsed by, or officially connected to OpenAI. "ChatGPT" and "Codex" are trademarks of OpenAI, used only to describe compatibility.

Frequently Asked Questions

Does GptSkin work with the Codex CLI or the VS Code extension?

No. GptSkin supports only the Codex desktop app on macOS and Windows. The Codex CLI and the VS Code extension are not supported.

Is changing the Codex background free?

Yes for the six preset themes — they are free for everyone and require no account. Custom image themes are paid: 20 Credits per new theme, and reapplying a saved theme is free. New accounts receive bonus Credits valid for 30 days.

Will GptSkin modify or break my Codex installation?

No. GptSkin never modifies app.asar, code signatures, or your API Key, and everything can be removed with one command (Restore the default Codex theme). If a Codex app update removes the theme, restore the default, run git -C ~/.codex/skills/gptskin-theme pull, and apply it again.

What image formats and sizes can I use?

JPEG, PNG, or WebP, up to 4 MiB. Use your own image, or have Codex imagegen generate one locally first — both go through the same --image flow.

Is GptSkin made by OpenAI?

No. GptSkin is an independent product with no affiliation, endorsement, or official connection to OpenAI.

Change Your Background Now

Ready? Open Codex and say Install this skill and give Codex a new look: https://github.com/WendongAI/gptskin-skill, then Apply the dark-void preset theme. Two minutes from now, you will be looking at a workspace that actually feels like yours. Questions this tutorial did not cover? Check the FAQ or the installation guide.