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.

By Beau Johnson·

Quick answer

Custom themes in the Claude Code desktop app are mods: small plugins written in JavaScript or TypeScript that set the Code tab's colors and an animated backdrop behind the conversation. You can describe a look and have Claude write the mod for you, or install Anthropic's theme-examples plugin and pick one of its twenty scenes with /custom-theme. A mod runs with your permissions, so only install themes from people you trust.

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. 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. 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 mode
  3. 3.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-official
  4. 4.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 session
  5. 5.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

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 Skool

More free guides