공개 노트

Claude Code /buddy 기능 완전 분석 - 터미널 펫 컴패니언 시스템

2026-04-02Views 2,878약 5분

Summary

개요

/buddy는 Anthropic이 Claude Code v2.1.89에 탑재한 터미널 펫 컴패니언 시스템이다. 2026년 4월 1일 출시되었으며, ASCII 아트 기반의 가상 펫이 터미널 안에 상주하며 코딩 세션에 반응한다. 단순한 이스터에그가 아니라, 18종 생물 종(species), 5단계 희귀도(rarity), 결정론적 생성 알고리즘, LLM 기반 성격 시스템을 갖춘 꽤 정교한 구현체다.

활성화 방법

조건

Claude Code v2.1.89 이상 필요
Claude Code Pro 구독 필요 (무료 사용자 미지원)

설치 / 업데이트 방법

npm 설치는 deprecated 처리됐다. 현재 공식 권장 방식은 네이티브 바이너리 인스톨러다.

macOS / Linux

curl -fsSL https://claude.ai/install.sh | sh

Windows (PowerShell)

irm https://claude.ai/install.ps1 | iex

네이티브 설치 방식은 백그라운드에서 자동 업데이트된다. 재시작만 해도 최신 버전이 적용된다. 강제 업데이트가 필요하면:

claude update

Homebrew(brew upgrade claude-code)와 WinGet(winget upgrade Anthropic.ClaudeCode)은 자동 업데이트가 안 되므로 수동 실행 필요.

기존에 npm으로 설치했다면 claude install로 네이티브 바이너리 전환 후 npm 버전 제거를 권장한다.

실행

업데이트 후 Claude Code 재시작하고 터미널에서:

/buddy

첫 실행 시 부화 애니메이션이 재생되며 LLM이 이름과 성격을 생성한다. 이후에는 저장된 데이터를 사용하므로 재생성되지 않는다.

4월 1~7일 한정 티저

이 기간에는 Claude Code 시작 시 무지개 색상의 /buddy 티저 알림이 표시된다. 이후에는 알림은 사라지지만 커맨드 자체는 계속 유지된다. salt 문자열 friend-2026-401이 이 날짜를 나타낸다.

출시 배경: 소스코드 유출 사건

정식 출시 하루 전인 2026년 3월 31일, Claude Code v2.1.88 npm 패키지에 59.8MB짜리 JavaScript 소스맵 파일(.map)이 .npmignore에서 누락된 채로 배포되면서 512,000줄에 달하는 내부 소스코드가 외부에 노출되었다. Anthropic은 "고객 데이터나 자격증명은 포함되지 않았으며, 보안 침해가 아닌 패키징 과정의 인적 오류"라고 공식 확인했다.

이 유출을 통해 /buddy 외에도 복수의 미출시 내부 기능이 공개되었다:

KAIROS: 항상 켜져 있는 백그라운드 에이전트. 유휴 상태에서도 관찰 로그를 append-only로 유지하고, 야간 "dreaming" 프로세스로 메모리를 통합·정리한다.
Coordinator mode: 마스터 Claude가 병렬 워커 에이전트들을 오케스트레이션하는 멀티 에이전트 코디네이터.
Undercover mode: Anthropic 직원이 퍼블릭 레포에서 작업할 때 커밋 메시지에서 AI 기여 표시를 자동으로 제거.
Auto mode: AI 분류기가 도구 사용 권한 확인 프롬프트를 자동 승인.
ULTRAPLAN: 상세 내용 미공개, 피처 플래그로 게이트.

이 기능들은 모두 내부 피처 플래그 뒤에 있어 현재 공개 빌드에서는 사용 불가다.

/buddy 핵심 아키텍처: Bones & Soul

/buddy의 설계는 두 개의 독립적 레이어로 구성된다.

Bones (뼈대) - 결정론적 레이어

사용자의 계정 ID를 salt friend-2026-401과 결합해 FNV-1a 해싱 후 Mulberry32 PRNG로 씨드를 생성한다. 이 씨드가 펫의 모든 물리적 특성을 결정한다:

