All posts

Claude Code Skins: How to Customize the Way Your Agent Looks (2026)

·Terminal Candy ·8 min read

claude codeskinscustomizationguide

Claude Code skins are how you change the way your coding agent looks — and the trick most people miss is that you don't skin Claude Code at all. You skin the terminal it runs in. Claude Code is a CLI: it lives inside whatever terminal window you launch it from, so every pixel of "how it looks" — the colors, the font, the frame around the text — belongs to the terminal, not the agent. Once that clicks, customizing Claude Code stops being a mystery and becomes a menu of choices, from a two-minute color swap to turning your entire window into a Game Boy that happens to be running an AI.

This guide walks the whole ladder: what a Claude Code skin actually is, the quick wins anyone can do in any terminal, and then the level almost nobody knows exists — wrapping the terminal in a device or character so Claude Code renders inside it.

What is a Claude Code skin?

A Claude Code skin is any visual customization applied to the terminal running Claude Code. Because the agent prints plain text and ANSI color codes to a standard terminal, three layers are yours to change:

  • The color palette — the 16 ANSI colors plus foreground and background that decide whether your session reads as Dracula purple, Solarized sepia, or Game Boy green.
  • The font — the typeface and size Claude's output is drawn in.
  • The frame — everything around the text: the window chrome, or, if you go further, an entire illustrated device the text sits inside.

Nothing here modifies Claude Code itself. Your prompts, tools, and output are identical. You're changing the surface it's painted on — which is exactly why it's safe, reversible, and as expressive as you want it to be.

Quick wins: customize Claude Code in any terminal

You can improve how Claude Code looks in about five minutes without installing anything new. These work in Terminal.app, iTerm2, Ghostty, Alacritty — whatever you've got.

1. Change the color theme

This is the single highest-impact change. A good theme makes diffs readable, tool output scannable, and long sessions easier on your eyes. Most terminals ship a theme picker in Preferences; the community-standard palettes — Solarized, Dracula, Nord, Gruvbox — are one dropdown away or a quick config paste. If you want a proper rundown of which palettes hold up over a long Claude Code session, we wrote a companion piece on the best Claude Code themes.

2. Pick a better font

Claude Code leans on box-drawing characters, spinners, and aligned columns, so a monospaced font with good glyph coverage matters. A ligature-friendly coding font (JetBrains Mono, Fira Code, Berkeley Mono) makes tool calls and code blocks noticeably cleaner. Bump the size up a notch too — you read a lot of agent output.

3. Tidy your prompt

Your shell prompt sits right above every Claude Code invocation, so a clean, informative prompt (git branch, directory, exit status) frames the session nicely. This is shell config, not Claude config, but it's part of the visual whole.

These three get you a genuinely nicer Claude Code. But they all stop at the same ceiling: you're still looking at a rectangle of text in a plain window. The next level breaks that rectangle.

The next level: turn the terminal into a device or character

Here's the part that surprises people. If the terminal is just a window drawing text, then the window can be anything. It can be a chunky retro PC with a beige bezel. A Game Boy DMG with the screen where the LCD used to be. An anime character holding a monitor, with Claude Code running on the glass she's presenting to you. A cyberdeck. A CRT in a wooden frame.

This is what Terminal Candy does. It's a native macOS terminal — real PTY, built in Swift and AppKit with SwiftTerm, not an Electron wrapper — that renders your shell inside an image. You launch Claude Code inside it exactly like any terminal, and the agent's output appears mapped onto the "screen" of whatever art you've loaded. Type claude, hit enter, and your agent is now living inside a Game Boy. It runs Codex, Gemini CLI, and aider the same way — it's a real terminal, so any CLI runs inside it.

Terminal Candy keeps it to a pure frame-behind-your-shell skin, native and light. If you want dockable widgets and audio visualizers arranged around your terminal, not just a frame behind it, its sister app MOLTamp — from the same team — is the fuller cockpit. It's an Electron skinnable shell built around a widget framework (music players, clocks, monitors, visualizers, companions) with an open marketplace for skins and widgets. Both are macOS-only today; the difference is depth, not platform: Terminal Candy is the native, lightweight skin-your-terminal option, MOLTamp is the heavier Electron cockpit for when you want widgets and companions too.

