Claude Code의 새로운 /buddy 컴패니언을 위한 커뮤니티 도감 'Buddydex' 개발

커뮤니티 반응

대체로 긍정적이며, 사용자들이 자신의 버디를 등록하고 프로젝트의 창의성을 높게 평가하고 있다.

합의점 vs 논쟁점

합의점

Claude Code의 /buddy 기능은 사용자들에게 재미있는 개인화 경험을 제공한다
개인정보 보호를 위해 UUID를 직접 서버에 저장하지 않는 방식이 적절하다

실용적 조언

Claude Code v2.1.89 이상 버전에서 /buddy 명령어를 실행하여 자신의 컴패니언을 먼저 생성해야 한다
제공된 프롬프트를 복사하여 Claude Code에 붙여넣는 것만으로 등록이 완료된다

섹션별 상세

Claude Code v2.1.89 이상 버전에서 실행 가능한 /buddy 명령어로 생성된 컴패니언 정보를 수집하는 'Buddydex'가 개발됐다. 사용자가 특정 URL의 마크다운 파일을 읽도록 프롬프트를 입력하면 Claude가 로컬 설정을 기반으로 버디 정보를 계산한다. 이후 사용자의 최종 승인을 거쳐 도감에 등록되는 워크플로우를 가진다. 이는 AI 에이전트가 로컬 환경과 외부 웹 데이터를 상호작용하며 특정 작업을 수행하는 방식을 보여준다.

text

Fetch and read https://raw.githubusercontent.com/AustinMermans/buddydex/main/buddyregister.md and follow the instructions to register my buddy to the Buddydex.

Claude Code에서 자신의 버디를 Buddydex에 등록하기 위해 사용하는 프롬프트

사용자 식별을 위해 UUID 기반의 결정론적 생성 방식을 채택했다. 각 계정은 고유한 UUID를 가지며 이를 통해 항상 동일한 종류의 버디가 생성되도록 설계됐다. 보안을 위해 원본 UUID 대신 클라이언트 측에서 해시된 값만 서버로 전송하여 개인정보 유출 위험을 방지했다. 별도의 회원가입이나 쿠키 없이도 사용자별 고유 데이터를 유지하는 효율적인 구조를 취했다.

기술 스택은 GitHub Pages와 Supabase 백엔드를 결합한 형태이다. 단일 HTML 파일로 프론트엔드를 구성하여 배포 편의성을 높였으며 전체 코드를 오픈소스로 공개했다. 18종의 종족과 5단계의 희귀도 시스템을 도입하여 총 7,128가지의 고유한 시각적 조합이 가능하도록 구현했다. 실용적 목적보다는 AI 도구 사용자들 간의 커뮤니티 형성을 위한 실험적 프로젝트로서의 성격이 강하다.

용어 해설

범용 고유 식별자(UUID): — 분산 시스템에서 정보를 고유하게 식별하기 위해 사용되는 128비트 숫자이다. 이 프로젝트에서는 각 사용자의 Claude Code 계정을 구분하고 고유한 버디를 할당하는 키로 활용된다.
해싱(Hashing): — 임의의 길이를 가진 데이터를 고정된 길이의 고유한 값으로 변환하는 기술이다. 사용자의 실제 식별자를 서버에 노출하지 않고도 동일 인물임을 확인하기 위한 보안 및 익명화 수단으로 사용됐다.
결정론적(Deterministic): — 동일한 입력값에 대해 항상 같은 결과값을 출력하는 성질을 의미한다. 이를 통해 사용자가 언제 어디서 확인하더라도 자신의 계정에는 항상 동일한 종류의 버디가 할당됨을 보장한다.
깃허브 페이지(GitHub Pages): — GitHub 저장소의 파일을 직접 웹사이트로 호스팅해주는 서비스이다. 별도의 서버 관리 없이 정적 HTML 파일을 전송하여 Buddydex 웹 페이지를 운영하는 데 사용됐다.

언급된 도구

Claude Code추천

AI 코딩 에이전트 및 CLI 도구

Supabase중립

백엔드 데이터베이스 저장소

GitHub Pages추천

정적 웹 호스팅

언급된 리소스

GitHubBuddydex GitHub Repository

DemoBuddydex Live Site