Claude Code Buddy

Claude Code v2.1.88+ 에 추가된 터미널 동반자 시스템

커서 인텔리제이에서도 pet을 쓰는 나는 참을 수가 없었습니다 🍄

---

Buddy란?

Buddy는 Claude Code에 내장된 다마고치 스타일의 가상 반려동물 시스템!!
터미널 입력창 옆에 ASCII 아트 캐릭터가 말풍선과 함께 상주하며, 대화를 지켜보다가 때때로 혼잣말을 합니다 🍄
캐릭터는 계정 UUID 기반으로 결정론적으로 배정된다 — 직접 고를 수 없고, 계정마다 고정된 버디가.. 있는 것 같아요 🐦 (가챠인 것 같기도 하고 🐛)

---

어떤 버전부터 되나?

버전	상태
v2.1.88 이전	미지원
v2.1.88+	코드 탑재 완료 (현재 v2.1.89)
2026년 4월 1–7일	테이저 공개 기간 (지금!)
2026년 5월	전체 공개 예정

claude --version   # 현재 버전 확인

클로드 코드 들어갔을 때 해당 버전 이상인지 확인할 것! 아니면 펫을 못 본다 🍄

---

18종의 종족 (Species)

duck     goose    blob     cat      dragon   octopus
owl      penguin  turtle   snail    ghost    axolotl
capybara cactus   robot    rabbit   mushroom chonk

저는 머쉬룸이에요 🍄 처음엔 정이 안 갔는데 나름 귀여운 것 같아요

---

희귀도 시스템

등급	확률	특징
Common	60%	기본
Uncommon	25%	모자 지급
Rare	10%	모자 + 높은 스탯
Epic	4%	모자 + 더 높은 스탯
Legendary	1%	최고 스탯
✨ Shiny	1% (독립 확률)	희귀도와 무관하게 추가 적용

Shiny Legendary의 확률 = 0.01%

---

스탯 5종

스탯	설명
DEBUGGING	버그를 얼마나 잘 잡는지
PATIENCE	얼마나 참을성 있는지
CHAOS	혼돈 에너지
WISDOM	지혜
SNARK	빈정거림 수준

---

외형 커스터마이징

• 눈 스타일: 6종
• 모자 타입: 7종 (crown, tophat, propeller, halo, wizard, beanie, tinyduck)
• 모자는 Uncommon 이상에서만 지급됨

---

사용 방법

기본 명령어

/buddy         # 버디 활성화 / 첫 부화
/buddy pet     # 버디 쓰다듬기 (하트 애니메이션)
/buddy mute    # 버디 숨기기

처음 실행 시

/buddy를 처음 입력하면 부화(hatch) 이벤트가 발생합니다.

• ASCII 스프라이트 애니메이션
• 떠오르는 하트 이펙트
• Claude가 이름과 성격 설명(soul description)을 생성

이름과 성격은 한 번 생성되면 계정에 영구적으로 고정된다고 ... 하는데 🐛

---

한 번 부화하면 계속 가지고 있어야 하나?

그렇다. 버디는 계정 UUID에 묶인 결정론적 시스템이래요.

항목	동작 방식
종족/희귀도/스탯	계정 UUID에서 고정 결정 — 재설정 불가
이름 & 성격	첫 부화 시 Claude가 생성, 이후 고정
/buddy mute	숨길 수는 있지만 버디 자체는 사라지지 않음
재설치/업데이트	버디 정보 유지됨 (서버 측 계정 연동)

요약: 다시 뽑을 수 없다. 운명처럼 정해진 버디와 계속 함께 간다.

아니 희귀도는 다시 뽑게 해줘라 !

---

참고

• 이 기능은 npm 패키지 소스맵을 통해 유출된 v2.1.88 소스코드에서 발견... 🍳
• 공식 문서에는 아직 미등재 상태고, 추후에 바뀔 수도 있을 것 같습니다용 🍄
• 터미널에서 움직이고, 쓰다듬어주면 하트 뿌리는 게 좀 귀엽습니닼ㅋㅋㅋ
• 클로드 코드 사용하시는 분들은 한 번씩 해보시는 것도 재밌을 것 같아유