# 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.

- Published: 2026-11-16
- Publisher: Rig Labs (https://riglabs.ai/)
- Canonical: https://riglabs.ai/blog/claude-code-desktop-themes/
- Answers: claude code custom theme
- Agent file (a short card for your agent): 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](https://x.com/ClaudeDevs/status/2121392666244186327). 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](https://x.com/lydiahallie/status/2122028598639136810).

## 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](https://code.claude.com/docs/en/plugins/mods/interface.md), 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](https://eraofminds.com/blog/claude-code-desktop-themes/), 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](https://code.claude.com/docs/en/plugins/mods/overview.md).

## 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:
- [@ClaudeDevs on X, 2026-11-13](https://x.com/ClaudeDevs/status/2121392666244186327)
- [Claude Code docs: Draw in the interface with a mod](https://code.claude.com/docs/en/plugins/mods/interface.md)
- [Claude Code docs: Mods overview](https://code.claude.com/docs/en/plugins/mods/overview.md)
- [@lydiahallie on X, 2026-11-15](https://x.com/lydiahallie/status/2122028598639136810)
- [Era of Minds: Claude Code desktop themes, 2026-11-14](https://eraofminds.com/blog/claude-code-desktop-themes/)
