Claude Code Buddy Cosmetics Guide — Hats, Eyes & Shiny Effects

Your Claude Code Buddy isn't just defined by its 5 personality stats or rarity tier. Every buddy also has a unique cosmetic combination — a set of visual traits that make it truly one-of-a-kind in your terminal.

The cosmetic system has three independent layers:

Layer	Options	Selection Method
Eyes	6 styles	Uniform random (1/6 each)
Hats	8 types	Rarity-gated + uniform random
Shiny	On/Off	1% flat chance

Each layer is rolled independently using the Mulberry32 PRNG seeded from your UUID + salt hash. This means your cosmetics are deterministic — the same UUID always produces the same look.

Eyes are the first thing you notice on a buddy's ASCII face. There are exactly 6 eye characters, each giving your buddy a distinct personality:

Eye	Character	Vibe	Probability
·	Middle Dot	Sleepy, calm, zen — your buddy is at peace with the codebase	16.67%
✦	Four-pointed Star	Sparkly, excited, starry-eyed — sees magic in every function	16.67%
×	Multiplication Sign	Dead, dizzy, overwhelmed — has seen too many segfaults	16.67%
◉	Bullseye	Focused, intense, laser-locked — debugging with precision	16.67%
@	At Sign	Digital, matrix-like, hacker — lives in the terminal	16.67%
°	Degree Sign	Surprised, wide-eyed, curious — everything is new and exciting	16.67%

The selection is perfectly uniform: pick(rng, EYES) gives each eye an equal 1/6 ≈ 16.67% chance. No eye is rarer than another — it's pure aesthetic luck.

Fun fact: The × (dead eyes) combined with a Ghost species creates the most thematically consistent buddy. Meanwhile, ✦ (sparkly eyes) on a Dragon gives it a surprisingly cute look despite its fearsome ASCII art.

Hats are the most rarity-gated cosmetic in the system. Here's the critical rule:

Common buddies (60% of all buddies) NEVER get a hat. Only Uncommon and above can wear headgear.

The code is explicit: hat = rarity === 'common' ? 'none' : pick(rng, HATS). If you're Common, you're hatless. Period.

For non-Common buddies, the hat is selected uniformly from all 8 options (including 'none'):

Hat	ASCII Preview	Description	P (if non-Common)	P (overall)
None	(empty)	No hat — clean look	12.5%	65.0%
Crown	^^^/	Royal crown — for the king/queen of your terminal	12.5%	5.0%
Top Hat	[___]	Gentleman's top hat — classy and distinguished	12.5%	5.0%
Propeller	-+-	Propeller beanie — playful and childlike	12.5%	5.0%
Halo	( )	Angel's halo — pure and innocent	12.5%	5.0%
Wizard	/^	Wizard hat — mystical and wise	12.5%	5.0%
Beanie	(___)	Cozy beanie — casual and comfortable	12.5%	5.0%
Tiny Duck	,>	A tiny duck sitting on your buddy's head — the meme pick	12.5%	5.0%

The overall probability of having any specific hat is only 5% (40% chance of being non-Common × 12.5% chance of that specific hat). This makes hatted buddies a genuine status symbol.

Best hat combos by species:

• Crown + Dragon — The undisputed king of terminal pets
• Wizard + Owl — Maximum wisdom energy
• Tiny Duck + Duck — Duck-ception! A duck with a duck on its head
• Halo + Ghost — An angelic spirit watching over your code
• Top Hat + Cat — Fancy feline with impeccable taste
• Propeller + Chonk — Adorably ridiculous

The shiny effect is the rarest cosmetic trait in the entire buddy system. With a flat 1% probability (rng() < 0.01), shiny buddies are the equivalent of shiny Pokémon — identical in function but visually special.

Key facts about shiny buddies:

• Rarity-independent: Shiny rolls happen after rarity selection. A Common buddy can be shiny, and a Legendary can be non-shiny.
• Visual indicator: Shiny buddies display a special sparkle marker (✨) in their terminal display, making them instantly recognizable.
• Bragging rights: Only ~1 in 100 buddies will be shiny. If yours is, you're in an exclusive club.

The probability math:

Combination	Probability	Odds
Shiny (any rarity)	1.00%	1 in 100
Shiny + Uncommon or above	0.40%	1 in 250
Shiny + Rare or above	0.15%	1 in 667
Shiny + Epic	0.04%	1 in 2,500
Shiny + Legendary	0.01%	1 in 10,000

A Shiny Legendary buddy is a 1-in-10,000 event. If you have one, screenshot it immediately — it's the terminal equivalent of finding a four-leaf clover inside a winning lottery ticket.

Here's the exact sequence from the rollBuddy function that determines your buddy's appearance:

export function rollBuddy(userId: string): BuddyResult {
  const rng = mulberry32(hashString(userId + SALT));
  const rarity  = rollRarity(rng);           // Step 1
  const species = pick(rng, SPECIES);         // Step 2
  const eye     = pick(rng, EYES);            // Step 3
  const hat     = rarity === 'common'         // Step 4
                  ? 'none'
                  : pick(rng, HATS);
  const shiny   = rng() < 0.01;              // Step 5
  const stats   = rollStats(rng, rarity);     // Step 6
  return { rarity, species, eye, hat, shiny, stats };
}COPY

The order matters because each rng() call advances the PRNG state. The sequence is: rarity → species → eye → hat → shiny → stats. This means changing any earlier roll would cascade and change all subsequent rolls.

Why does order matter? The Mulberry32 PRNG is a deterministic sequence. Call #1 always returns the same value for a given seed. So your eye style is always determined by the 3rd+ RNG call (after rarity consumed 1+ calls and species consumed 1 call). This is why the same UUID always produces the exact same buddy.

Let's calculate the probability of some dream combinations:

Dream Buddy	Requirements	Probability	Odds
Crowned King	Legendary + Crown + any	0.0125%	1 in 8,000
Sparkle Dragon	Dragon + ✦ eyes + any hat	0.926%	1 in 108
Shiny Wizard Owl	Shiny + Owl + Wizard hat + any rarity	0.000347%	1 in 288,000
Matrix Robot	Robot + @ eyes + any	0.926%	1 in 108
Ultimate Duck	Shiny + Legendary + Duck + Tiny Duck hat + ✦ eyes	0.0000012%	1 in 86,400,000

The Ultimate Duck — a Shiny Legendary Duck with a Tiny Duck hat and sparkly eyes — has odds of roughly 1 in 86.4 million. To put that in perspective, you're about 3× more likely to be struck by lightning in a given year.

Probability breakdown for the Ultimate Duck:

P(Legendary)  = 1/100   = 0.01
P(Duck)       = 1/18    ≈ 0.0556
P(✦ eyes)     = 1/6     ≈ 0.1667
P(Tiny Duck)  = 1/8     = 0.125
P(Shiny)      = 1/100   = 0.01

P(all) = 0.01 × 0.0556 × 0.1667 × 0.125 × 0.01
       ≈ 0.00000001157
       ≈ 1 in 86,400,000COPY

Ready to see what cosmetic combination fate assigned you? Head to the Buddy Checker and enter your UUID. Your buddy's eye style, hat (if any), and shiny status will be displayed alongside its species, rarity, and stats.

Already know your buddy? Visit the Species Encyclopedia to see how your buddy's ASCII art looks with different eye and hat combinations. Check the Stats Deep Dive to understand your personality attributes, or browse the Species Rankings to see where your companion stands.

Share your cosmetic combo on Twitter/X with #ClaudeBuddy — especially if you rolled a shiny or a rare hat. The community loves celebrating unique finds!