안녕하세요 트윅히입니다.
오늘은 클로드 코드의 귀여운 업데이트가 나와서 소개해 드리려구요!!
바로 버디라는 건데욥💕
히히 제 버디는 아래의 친구입니다. :)
1. Claude Code 버디가 뭔가요?
Claude Code를 쓰다 보면 어느 순간 /buddy 명령어를 입력했을 때 귀여운 동물 친구가 나타나는 걸 발견하게 됩니다.
이게 바로 버디(Buddy) 시스템인데요, 클로드 코드와 함께하는 나만의 마스코트 같은 존재예요.
버디는 저의 정보를 바탕으로 설정되는 거라 버디를 뽑고 결정이 되면 정상적인 방법으로는 바꿀 수 없습니다.
등급도 있고 희귀도도 있어서... 가챠 게임의 향기가 솔솔 나죠?
그래서 당연히 누군가 리세마라 도구를 만들었습니다. 개발자 커뮤니티는 역시 빠르네요. 😂
(이것도 이따가 알아볼게욥)
/buddy 명령어가 안될 수도 있는데 그럴때 클로드 코드 업데이트를 해주셔야 합니다.
claude update
🚨 클코를 Homebrew로 설치하셨다면 먼저 읽어주세요
맥에서 Homebrew로 Claude Code를 설치하신 분들은 주의가 필요해요.
현재 Homebrew 버전은 최신 버전으로 업데이트가 안 되는 문제가 있어서, 버디 시스템이 제대로 동작하지 않을 수 있습니다.
이럴 땐 Homebrew 버전을 제거하고 네이티브 설치로 다시 진행해야 해요.
기존 Homebrew 버전 제거
brew uninstall --cask claude-code
네이티브 설치
curl -fsSL https://claude.ai/install.sh | bash
이렇게 하면 claude 명령어를 직접 사용할 수 있게 됩니다.
2. 버디 등급 시스템
버디에는 희귀도(Rarity) 등급이 존재합니다. 확률은 아래와 같아요.
레벨 등급 확률
| 1 | Common (일반) | 60% |
| 2 | Uncommon (비일반) | 25% |
| 3 | Rare (레어) | 10% |
| 4 | Epic (에픽) | 4% |
| 5 | Legendary (레전더리) | 1% |
그리고 여기에 Shiny(빛나는) 속성이 독립적으로 1% 확률로 붙을 수 있어요.
레전더리 + 샤이니 드래곤이라면... 그야말로 SSR 중의 SSR이죠. ✨
3. 버디 소환 & 쓰다듬기
설치가 완료됐다면 Claude Code를 실행하고 아래 명령어를 입력해보세요.
버디 소환
/buddy
명령어를 입력하면 나만의 버디가 등장합니다!
처음 보는 순간 두근두근하죠. 근데 Common이 나왔다면... 리세마라를 고려해볼 시간입니다.
근데 저는 그냥 저만의 버디인 기분이라 그냥 쓰는 것도 좋은 것 같아요!!
버디 쓰다듬기
하트가 뿅뿅 뜨는데.. 빨라서 캡쳐가 어렵군요
/buddy pet
버디를 쓰다듬을 수 있어요. 작고 소중한 기능이지만 귀엽습니다 🐾
5. 리세마라 방법 — buddy-gacha 도구 사용하기
바로 본론입니다. buddy-gacha 는 ~/.claude.json에 저장된 userID 값을 바꿔서 새 버디를 뽑을 수 있게 해주는 CLI 도구예요.
아래는 레포입니다.!
https://github.com/gadzan/buddy-gacha
GitHub - gadzan/buddy-gacha: A small CLI for rolling a new Claude Code buddy profile by generating candidate `userID` values and
A small CLI for rolling a new Claude Code buddy profile by generating candidate `userID` values and writing the chosen one into `~/.claude.json`. - gadzan/buddy-gacha
github.com
원리는 간단합니다.
버디는 userID를 기반으로 결정되는 구조라서, userID를 바꾸면 버디도 바뀌는 거죠.
일종의 합법적인(?) 치트키라 할 수 있습니다.
실행 방법
별도 설치 없이 npx로 바로 실행할 수 있어요.
npx buddy-gacha
맥에서 bun 오류가 난다면?
실행 중에 bun이 없다는 오류가 뜨는 경우가 있는데요, 아래 명령어로 먼저 bun을 설치하면 해결됩니다.
curl -fsSL https://bun.sh/install | bash
설치 후 다시 npx buddy-gacha를 실행하면 정상적으로 동작해요.
6. 주의사항
리세마라 전에 꼭 알아두셔야 할 점들이 있어요.
- 버디를 바꾼 후에는 Claude Code를 완전히 재시작해야 적용됩니다.
- OAuth 로그인을 사용하고 있다면 accountUuid에서 버디가 결정되기 때문에 userID를 바꿔도 효과가 없을 수 있어요.
vi ~/.claude.json
/accountUuid 검색하셔서 이 부분을 삭제
:wq로 저장
7. 고급 가챠 옵션
기본 실행 외에도 다양한 옵션을 활용하면 원하는 버디를 좀 더 효율적으로 뽑을 수 있어요.
도움말 보기
npx buddy-gacha --help
후보 수 늘려서 인터랙티브 모드 실행
기본보다 더 많은 후보 중에서 고를 수 있어요.
npx buddy-gacha --count 50
특정 등급 정확히 맞춰서 자동 뽑기
레어 5 (레전더리)를 정확하게 뽑고 싶다면:
npx buddy-gacha --rare 5
특정 등급 이상 자동 뽑기
레어 4 (에픽) 이상이면 OK라면:
npx buddy-gacha --rare 4 --min-rare
샤이니 드래곤 자동 뽑기
진정한 덕력을 보여주고 싶다면...
npx buddy-gacha --rare 5 --shiny --species dragon --max-attempts 100000
# 에러 나면 --max-attempts 이 숫자 더 높이면 됨.레전더리 샤이니 드래곤. 확률은 0.01%지만, 시도는 해볼 수 있잖아요? 😅
선택하라고 할 때 하나 선택해 주고 클로드 재실행 후 /buddy 다시 해주면 리세마라 끝!!
눈 모양도 잘 보고 선택해주세요 *-*
--species에 dragon뿐 아니라 여러가지 응용을 하실 수 있습니다. octopus..penguin 등
다 하고 나면 귀여운 버디를 만날 수 있습니다.
++ 클로드 코드 2.1.97 버전에서 버디가 사라졌어요
아래 글 참조 부탁드려요ㅠㅠㅠㅠ
https://twoweekhee.tistory.com/62
🚨 Claude Code 버디 기능 삭제!! -- 다시 불러오는 법!!
v2.1.97버전에서 버디가 삭제되었습니다.만우절 기간에 나온 거라 신규 패치가 나오면서 기능이 삭제 된 것 같아요ㅠㅠ 미친.. 이럴 수가그래서 미친 듯이 다시 찾아봤습니다. 다시 버디 불러오는
twoweekhee.tistory.com
'🤖 신기술 & 트렌드' 카테고리의 다른 글
| 🚨 Claude Code 버디 기능 삭제!!😱 -- 다시 불러오는 법!! (0) | 2026.04.09 |
|---|---|
| 👻 Ghostty + tmux로 완성하는 나만의 터미널 환경 (0) | 2026.03.31 |
| 🔌 Claude Code /plugin 완벽 가이드 — 클코 플러그인 추천! (++BKIT) (0) | 2026.03.24 |
| 🧠 Claude Code가 내 코드베이스를 이해하게 만드는 법 — Serena MCP 완전 정복 (2) | 2026.03.17 |
| 🤖 Claude Code Agent Teams : 팀? 서브에이전트? 스킬? (++ 팀 시각화) (1) | 2026.03.03 |