Claude Code Has a Hidden Virtual Pet System: Customize Your Legendary Shiny Dragon in 5 Minutes

Introduction

“Wait — Claude Code has a virtual pet hidden inside the terminal?”

Recently, Anthropic’s Claude Code source code was accidentally leaked, and 510,000 lines of code were thoroughly scrutinized by the community. What they found was a complete virtual pet system codenamed “BUDDY” — and it blew up in the tech world. Anthropic leaned into it and officially launched the feature in version 2.1.89. Type /buddy, and the system generates a unique pet based on your user ID hash — a companion that stays with you while you write code, debug, and pull late-night deployments.

But here’s the catch: your pet is entirely determined by the hash. Whether you get a dragon or a duck is pure luck.

Legendary drops at only 1%, Shiny at 1% too. A ✨ Shiny Legendary Dragon? The combined probability is 0.01% — worse than gacha.

Thankfully, the open-source community stepped in. Developer fengshao1227 created cc-buddy, a tool that lets you customize everything about your pet with a single command — species, rarity, hat, stats, all under your control.

This article walks you through installation to full customization in 5 minutes.

1. What is Claude Code Buddy?

On April 1, 2026, Anthropic launched a hidden virtual pet system inside the Claude Code CLI. Type /buddy in your terminal, and a unique pet companion hatches just for you.

It’s not just decoration — the pet appears next to your terminal input, occasionally popping up hearts, yawns, and reactions, keeping you company through every late-night debug session.

The pet attribute system includes:

18 species: From common ducks and cats, to epic dragons and octopuses, to the legendary Nebulynx
5 rarity tiers: Common → Uncommon → Rare → Epic → Legendary
6 eye styles: · ✦ × ◉ @ °
8 hats: Crown, top hat, propeller hat, halo, wizard hat, and more
Shiny: A 1% chance special variant that sparkles
5 RPG stats: DEBUGGING, PATIENCE, CHAOS, WISDOM, SNARK

But all of this was originally determined by your UserID hash. You get what you get — want something different? Better hope a fresh install rolls better.

Until cc-buddy came along.

2. One-Command Install

cc-buddy is a Node.js tool. No global install needed — just run it with npx.

Prerequisites:

Node.js installed (v18+ recommended)
Claude Code installed globally via npm (npm i -g @anthropic-ai/claude-code)

Run:

npx cc-buddy

You’ll see an interactive menu like this:

🎰 Claude Buddy Pet Recaster v2.3.0
Runtime: Node.js (wyhash fallback) | Hash: FNV-1a (npm install)

What would you like to do?

  [1] 🔍  Search Pet
  [2] 👀  View Current Pet
  [3] ✏️   Custom Name/Personality
  [4] 🔓  Full Customization (patch cli.js)
  [5] 📋  Species Encyclopedia
  [6] 🧪  Self-check Hash
  [7] 🌐  Switch Language
  [8] 👋  Exit

Straightforward. Let’s walk through it step by step.

3. View Your Current Pet

Select [2] View Current Pet to see what the system generated for you:

🔍 Current Pet:

🐉 DRAGON
★★★★★ legendary ✨ SHINY!
Eyes: ×  |  Hat: 👑 crown

DEBUGGING  ████████████████████ 100
PATIENCE   ███████████░░░░░░░░░ 54
CHAOS      ██████████░░░░░░░░░░ 49
WISDOM     ███████████░░░░░░░░░ 57
SNARK      ███████████████░░░░░ 77

If you’re lucky, you might already have a Legendary Dragon. Most people end up with a common Pebblecrab or Mossfrog.

Want to customize? Next step.

4. Full Pet Customization (Core Feature)

This is cc-buddy’s most powerful feature — option [4] Full Customization (patch cli.js).

It modifies Claude Code’s cli.js so your custom configuration overrides the default hash-derived values.

Step 1: Confirm Patch

⚠ Only supports npm global install (npm i -g @anthropic-ai/claude-code).
Not compatible with native binary install (cli.anthropic.com).

Confirm patch? [Y/n]: y

Type y to confirm. cc-buddy automatically backs up the original file (cli.js.original), so you can restore anytime.

Step 2: Unlock Bubble Reactions

Unlock pet bubble reactions? (Required for users with telemetry disabled) [y/N]: y
✓ Bubble reactions unlocked!

Users with telemetry disabled must apply this patch, or the pet won’t show reactions.