생물 종 (18종 중 하나)
희귀도 (5단계)
눈 스타일 (6종)
모자 (8종)
스탯 분포

같은 계정은 항상 동일한 외형의 버디를 생성한다. 재설치해도 결과가 동일하다. 로컬 클라이언트 연산이라 지속 비용이 사실상 0이다.

OAuth 계정(Pro/Team)의 경우 accountUuid가 userID보다 우선 적용된다.

Soul (영혼) - LLM 생성 레이어

최초 /buddy 실행 시 Claude가 한 번만 이름과 성격 텍스트를 생성한다. ~/.claude.json에 저장되며 이후 재호출 없이 저장된 데이터를 사용한다.

안티치트: Claude Code는 { ...stored, ...bones } 병합 순서를 사용하므로 config 파일을 수동으로 수정해도 시작 시 Bones가 덮어쓴다.

성격은 5개 핵심 속성의 조합에 기반한다. CHAOS + SNARK가 높으면 버그 작성 시 비꼬는 반응, WISDOM + PATIENCE가 높으면 건설적인 조언을 제공한다.

종(Species) 및 희귀도 시스템

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

5단계 희귀도: Common부터 Legendary까지. 희귀도가 높을수록 총 스탯 포인트 floor가 높다.

Shiny 변형: 희귀도와 독립적으로 1% 확률. 무지개 shimmer 애니메이션과 sparkling 파티클 효과. Shiny Legendary 확률은 약 0.01%.

5개 스탯 (0~100): DEBUGGING, PATIENCE, CHAOS, WISDOM, SNARK. 각 버디는 Peak(+50 이상), Valley(바닥), 나머지 3개는 분산 배치.

터미널 너비 대응: 100컬럼 미만에서는 ASCII 스프라이트가 한 줄 얼굴 표현으로 축소된다 (예: =·ω·=).

슬래시 명령어

/buddy           → 버디 부화 (최초) 또는 표시
/buddy pet       → 버디 쓰다듬기 (하트 애니메이션 2.5초)
/buddy card      → ASCII 스프라이트 포함 전체 스탯 카드 표시
/buddy mute      → 말풍선 음소거
/buddy unmute    → 말풍선 복원
/buddy off       → 버디 숨기기

버디를 이름으로 직접 부르면 Claude가 물러서고 버디가 자신의 성격으로 직접 응답한다.

커뮤니티 반응과 리롤 생태계

출시 수 시간 내에 개발자 커뮤니티는 이미 다음을 만들어냈다:

any-buddy: 원하는 종/희귀도/외형으로 변경하는 바이너리 패치 도구. salt를 브루트포스해 원하는 해시 결과를 찾아낸 뒤 컴파일된 바이너리를 직접 수정. 탐색은 100ms 이내 완료.
buddy-reroll: 유사한 리롤 도구
종별 웹 갤러리, 스탯 체커
Solana 밈코인 ($Nebulynx)

바이너리 패치는 Claude Code 업데이트마다 초기화된다. 일부는 SessionStart hook으로 업데이트 후 자동 재패치를 설정한다.

이용 조건

Claude Code v2.1.89 이상
Claude Code Pro 구독 필요 (무료 사용자 미지원)

제품 전략적 해석

리텐션 메커니즘: 개발자가 Claude Code를 일상 도구로 감정적으로 연결하도록 설계.
비용 효율: 결정론적 생성(클라이언트 로컬 연산) + LLM 1회 호출로 지속 운영 비용 최소화.
소유감 설계: 같은 계정은 항상 같은 버디를 갖는다는 규칙이 "나만의 펫" 인식을 강화한다.
소셜 속성: 스탯 카드 공유, 희귀도 자랑 등 자연스러운 커뮤니티 확산 설계가 내재되어 있다.
피처 플래그 아키텍처: 100개 이상의 기능이 피처 플래그로 관리. 내부 프로덕션 테스트 후 선택적 출시.