How to Get Claude Buddy — Complete Setup Guide

Step-by-step guide to hatching your Claude Code buddy. Requirements, commands, and tips for your terminal pet companion.

Requirements

  • Claude Code v2.1.89 or later
  • Claude Pro subscription ($20/mo)
  • Terminal environment (macOS / Linux / WSL)

Step-by-Step

1

Check your Claude Code version

Run claude --version in your terminal. Make sure it shows v2.1.89 or higher.

$ claude --version
2

Confirm Pro subscription

You need a Claude Pro subscription ($20/mo). Free accounts cannot access /buddy.

3

Type /buddy

Type /buddy in your Claude Code terminal.

$ /buddy
4

Wait for hatching

Claude will generate a unique name and personality for your buddy. This takes a few seconds.

5

Meet your buddy!

Your buddy appears! It shows as ASCII art in the terminal. Use /buddy pet to interact, or /buddy card for full details.

Tips

Your buddy is deterministic — generated from your account UUID, it never changes. To preview your result, use our online checker.

For all available interaction commands, see our commands reference. Not sure about your UUID? Check the UUID guide. Browse all possible species at the species list.

Related Pages