RSS
News

Claude Code mods can now recolor the desktop app's Code tab

A Claude Code mod can now set the colors of the Claude desktop app's Code tab, on Claude Code 2.1.324 or later. Here is how to get one, what stays the same in the terminal, and how to take the colors off again.

Orange and black checkered illustration for recoloring the Claude desktop app's Code tab with mods
Photo by Mika Baumeister on Unsplash

Anthropic's mods documentation now covers changing the colors of the Code tab in the Claude desktop app. A mod calls $.theme.set with a set of colors, and the Code tab repaints when the mod loads. It needs Claude Code 2.1.324 or later inside the Code tab.

That version check is easy to get wrong. The desktop app ships its own copy of Claude Code, so the number that matters is the one /status shows in a local Code tab session, not what claude --version prints in your terminal. The terminal itself is untouched: Claude Code there keeps its own colors, so a colors mod only changes the desktop app.

Two ways to get a colors mod

  • Ask for one. In a local Code tab session, describe the palette in plain words. The docs' example is: make a mod that makes the app cream in light mode and dark brown in dark mode. Claude writes the files with its built-in plugin-authoring skill, and you adjust colors by telling it what to change.
  • Write one. The plugin-authoring skill carries a helper called makeColors that builds a full theme from a few hex colors. The docs' example mod copies it into the mod's hooks folder and calls $.theme.set with the result when a session starts.

The same call can also put a backdrop behind the conversation in the desktop and mobile apps; the terminal draws none. $.theme.set and $.theme.clear arrived in Claude Code 2.1.319 and replaced the older $.ui.backdrop method, which that version removed. Older backdrop mods need to move to the new set and clear calls, and from 2.1.323 some backdrop fields were renamed too, so check the docs for the version you target.

Try it with your AI. In a local session in the desktop app's Code tab, paste this and fill in your colors:

Make a Claude Code mod that sets the colors of this desktop app's Code tab. First run
/status and tell me the Claude Code version; stop if it is older than 2.1.324.

Colors I want: [describe them, for example: cream background in light mode, dark brown
in dark mode, muted green accents].

- Use the makeColors helper from your plugin-authoring skill to build both the light and
  the dark theme, and set them in a single $.theme.set call when a session starts.
- Check the problems list makeColors returns and fix anything the desktop app won't
  paint.
- Don't set a backdrop, and don't touch anything except colors.
- When it is done, tell me the mod's folder, how to turn it off, and how to remove the
  colors afterwards.

One theme per session

Only one theme applies at a time. When any mod calls $.theme.set or $.theme.clear, the colors and backdrop from an earlier call disappear, whichever mod set them. If you run two theme mods, the last one to call wins. The docs recommend using one theme-setting mod at a time and passing colors and backdrop in the same call.

When the colors don't show, or won't leave

  • The app can refuse a palette. makeColors returns a list of problems, and an entry that starts with "Desktop won't paint this theme" means the colors were rejected and need fixing.
  • If you use a third-party model provider instead of a Claude account on Claude Desktop v5.11492.5 or earlier, the Code tab keeps its own colors.
  • To remove the colors, turn the mod off first, because a mod that is still on can set them again, then start a new local session in the Code tab. If the colors are still there, open Settings from the Code tab, search for code appearance, open the result and choose Remove colors.

One thing has not changed: a colors mod is still a mod. It runs inside Claude Code with your permissions, the same as a mod that draws panes or rewrites tool calls. A palette is easy to describe in one sentence, so asking Claude to write your own is a lower-risk way to get one than installing a stranger's theme.

Source: Draw in the interface with a mod (Claude Code docs), Mods overview (Claude Code docs)

This story first appeared in the claudefox daily briefing for November 14, 2026.