bcefghj

Claude Code Buddy Guide — Development skill for Claude Code

Development community

Claude Code Buddy 宠物系统完全指南 - 教程/爆金工具/自定义宠物/哆啦A梦漫画.

How to install Claude Code Buddy Guide

This entry records only its repository, not the path inside it, so there is no exact command to give. Open bcefghj/claude-code-buddy-guide and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Claude Code Buddy Guide does

Claude Code Buddy 宠物系统完全指南 - 教程/爆金工具/自定义宠物/哆啦A梦漫画.

Alternatives in Development

  • Claude Desktop Buddy — Reference and an example for the Bluetooth API for makers in Claude Cowork & Claude Code Desktop 2.5k ★
  • Creator Buddy — Creator Buddy: orchestrated Agent Skills for cross-platform content search, creator analysis, and viral trend 1.4k ★
  • Any Buddy — Hack Claude Code to get any buddy you want 627 ★

README

Claude Code Buddy 宠物系统完全指南

2026年4月1日,Claude Code 正式上线了隐藏的虚拟宠物系统 **Buddy** —— 一个类似电子宠物/扭蛋(Gacha)的彩蛋功能。每个用户都会根据自己的账号ID获得一个独一无二的宠物伙伴!


目录


什么是 Buddy 宠物系统?

Buddy 是 Claude Code 内置的虚拟宠物系统,灵感来自电子宠物(Tamagotchi)和扭蛋游戏。它的特点是:

  • 确定性生成:你的宠物由你的账号UUID决定,同一个账号永远得到同一只宠物
  • 18种物种:从鸭子到龙,从幽灵到水豚,每种都有独特的ASCII艺术精灵
  • 5个稀有度:普通(60%)、不凡(25%)、稀有(10%)、史诗(4%)、传说(1%)
  • 闪光(Shiny):每只宠物有1%的概率是闪光版本
  • 个性系统:宠物有AI生成的名字和独特个性
  • ASCII动画:每种宠物有3帧动画,会在你的终端里活蹦乱跳

系统架构一览

你的账号UUID + 盐值("friend-2026-401")
        ↓
   FNV-1a 哈希 / Bun.hash
        ↓
   Mulberry32 伪随机数生成器 (32位种子)
        ↓
   ┌─────────────────────────────┐
   │  稀有度 → 物种 → 眼睛       │
   │  → 帽子 → 闪光 → 属性      │
   │  → 灵感种子                 │
   └─────────────────────────────┘
        ↓
   你的唯一宠物诞生!

快速开始(3分钟上手)

前提条件

  • 已安装 Claude Code (v2.1.89 或更高版本)
  • 已登录 Claude Code 账号

第一步:查看你的宠物

在 Claude Code 中输入:

/buddy

你会看到一个命令菜单,包含以下子命令:

命令 说明
/buddy hatch 孵化你的宠物(首次使用)
/buddy pet 抚摸宠物(触发爱心动画,约2.5秒)
/buddy card 查看宠物卡片(显示完整信息)

第二步:孵化宠物

输入 `/buddy hatch`,系统会:

  1. 根据你的账号UUID计算宠物属性("骨骼" Bones)
  2. 调用AI模型生成宠物的名字和个性("灵魂" Soul)
  3. 将名字和个性保存到 ~/.claude.jsoncompanion 字段

第三步:和宠物互动

孵化完成后,你的宠物会出现在终端右侧,以ASCII精灵的形式陪伴你编程:

   /\_/\
  ( ·   ·)    💬 "这段代码需要更多注释..."
  (  ω  )
  (")_(")
  • 宽屏模式:完整显示ASCII精灵 + 气泡对话
  • 窄屏模式:只显示单行表情,如 =·ω·=

查看你的 Account UUID

方法一:直接问 Claude Code

你的 accountUuid 是什么?

方法二:终端命令

# macOS / Linux
cat ~/.claude.json | grep -E '"accountUuid"|"userID"'

# Windows PowerShell
Select-String -Pattern '"accountUuid"|"userID"' -Path "$env:USERPROFILE\.claude.json"

方法三:手动查看

打开 `~/.claude.json` 文件,