How to Find Your Claude Code Buddy

Claude Code's Buddy system is a hidden Tamagotchi-style terminal pet feature discovered in the leaked source code. Every Claude Code user is assigned a unique companion — a digital creature that lives in your terminal.

Your buddy is deterministically generated from your account UUID, meaning it's already decided. The same UUID will always produce the same buddy, with the same species, rarity, stats, and appearance.

The system includes 18 unique species, 5 rarity tiers (from Common at 60% to Legendary at 1%), and a rich attribute system with eyes, hats, shiny variants, and 5 personality stats.

Your buddy is generated from your accountUuid — a unique identifier tied to your Anthropic account. There are two ways to find it:

Method A: Ask Claude Code Directly

The simplest method is to open Claude Code and type:

What is my accountUuid?

Claude will respond with your UUID in the format: acde070d-8c4c-4f0d-9d8a-162843c10333

Method B: Check Your Config File

Run this command in your terminal:

cat ~/.claude.json | grep accountUuid

This reads your local Claude configuration file and extracts the UUID field.

Alternative: Use Your User ID

If you can't find your accountUuid, you can also use your userID. The buddy checker supports both formats.

Once you have your UUID, head to our Buddy Checker tool and paste it into the input field. Click "CHECK BUDDY" and the algorithm will instantly reveal your companion.

The checker runs the exact same algorithm found in Claude Code's source:

1. Your UUID is concatenated with the salt friend-2026-401
2. The combined string is hashed using the FNV-1a algorithm
3. The hash seeds a Mulberry32 PRNG (pseudo-random number generator)
4. The PRNG sequentially rolls your rarity, species, eyes, hat, shiny status, and 5 stats

Because this process is deterministic, your result will always be the same — check it now before the official launch!

Your buddy comes with several attributes that define its identity:

Species (1 of 18)

There are 18 possible species, each with unique ASCII art and personality. They range from common animals like Duck and Cat to mythical creatures like Dragon and Ghost, and even objects like Cactus and Robot. Browse the complete species guide for details.

Rarity (5 Tiers)

Tier	Chance	Stat Floor
Common	60%	5
Uncommon	25%	15
Rare	10%	25
Epic	4%	35
Legendary	1%	50

Higher rarity means higher minimum stats. A Legendary buddy has all stats starting at 50+!

Stats (5 Personality Traits)

Every buddy has 5 stats: Debugging, Patience, Chaos, Wisdom, and Snark. Each species has a "peak stat" that tends to be higher, and a "dump stat" that tends to be lower.

Cosmetics

Eyes: One of 6 eye styles (e.g., ·, °, ^, @, *, ~)

Hat: Common buddies have no hat. All other rarities get one of 8 hat options.

Shiny: A 1% chance for a sparkle effect — purely cosmetic but extremely rare.

Found your buddy? Share it with the community! Our tool generates a 1200×630 PNG share card optimized for Twitter and social media. Click the "SHARE CARD" button after checking your buddy to:

• Download the card as a PNG image
• Copy it to your clipboard
• Share directly via your device's native share menu (mobile)

Join the conversation on Twitter/X with #ClaudeBuddy and show off your companion!

When does the buddy system officially launch?

According to the leaked source code, the /buddy command is set to activate on April 1st, 2026.

Can I change my buddy?

No. Your buddy is deterministically generated from your UUID. The only way to get a different buddy is to use a different account.

Is this tool safe to use?

Yes. All computation runs entirely in your browser. Your UUID is never sent to any server. The tool is open-source and you can verify the code yourself.

What if I got a Common buddy?

Common buddies make up 60% of all buddies — you're in good company! Every species has unique charm regardless of rarity. Plus, your stats could still be impressive even at Common tier.