Skip to content
Nilay Kabariya

← All 81 Claude Code themes · Ports · Unofficial, not affiliated with Anthropic

Catppuccin Mocha (port) Claude Code theme

The Catppuccin Mocha palette mapped onto every Claude Code colour.

Ports · Soft · Calm · Dark · base: dark · updated 14 November 2026

A Claude Code theme changes colours only. The picture shows the idea behind the palette; it does not appear in your terminal.

Preview · mock terminal in these colours

The picture shows the idea of the theme; in the terminal a theme changes colours, nothing more. Both the picture and the preview are drawn from this theme's colours, not screenshots of the CLI.

Install the Catppuccin Mocha (port) theme in Claude Code

The themes folder may not exist yet, and a first-time install needs one restart of Claude Code. Then run /theme and pick Catppuccin Mocha (port).

macOS / Linux / Git Bash:

mkdir -p ~/.claude/themes && curl -o ~/.claude/themes/catppuccin-mocha-port.json https://nilaykabariya.blog/claude-code-themes/catppuccin-mocha-port.json

PowerShell:

New-Item -ItemType Directory -Force "$HOME\.claude\themes" | Out-Null; Invoke-WebRequest https://nilaykabariya.blog/claude-code-themes/catppuccin-mocha-port.json -OutFile "$HOME\.claude\themes\catppuccin-mocha-port.json"
How Copy install command works
1. Click it: it copies one line of text. Nothing is installed yet.
2. Paste it in a terminal (macOS, Linux, Git Bash) and press Enter: it saves catppuccin-mocha-port.json into ~/.claude/themes/. On Windows PowerShell use the PowerShell line above.
3. Open Claude Code, type /theme, pick Catppuccin Mocha (port). First custom theme? Restart Claude Code once.
Download catppuccin-mocha-port.jsonRead the file

Credit and licence

This is a community port, not made or endorsed by Catppuccin. The colours are the Catppuccin palette (palette source), mapped onto Claude Code's colour tokens by me. No Catppuccin logo is used.

Licence: MIT, read in the project's own repository on 2026-11-14 (repo, LICENSE). It reads: "Copyright (c) 2021 Catppuccin" and "Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files, to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software", subject to keeping the copyright and permission notice.

What was checked

  • ✓ Appears in the /theme picker on Claude Code 2.1.325 (Windows).
  • ✓ Only tokens from the official list (24 set), only #rrggbb colours.
  • ✓ Text contrast 11.3:1; the lowest readable colour (accent, status and mode colours) 7.1:1 against the design background #1e1e2e.
  • ✓ Text on the added and removed diff lines: 6.1:1.
  • ✓ Success, error and warning are distinct (colour distance 33); added and removed line backgrounds differ (23).
  • Not claimed: colour-blind safety (the same simulation gives distance 5; only "Safe Signals" is built for it).
  • Not checked: a screenshot of this palette in a live session.

Every colour in Catppuccin Mocha (port)

claude #cba6f7
claudeShimmer #ccb7f6
text #cdd6f4
inactive #81859d
subtle #606479
suggestion #89b4fa
permission #fab387
success #a6e3a1
error #f38ba8
warning #f9e2af
promptBorder #63547e
planMode #94e2d5
autoAccept #f5c2e7
bashBorder #fab387
diffAdded #3f4d4a
diffRemoved #553a4e
diffAddedDimmed #30383d
diffRemovedDimmed #3c2d3f
diffAddedWord #628068
diffRemovedWord #8d576d
userMessageBackground #2a2b3c
selectionBg #52476a
rate_limit_fill #cba6f7
rate_limit_empty #333446

The Catppuccin Mocha (port) theme file, in full

{
  "name": "Catppuccin Mocha (port)",
  "base": "dark",
  "overrides": {
    "claude": "#cba6f7",
    "claudeShimmer": "#ccb7f6",
    "text": "#cdd6f4",
    "inactive": "#81859d",
    "subtle": "#606479",
    "suggestion": "#89b4fa",
    "permission": "#fab387",
    "success": "#a6e3a1",
    "error": "#f38ba8",
    "warning": "#f9e2af",
    "promptBorder": "#63547e",
    "planMode": "#94e2d5",
    "autoAccept": "#f5c2e7",
    "bashBorder": "#fab387",
    "diffAdded": "#3f4d4a",
    "diffRemoved": "#553a4e",
    "diffAddedDimmed": "#30383d",
    "diffRemovedDimmed": "#3c2d3f",
    "diffAddedWord": "#628068",
    "diffRemovedWord": "#8d576d",
    "userMessageBackground": "#2a2b3c",
    "selectionBg": "#52476a",
    "rate_limit_fill": "#cba6f7",
    "rate_limit_empty": "#333446"
  }
}

Questions about Catppuccin Mocha (port)

How do I install the Catppuccin Mocha (port) theme in Claude Code?

Save catppuccin-mocha-port.json in ~/.claude/themes/ (on Windows C:\Users\<you>\.claude\themes), for example with: mkdir -p ~/.claude/themes && curl -o ~/.claude/themes/catppuccin-mocha-port.json https://nilaykabariya.blog/claude-code-themes/catppuccin-mocha-port.json . Then run /theme in Claude Code and pick Catppuccin Mocha (port). If the themes folder did not exist before, restart Claude Code once.

Is Catppuccin Mocha (port) a dark or a light Claude Code theme?

Catppuccin Mocha (port) is a dark theme (mood: soft, calm, dark). Its body text has 11.3:1 contrast against the background it was designed for, and its lowest readable colour has 7.1:1.

Related Claude Code themes

Source, validator and all the themes on GitHub

tip: paste the exact error text