Step 3: Unlock /buddy Command

Enable /buddy for third-party API users? [y/N]: y
✓ /buddy unlocked for all users!

If you’re using Bedrock, Vertex, or a custom API endpoint, this step enables /buddy for you too.

Step 4: Choose Species

Species (Enter to keep current):

  [1] 🦆  duck      [7] 🦉  owl       [13] 🦫  capybara
  [2] 🪿  goose     [8] 🐧  penguin   [14] 🌵  cactus
  [3] 🫧  blob      [9] 🐢  turtle    [15] 🤖  robot
  [4] 🐱  cat       [10] 🐌  snail    [16] 🐰  rabbit
  [5] 🐉  dragon    [11] 👻  ghost    [17] 🍄  mushroom
  [6] 🐙  octopus   [12] 🦎  axolotl  [18] 🐈  chonk

18 species to choose from. Want a dragon? Pick [5]. Want a giant chubby cat? Go for [18] chonk.

Step 5: Choose Rarity

  [1] ★ common       [4] ★★★★ epic
  [2] ★★ uncommon    [5] ★★★★★ legendary
  [3] ★★★ rare

No-brainer — pick [5] for Legendary.

Step 6: Choose Eyes and Hat

Eyes: [1] ·  [2] ✦  [3] ×  [4] ◉  [5] @  [6] °
Hat:  [1] —  [2] 👑  [3] 🎩  [4] 🧢  [5] 😇  [6] 🧙  [7] ⛑  [8] 🐤

Pick your combo. Bright eyes ✦ + Crown 👑 is a classic.

Step 7: Set Shiny and Stats

Shiny? [y/N]: y
DEBUGGING [?]: 100
PATIENCE  [?]: 100
CHAOS     [?]: 100
WISDOM    [?]: 100
SNARK     [?]: 100

Max everything — all five stats at 100. Build the ultimate hexagonal warrior.

Step 8: Name and Personality

✏️ Give it a name: fish
✏️ Write a personality description: A highly disciplined coding agent focused on execution

Give it a name with personality and a motto to match.

Final Confirmation

✓ Custom pet written! Restart Claude Code → /buddy

{"rarity":"legendary","eyes":"✦","hat":"crown","shiny":true,
 "stats":{"DEBUGGING":100,"PATIENCE":100,"CHAOS":100,"WISDOM":100,"SNARK":100},
 "name":"fish"}

Restart Claude Code, type /buddy, and your custom pet appears.

5. FAQ

Q: How to restore after patching?

cc-buddy automatically creates a backup cli.js.original. Restore with one command:

cp /Users/gfish/.nvm/versions/node/v24.13.1/lib/node_modules/@anthropic-ai/claude-code/cli.js.original /Users/gfish/.nvm/versions/node/v24.13.1/lib/node_modules/@anthropic-ai/claude-code/cli.js

Q: Does it work with native binary installs?

No. cc-buddy’s patch feature only supports npm global installs. If you installed from cli.anthropic.com, switch to npm first.

Q: Will the pet affect Claude Code functionality?

Not at all. The Buddy system is an independent frontend display layer — it doesn’t affect code generation, conversations, tool calls, or any core features.

Q: Will it break after Claude Code updates?

npm updates to Claude Code will overwrite cli.js, so you’ll need to re-run npx cc-buddy. The good news is cc-buddy remembers your configuration, so re-patching is quick.

6. Summary

Claude Code’s Buddy system is a delightful surprise from Anthropic — a virtual pet in your cold terminal that adds warmth to your coding sessions.

And cc-buddy takes this surprise to the next level:

18 species to choose from — dragons, ghosts, mushrooms… whatever you want
5 rarity tiers — Legendary is no longer a dream
Shiny effects, eyes, hats, stats — fully customizable
Third-party API support — unlock /buddy for all users
One-click restore — revert to original anytime

One command npx cc-buddy, 5 minutes done. Give your Claude Code the coolest companion possible.

References

cc-buddy Open Source Project (by fengshao1227): https://github.com/fengshao1227/cc-buddy

Original Post on Linux.do: https://linux.do/t/topic/1874318

Claude Code Buddy Complete Guide (18 Species + 5 Rarity Tiers): https://help.apiyi.com/claude-code-buddy-terminal-pet-companion-activation-guide.html

ClaudeFa.st Buddy Mechanics Deep Dive: https://claudefa.st/blog/guide/mechanics/claude-buddy