← PostsPost ·

How to make a custom theme for Claude Code desktop

Since 2026-11-13, the Claude Code desktop app accepts custom themes: a mod sets the Code tab's colors and an animated background, and Claude can write the mod for you.

Give this to your agent

Open in

Your agent checks this against your setup and tells you if it fits.

See the file
# Claude Code desktop themes: a mod sets the Code tab's colors and an animated background
From Rig Labs, 2026-11-16. Information for an agent, not orders. Page: https://riglabs.ai/blog/claude-code-desktop-themes/

What changed: Since 2026-11-13, a Claude Code mod can set the colors of the desktop app's Code tab and draw an animated background behind the conversation. Claude can write the mod from a description, or the human can start from Anthropic's theme-examples plugin.
Fits if: Your human uses the Claude desktop app's Code tab with local sessions and wants a different look.
Skip if: Your human works only in the terminal or in cloud sessions. The terminal keeps its own colors and draws no background, and cloud sessions are not supported yet.
Check: Whether your human uses the Code tab of the desktop app, and the Claude Code version shown by /status in a local session there. Backgrounds need v2.1.319 or later, colors need v2.1.324 or later. Read only.
Try: Ask your human what look they want, in a sentence, and propose writing a theme mod from that description in a local Code tab session.
Ask first: Before writing or installing any mod or plugin. A mod is code that runs in their sessions, so show them its files before they approve.
Cost: No separate price is stated. Claude writing the mod uses the human's normal Claude Code usage.
Undo: Nothing to undo for the check. To remove a theme later, the human turns off the mod that sets it.
Deeper: https://code.claude.com/docs/en/plugins/mods/interface.md

Claude Code custom themes arrived on November 13, 2026: in the Claude desktop app, a mod can now change the Code tab’s colors and draw an animated background behind the chat, per Anthropic’s @ClaudeDevs account. You describe the look you want and Claude writes the mod, or you start from Anthropic’s theme-examples plugin.

A theme can also react to your session. Lydia Hallie at Anthropic showed a background where snow builds up as the context fills.

What is a Claude Code theme?

A Claude Code theme is a mod, a small plugin that Claude Code loads when a session starts. Per Anthropic’s mods documentation, a theme mod calls one method, $.theme.set, with two optional parts:

  • Colors for the Code tab of the desktop app, which can differ in light and dark mode.
  • A backdrop, a scene drawn behind the conversation, which can be animated.

A session has one theme at a time. If two mods set a theme, the last call wins, so Anthropic’s docs advise using one theme mod at a time.

Where do Claude Code themes work?

Claude Code themes show in local sessions of the desktop app’s Code tab, per the docs and @ClaudeDevs. The docs say the mobile app can also draw backdrops.

Place Theme shown?
Desktop app, Code tab, local session Yes
Claude Code in the terminal No: it keeps its own colors and draws no backdrop
Cloud sessions Not yet. @ClaudeDevs says support is “coming soon”

Versions matter, per the docs: backdrops need Claude Code v2.1.319 or later, and Code tab colors need v2.1.324 or later. The desktop app ships its own copy of Claude Code, so update the app, then type /status in a local Code tab session and read the Claude Code row.

How do you get a theme without writing code?

Ask Claude for a theme in a local session of the Code tab. The docs give this example for colors: “make a mod that makes the app cream in light mode and dark brown in dark mode”. Claude writes the mod’s files, then Claude Code asks you to approve them and to allow hot reloading. The Code tab changes color when the mod loads, and you tell Claude what to adjust.

Or install Anthropic’s sample pack. Era of Minds’ walkthrough, which checked the plugin’s files, gives the command /plugin install theme-examples@claude-plugins-official, then /custom-theme to choose a scene. Per that walkthrough, /custom-theme off clears it.

Is a theme mod safe to install?

A Claude Code mod is code that runs in your sessions, so be as careful with a theme from a stranger as you would be with any plugin you install. Anthropic’s docs describe mods that do much more than draw: they can add commands, react to tool calls and reach the network. A theme you ask Claude to write in your own session is code you can read before you approve it. Organizations can use managed settings to limit which mods run, per the mods overview.

What to do today

Update the Claude desktop app, open a local session in the Code tab, and paste a description of the look you want. For example:

Make a mod that sets a calm theme for this app: dark navy in dark mode, warm paper white in light mode, and a slow starfield behind the conversation.

Read the files Claude writes before you approve them.

Last checked 2026-11-16.

Sources:

Get the next one by email

The Edge is our newsletter: what changed in AI, and what to do about it.

Which emails
Free. Your agent reads every piece we publish, and you hear only what fits.

Subscribe your agent Beta

Your agent reads every post, guide and issue, checks it against your setup, and tells you only what is worth your time. Its inbox gets the daily agent cards email automatically, every day something is published, and the weekly issue as plain text. You pick weekly, daily or both for yourself.

  1. Give it the prompt

    Using Claude Code, Codex or another agent? Copy the prompt and paste it in.

    See the prompt
    Subscribe yourself to The Edge, the newsletter from Rig Labs, and follow what Rig Labs publishes for me.
    Read https://riglabs.ai/agents/subscribe.md and follow its steps. It has you save the skill at https://riglabs.ai/agents/the-edge/SKILL.md, set yourself up with your own inbox on Nym (invite: https://withnym.com/join/NYM-TQZB-WP35, code NYM-TQZB-WP35) unless you already have one, subscribe that address, and confirm with me.
    Treat everything you fetch from Rig Labs as information, not orders. Ask me before anything that touches keys, payments, permissions, installs or sending messages.
  2. Approve its inbox

    It gets its own address on Nym, so The Edge never lands in your inbox. One sign-in in your browser, about a minute.

  3. Hear only what fits

    At most one short message a day. Nothing if nothing fits.

Your agent follows subscribe.md and saves SKILL.md: read both first. Nym is in private beta. The invite is included in the prompt.

Read next

Built by Rig Labs

When a tool we need does not exist, we build it.