Free guide
Claude Code Custom Themes: Animated Backdrops and Your Own Colors
The Claude Code desktop app can now wear a theme: your own colors and an animated scene behind the chat. Here is how a theme works, two ways to get one today, and why you should treat a theme like code.
The short version
- Anthropic announced custom themes for Claude Code on desktop on November 13, 2026: change the colors and add an animated background.
- A theme is a mod. When it loads, it hands the app a color palette and a backdrop, and the Desktop app paints them. The terminal keeps its own colors and draws no backdrop.
- The quick start is the theme-examples plugin: twenty animated scenes, one per project or per session. The catch: mods aren't sandboxed, so treat a shared theme like any other code.
How it actually works
A theme is a mod
A mod is a plugin that changes how Claude Code looks and behaves, made of JavaScript or TypeScript event handlers. A theme mod calls one method, $.theme.set, with a color palette, a backdrop, or both. The Desktop app (and the mobile app, for backdrops) paints what it is given. The terminal draws no backdrop and keeps its own colors.
Think of a stage crew
Your chat is the play. One crew member swaps the colored lights (the palette for the Code tab), the other flies in the painted scenery (the animated backdrop behind the conversation). The chat stays where it is; only the stage around it changes.
One theme per session
A session has one theme at a time. When any mod calls $.theme.set, it replaces the colors and backdrop that were there before, whichever mod set them. So run one theme mod at a time.
Why it is more than a color picker
Because a theme is code, it can do more than paint. The theme-examples plugin, for example, watches for one word: when Claude says "merged", fireworks go off over the theme. The same power is why the docs warn you to install mods only from authors you trust.
How to set it up
1.Update the desktop app
Custom colors need Claude Code v2.1.324 or later in the Code tab of the Claude Desktop app, and backdrops need a Desktop version that draws a mod's backdrop. Update the app and start a new local session in the Code tab.
2.Option 1: ask Claude for a theme
In a local session in the Code tab, describe the look in your own words. Claude writes the mod with its built-in plugin-authoring skill. In default or acceptEdits mode you approve each file and choose whether to turn on hot reloading; the mod loads when the turn ends.
make a mod that makes the app cream in light mode and dark brown in dark mode3.Option 2: install Anthropic's theme-examples plugin
In the desktop app, click + next to the prompt box and choose Add plugins, or run this in a session (or claude plugin install theme-examples@claude-plugins-official in your shell).
/plugin install theme-examples@claude-plugins-official4.Pick a scene
Show the card with every theme and a preview button, list all twenty, apply one to this project, or apply one to this session only. Names include Koi Mosaic, Night Reef, Departure Board, Aurora and Vector Range.
/custom-theme /custom-theme list /custom-theme koi-mosaic /custom-theme aurora session5.Turn it off
Clear a theme with /custom-theme off (or /custom-theme off session). Turn off the automatic fireworks with /fireworks auto off. If a mod's colors stay after you turn the mod off, open Settings in the Code tab, search for code appearance and select Remove colors.
/custom-theme off /fireworks auto off
The fine print
- A mod is code that runs with your permissions. It can read and write your files, start processes, make network requests, and read environment variables and settings files, including API keys kept there. Mods aren't sandboxed.
- Install mods only from authors and marketplaces you trust. Anthropic's theme-examples plugin is Apache-2.0, and its README says it sends nothing anywhere.
- In auto and bypassPermissions modes, Claude Code can load a mod Claude wrote without asking you. Use default or acceptEdits mode if you want to approve it first.
- Themes show in the Claude Desktop app (and backdrops in the mobile app), not in the terminal: the terminal draws no backdrop and keeps its own colors. If your system asks for reduced motion, the example scenes rest on a still picture.
- Anthropic's launch video, where one prompt makes a synthwave sunset theme, is marked Illustrative and sped up. That sunset was made by asking Claude; it is not one of the plugin's twenty scenes.
FAQ
How do I change the theme in Claude Code desktop?
Ask Claude in a Code tab session to make a theme mod with the colors or scene you want, or install Anthropic's theme-examples plugin and run /custom-theme to pick one of its twenty scenes.
Do Claude Code custom themes work in the terminal?
No. Theme colors apply to the Code tab of the Claude Desktop app, and backdrops are drawn by the Desktop and mobile apps. Claude Code in the terminal keeps its own colors and draws no backdrop.
What is a Claude Code mod?
A mod is a plugin made of JavaScript or TypeScript event handlers that run inside Claude Code. It can add panes and commands, restyle parts of the interface, step into tool calls, and set a theme.
Are Claude Code themes safe to install?
A theme is a mod, and a mod runs with your permissions without a sandbox, so it can reach your files and secrets. Install themes only from authors and marketplaces you trust, and read what a mod does before you install it.
Can I use a different theme for each project?
Yes. With the theme-examples plugin, /custom-theme <name> applies a scene to the current project, and /custom-theme <name> session applies it to one session only.
Sources
- Launch post from @ClaudeDevs
- Mods overview (Claude Code docs)
- Backdrops and colors (Claude Code docs)
- Ask Claude for a mod (Claude Code docs)
- theme-examples plugin on GitHub
Facts checked 2026-11-14 against the @ClaudeDevs launch post and video, the Claude Code docs (mods overview, create, interface, desktop, Anthropic's marketplaces) and the theme-examples plugin v0.4.3 README and source.
Want help building with tools like this?
Join the Shipping Skool community free. Paid members get live bootcamp calls every week and weekly-updated courses.
Join Shipping SkoolMore free guides
How ChatGPT Wallet Pays Without Seeing Your Card (and How to Set It Up)
OpenAI's new ChatGPT Wallet lets your dot pay for things on your behalf, and neither the agent nor the store ever sees your real card number. Here's how the stand-in card works and how to set it up.
Astryx: Give Your AI Agent Meta's Design System So Every Screen Matches
Meta's open-source design system ships 150+ React components, seven themes and a CLI your coding agent reads from. What it is, how it works, how to set it up today, and the fine print.
How Google's Antigravity Orchestrator Works (and How to Turn It On)
Google's new Orchestrator runs two Gemini models in one coding session: a big one that plans and a fast one that does the work. Here's how the hand-off works and how to switch it on.