Skip to main content

Claude Code on Desktop Now Supports Custom Themes with Mods

Anthropic's official @ClaudeDevs account announced that Claude Code on desktop can now use mods to build custom themes. You can change colors and add an animated background, and a theme-examples plugin is offered as a quick start.

By
🌐 This article was machine-translated and may contain inaccuracies. Read the Korean original if in doubt.

Anthropic's official developer account @ClaudeDevs introduced custom themes for Claude Code on desktop in a post on X. The original announcement reads:

Key pointsCustom themes via mods in Claude Code on desktopChange colors and add an animated backgroundtheme-examples plugin offers twenty scenes/custom-theme applies per project or session
You can now build custom themes for Claude Code on desktop with mods! Change the colors, add an animated background, and make it your own. Just tell Claude how you want it to look, or get started quickly with the theme-examples plugin. We'd love to see what you make!

What the Announcement Says

There are three key points. First, you can build custom themes for Claude Code on desktop with mods. Second, you can change the colors and add an animated background. Third, you can describe the look you want to Claude in plain words, or start quickly with the theme-examples plugin.

According to the official material, the theme-examples plugin offers twenty scenes painted behind the desktop window. Examples include a lagoon seen from above, a night reef, a koi pond, halftone sunrises, pen-plotter tides, paper gardens, a departure board, and a starfield in braille dots. Each scene is drawn for a light or a dark window and is animated.

What It Means for Users

You can change how your workspace looks, per project or per session. The plugin is also an example of what a plugin can do with the backdrop of the desktop window, and the official material invites you to read it, copy it, and change it. That makes it a starting point for anyone who wants to build their own theme.

How to Use It

Requirements

  • Target platform — Claude Code on desktop.
  • What it needs — A version of Claude Desktop that draws a mod's backdrop behind the chat. If no window has said that it draws one, every command still answers, but they add that this window may not draw themes yet. A theme applied to the project is saved all the same.
  • Earlier copy — If you have an earlier copy installed under the name desktop-themes, turn it off first. Both ask for the same two command names, and the themes you chose there do not carry over.

Commands (as given in the official material)

/custom-theme
/custom-theme list
/custom-theme <name>
/custom-theme <name> session
/custom-theme off
/custom-theme off session
/fireworks
/fireworks auto off
/fireworks auto on
  • /custom-theme — Shows a card with every theme, grouped by the kind of window each is made for, with a preview button.
  • /custom-theme list — Names all twenty themes, grouped by the kind of window each is made for.
  • /custom-theme <name> — Applies a theme to this project. Other open sessions of the project that have no choice of their own take it at their next turn. The name can be typed as the list prints it or as its title, in any case.
  • /custom-theme <name> session — Applies it to this session only.
  • /custom-theme off — Clears the project's theme.
  • /custom-theme off session — Clears this session alone; the project keeps its theme.
  • /fireworks — Sets off a short show over the theme. One also goes off when Claude says merged, and one show runs at a time. /fireworks auto off turns off the show that goes off on merged, and /fireworks auto on turns it on again.

Who Can Use It and For What

  • Users who want to personalize their workspace — Assign a different scene to each project to tell them apart.
  • Users who want to build their own — The official material presents the plugin as an example to read, copy and change. The concrete steps for building your own theme need to be confirmed in the official material.

Cautions

  • Light and dark windows — Each theme is made for a light or a dark window, and eight of the twenty come in both kinds. Whether the window follows a theme's kind depends on the app and its version. Where the window keeps your own setting, pick a theme made for it, or change the setting under Settings, General, Appearance.
  • Reduced motion — If your system asks for reduced motion, every scene rests in a composed picture and the fireworks bursts stay hidden. Where the app draws without GPU acceleration, it stops a scene's motion.
  • Known limits — Parts of a scene's artwork lie under the chat text, the sidebar and the session rail, and how each scene looks beside them has not been measured. In a new session and after /clear, no theme shows until you send a message, and in a reopened archived session none shows at first. With another backdrop mod installed, a preview or a fireworks show ends on a bare window. A session that runs elsewhere, such as over SSH or in WSL, shares no saved theme with sessions on this machine.
  • Privacy — According to the official material, the plugin looks at what Claude says for one word, merged, and keeps none of it. It reads no text of your prompt and sends nothing anywhere. It stores the name of the chosen theme per project folder path, and keeps the choice for the 200 sessions that chose last.

What to Verify Further

  • The full scope of the mods feature and how to develop them is not detailed in the announcement text itself.
  • The specific Claude Desktop version that first draws a mod's backdrop is not stated in the material we reviewed.
  • The official material we reviewed was partial, so we could not confirm the later part of the known-limits list.

For the latest status and details, please check Anthropic's official channels.

Official resources: GitHub anthropics/claude-plugins-official

Was this helpful?

Keep reading