The effect is hard to convey in text and immediate the moment you see it: the same session you'd get in any terminal, except the frame around it has personality. And because it's a native app with a real PTY, it behaves like a terminal, not a novelty — no lag, no compatibility asterisks.

A couple of touches make it feel right:

  • 86 palettes ship in the box — Solarized, Dracula, Nord, Gruvbox, Game Boy DMG, C64, Synthwave '84, Vaporwave, and more — so the text color matches the frame.
  • Optional CRT effects — scanlines, glow, and screen curvature, toggleable per skin, for when a retro shell wants to look like actual glass.
  • Global hotkey — ⌥Space drops the terminal down from anywhere, and ⌘M switches back to a plain terminal when you need heads-down focus.

If you want the deeper comparison of why a native app matters for agent work, we put Terminal Candy in context in best terminal for Claude Code.

How to make your own Claude Code skin

The best part is that a skin isn't a mysterious binary — it's just two files in a folder:

  • One PNG — the device or character art.
  • One skin.json — which defines where the terminal "screen" renders inside the image (a simple rectangle, or a perspective quad if the screen is at an angle) plus the color palette.

Drop that folder in and it loads live — no restart. That means you can iterate on a skin while Claude Code keeps running behind it.

You don't have to hand-edit JSON, though. Terminal Candy ships a built-in Skin Builder that does the fiddly parts for you:

  1. Bring any image — a screenshot, a render, a photo of an actual Game Boy.
  2. Magic-wand background removal — click the background to knock it out so the device floats cleanly.
  3. Draw the screen — drag a rectangle over the area where you want Claude Code's text to appear. That becomes the live terminal surface.
  4. Pick a palette — choose from the 86 built-ins so the text matches your art.
  5. Watch it load live — the skin appears immediately, running your real shell.

That's the whole workflow. From "I have a cool image" to "Claude Code is running inside it" is a few minutes, and nothing about your agent setup changes.

Share it with the community

Once you've built a skin worth showing off, the skin gallery is where it goes. You can browse, download, like, and comment on what other people have made, sorted into categories like anime, cyberdeck, retro, device, and frame. Found one you like? One click and Claude Code is wearing it. Made one yourself? Upload it and it's live for everyone.

NSFW skins are opt-in — blurred by default and gated behind sign-in — so the default browse stays safe to scroll at your desk.

There's also a small, honest incentive: publish 10 unique and new skins and Terminal Candy refunds your $10 (subject to approval). The gallery is genuinely the fun part — it's where a private customization tool turns into a shared one.

FAQ

Can you actually skin Claude Code?

Yes — by skinning the terminal it runs in. Claude Code is a command-line tool that prints text and colors to your terminal, so every visual choice (palette, font, and the frame around the window) is controlled by the terminal, not the agent. Change the terminal and you change how Claude Code looks. Terminal Candy takes this the furthest by rendering that terminal inside a device or character, but it never modifies Claude Code itself.

Do skins slow Claude Code down?

No. A skin is a static image plus a color palette — it's a rendering choice, not a process that sits between you and the agent. Terminal Candy is a native macOS app running a real PTY, so your Claude Code session performs like it would in any terminal. The art is just what's drawn around the text.

Are Claude Code skins free?

The color-and-font quick wins are free in any terminal. Terminal Candy is a free download with a 14-day trial, after which it stays free with 5 skin slots. A one-time $10 unlocks unlimited skins and community membership — lifetime, no subscription — and if you publish 10 unique, new skins to the gallery, that $10 gets refunded.


Ready to see your agent in a new outfit? Browse the skin gallery for inspiration, make your own in the Skin Builder, or just download Terminal Candy and watch Claude Code move into a Game Boy.

Keep reading