[ CLAUDE BUDDY GUIDE ]

all buddies rendered as live ascii animations

[ QUICK START · CLAUDE CODE ]

Install Claude Code globally, then run it in your repo — Buddy shows up in the terminal experience.

npm install -g @anthropic-ai/claude-code

claude-buddy-guide — zsh — 120x40

DUCK // COMMON#01

hat: none

    __      
  <(✦ )___  
   (  ._>   
    `--´

eye

hat

rarity

shiny

DEBUGGING32

PATIENCE6

CHAOS76

WISDOM12

SNARK21

A little duck named Crumb trails your cursor and blurts fast, cheerful takes. Friendly, curious, and slightly chaotic.

X(Twitter)Linkedin Reddit

GOOSE // UNCOMMON#02

hat: none

     (✦>    
     ||     
   _(__)_   
    ^^^^

eye

hat

rarity

shiny

DEBUGGING18

PATIENCE69

CHAOS21

WISDOM52

SNARK19

A tall goose keeps watch over your prompt with suspicious confidence. Precise notes, mild judgment, good instincts.

X(Twitter)Linkedin Reddit

BLOB // COMMON#03

hat: none

   .----.   
  ( ✦  ✦ )  
  (      )  
   `----´

eye

hat

rarity

shiny

DEBUGGING17

PATIENCE1

CHAOS19

WISDOM20

SNARK57

Blob oozes beside your input and keeps morale stable. Soft tone, low ego, surprising patience under pressure.

X(Twitter)Linkedin Reddit

CAT // RARE SHINY#04

hat: tophat

   [___]    
   /\-/\    
  ( ×   ×)  
  (  ω  )   
  (")_(")

eye

hat

rarity

shiny

DEBUGGING27

PATIENCE98

CHAOS34

WISDOM31

SNARK46

A sharp cat sits like it owns the terminal. Excellent debugging instincts, dramatic side-eye, and premium snark.

X(Twitter)Linkedin Reddit

DRAGON // EPIC#05

hat: none

            
  /^\  /^\  
 <  ◉  ◉  > 
 (   ~~   ) 
  `-vvvv-´

eye

hat

rarity

shiny

DEBUGGING61

PATIENCE57

CHAOS99

WISDOM31

SNARK58

Dragon carries big merge energy: bold ideas, loud confidence, and occasional fire-breathing refactor proposals.

X(Twitter)Linkedin Reddit

OCTOPUS // UNCOMMON#06

hat: none

            
   .----.   
  ( ✦  ✦ )  
  (______)  
  /\/\/\/\

eye

hat

rarity

shiny

DEBUGGING17

PATIENCE87

CHAOS43

WISDOM7

SNARK42

Octopus multitasks like a tiny team of eight. Balanced stats, quick context switching, and reliable calm.

X(Twitter)Linkedin Reddit

OWL // RARE#07

hat: halo

   (   )    
   /\  /\   
  ((◉)(◉))  
  (  ><  )  
   `----´

eye

hat

rarity

shiny

DEBUGGING28

PATIENCE90

CHAOS25

WISDOM54

SNARK46

Owl prefers clean architecture and measured replies. High wisdom, high patience, low chaos, steady guidance.

X(Twitter)Linkedin Reddit

PENGUIN // COMMON#08

hat: none

  .---.     
  (@>@)     
 /(   )\    
  `---´     
   ~ ~

eye

hat

rarity

shiny

DEBUGGING80

PATIENCE19

CHAOS1

WISDOM30

SNARK26

Penguin is a humble companion with strong focus stamina. It keeps your pace stable during long coding sessions.

X(Twitter)Linkedin Reddit

TURTLE // UNCOMMON#09

hat: none

   _,--._   
  ( ·  · )  
 /[______]\ 
  ``    ``

eye

hat

rarity

shiny

DEBUGGING39

PATIENCE35

CHAOS86

WISDOM19

SNARK29

Turtle ships slowly but rarely breaks production. Extreme patience and resilient habits beat panic every time.

X(Twitter)Linkedin Reddit

SNAIL // COMMON#10

hat: none

 @    .--.  
  \  ( @ )  
   \_`--´   
  ~~~~~~~

eye

hat

rarity

shiny

DEBUGGING43

PATIENCE28

CHAOS69

WISDOM5

SNARK15

Snail is slow, calm, and impossible to tilt. Great for careful reviews, migrations, and deliberate debugging.

X(Twitter)Linkedin Reddit

GHOST // RARE SHINY#11

hat: halo

   (   )    
   .----.   
  / ×  × \  
  |      |  
  ~`~``~`~

eye

hat

rarity

shiny

DEBUGGING55

PATIENCE100

CHAOS43

WISDOM31

SNARK61

Ghost drifts near your command line and whispers chaotic truths. Great at finding hidden edge cases and sass.

X(Twitter)Linkedin Reddit

AXOLOTL // UNCOMMON#12

hat: none

}~(______)~{
}~(◉ .. ◉)~{
  (  --  )  
  ~_/  \_~

eye

hat

rarity

shiny

DEBUGGING18

PATIENCE86

CHAOS44

WISDOM6

SNARK29

Axolotl stays relaxed under pressure and gives practical hints. Solid all-rounder with gentle humor.

X(Twitter)Linkedin Reddit

CAPYBARA // LEGENDARY SHINY#13

hat: crown

   \^^^/    
  n______n  
 ( ·    · ) 
 (   oo   ) 
  `------´

eye

hat

rarity

shiny

DEBUGGING85

PATIENCE83

CHAOS57

WISDOM57

SNARK100

Capybara is pure serenity in terminal form. Legendary patience, supportive tone, and reliable high wisdom.

X(Twitter)Linkedin Reddit

CACTUS // RARE#14

hat: none

            
 n  ____  n 
 | |◉  ◉| | 
 |_|    |_| 
   |    |

eye

hat

rarity

shiny

DEBUGGING51

PATIENCE24

CHAOS90

WISDOM57

SNARK33

Cactus gives concise replies and tolerates rough environments. Prickly but dependable when deadlines hit hard.

X(Twitter)Linkedin Reddit

ROBOT // EPIC#15

hat: propeller

    -+-     
   .[||].   
  [ ·  · ]  
  [ ==== ]  
  `------´

eye

hat

rarity

shiny

DEBUGGING43

PATIENCE38

CHAOS50

WISDOM28

SNARK100

Robot logs everything, optimizes quickly, and spots broken assumptions. High debugging power, medium snark.

X(Twitter)Linkedin Reddit

RABBIT // UNCOMMON#16

hat: tinyduck

    ,>      
   (\__/)   
  ( ·  · )  
 =( .  . )= 
  (")__(")

eye

hat

rarity

shiny

DEBUGGING48

PATIENCE45

CHAOS14

WISDOM43

SNARK92

Rabbit brings quick jumps of ideas and playful chaos. Good for brainstorming and prototype momentum.

X(Twitter)Linkedin Reddit

MUSHROOM // COMMON#17

hat: none

            
 .-o-OO-o-. 
(__________)
   |°  °|   
   |____|

eye

hat

rarity

shiny

DEBUGGING44

PATIENCE72

CHAOS3

WISDOM16

SNARK11

Mushroom is grounded and quietly supportive. It grows better answers in slow, thoughtful iterations.

X(Twitter)Linkedin Reddit

CHONK // UNCOMMON SHINY#18

hat: beanie

   (___)    
  /\    /\  
 ( @    @ ) 
 (   ..   ) 
  `------´

eye

hat

rarity

shiny

DEBUGGING29

PATIENCE97

CHAOS39

WISDOM51

SNARK19

Chonk is loud, adorable, and gloriously extra. Great for energy boosts, memes, and chaotic confidence.

X(Twitter)Linkedin Reddit

all companions are visible at once. no slideshow switching. each buddy runs its own ascii frame cycle at 500ms tick.

# WHAT_IS_CLAUDE_BUDDY

Claude Buddy is a lightweight companion layer in Claude Code. Claude Buddy uses terminal-friendly ASCII rendering, deterministic rarity and stats, and playful interaction that stays out of the way of serious coding tasks.

# HOW_TO_USE_BUDDY

$ 1. Open Claude Code in your project.
$ 2. Type /Buddy to hatch your Claude Buddy.
$ 3. Customize rarity, eye, hat, and shiny for your Claude Buddy.
$ 4. Click your Claude Buddy for touch hearts and animation feedback.
$ 5. Share or export your Claude Buddy card image.

# FAQ

$ What is Claude Buddy in Claude Code?: Claude Buddy is a tamagotchi-style companion in Claude Code. Claude Buddy lives next to the input box and adds personality, species, and stats without replacing your main workflow.
$ How do I activate Buddy mode?: Type /Buddy in Claude Code to activate Claude Buddy. The Claude Buddy system initializes species, rarity, eye style, hat style, shiny flag, and five core stats.
$ Do Buddy stats change over time?: Yes. Claude Buddy stats react to interactions and rerolls. The Claude Buddy gallery demonstrates deterministic stat generation with rarity floors and seeded randomness.
$ How many species are available?: Claude Buddy currently includes 18 species: duck, goose, blob, cat, dragon, octopus, owl, penguin, turtle, snail, ghost, axolotl, capybara, cactus, robot, rabbit, mushroom, and chonk.
$ How does Claude Buddy generate rarity and stats?: Claude Buddy uses weighted rarity rolls (common/uncommon/rare/epic/legendary), then applies stat floors by rarity and a deterministic PRNG. This keeps Claude Buddy reproducible per seed.
$ Can I customize eye, hat, rarity, and shiny options?: Yes. In this Claude Buddy guide, each card supports eye variants, hat variants, rarity selection, and shiny toggle. Different Claude Buddy combinations produce different visual and stat outcomes.
$ Can I share or export my Claude Buddy card?: Yes. Every Claude Buddy card includes social share links and a terminal-style image export. You can save your Claude Buddy with ASCII sprite and all stat parameters.
$ Is Claude Buddy deterministic or random?: Claude Buddy is deterministic per seed for core generation. In this guide, Claude Buddy uses weighted rarity and seeded stat rolls so the same setup can be reproduced.
$ What makes Claude Buddy different from a normal chatbot?: Claude Buddy is not a second full assistant thread. Instead, Claude Buddy behaves like a companion layer with lightweight reactions, species identity, and collectible style.
$ Does Claude Buddy support rarity, eyes, hats, and shiny traits together?: Yes. Claude Buddy supports combined trait generation: rarity tier, eye variant, hat variant, shiny flag, and five stat values. This is why each Claude Buddy can look and feel different.