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
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
https://riglabs.ai/blog/claude-code-desktop-themes/AGENT.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.
Read next
Built by Rig Labs
When a tool we need does not exist, we build it.




