傻瓜式操作定制 Claude Code 宠物 Buddy

Claude Code 有一个隐藏玩法------Buddy 宠物系统。它会在你的输入框旁边显示一只小宠物，偶尔还会冒泡吐槽几句。

但是，默认生成的宠物是随机的------可能是一只常见的鸭子或企鹅。

今天教大家定制专属 Buddy，支持任意物种、稀有度、外观和性格。

为了方便大家使用，我把整套定制流程做成了傻瓜式一键操作，并且已经完全开源。

GitHub：https://github.com/beilingcc/openbuddy

前置要求

Buddy 系统需要 Claude Code v2.1.89 及以上版本。如果你的版本过低，先升级：

bash 复制代码

# npm 安装用户
npm update -g @anthropic-ai/claude-code

# native 安装用户
# 重新下载最新版本

查看当前版本：

bash 复制代码

claude --version

先看成果

这是我定制的宠物 Moth：

复制代码

╭──────────────────────────────────────╮
│                                      │
│  ★★★★★ LEGENDARY             CAPYBARA  │
│                                      │
│      n______n                        │
│     ( ◉    ◉ )                       │
│     (   oo   )                       │
│      `------´  ✨                     │
│                                      │
│  Moth                                │
│                                      │
│  "A legendary capybara of few words."│
│                                      │
│  DEBUGGING  ██████████ 100           │
│  PATIENCE   ████████░░ 81            │
│  CHAOS      ████████░░ 76            │
│  WISDOM     ███████░░░ 74            │
│  SNARK      ████░░░░░░ 40            │
│                                      │
╰──────────────────────────────────────╯

★★★★★ 传奇水豚，◉ 眼睛，皇冠帽，安静乖巧性格（SNARK 只有 40）。

怎么做到的？往下看。

原理解释

Buddy 系统分两层：

骨架（Bones） --- 外观、物种、稀有度、属性，由哈希算法确定性生成
灵魂（Soul） --- 名字和性格，模型生成后存储在配置里

关键点：同一 userID 永远生成同一只宠物。换掉 userID，就能换宠物。

三步定制（无需安装任何插件）

第一步：克隆项目

bash 复制代码

git clone https://github.com/beilingcc/openbuddy
cd openbuddy

第二步：描述你想要的宠物

把下面这段话发给 Claude Code：

复制代码

我想要一只专属的 Claude Code 宠物（Buddy）。我想要：

- 物种：水豚（capybara）
- 稀有度：传奇（legendary）
- 眼睛：◉
- 帽子：皇冠（crown）
- 性格：安静乖巧（SNARK 不要太高）

请帮我：
1. 运行 `ls openbuddy/scripts/` 确认脚本存在
2. 运行搜索脚本找到符合条件的 UID
3. 验证这个 UID 对应的宠物各项属性是否符合预期
4. 把 ~/.claude.json 的 userID 改成这个 UID，并删除 companion 字段
5. 告诉我接下来怎么做

项目目录在 ./openbuddy。

Claude 会自动搜索、验证、写入配置，你只需要等结果。

第三步：刷新你的 Claude Code

改完配置后，执行 /buddy 查看新宠物。

就这么简单。

不想要懒人方案？

手动操作也只需要三步：

bash 复制代码

# 1. 安装 bun
irm bun.sh | iex

# 2. 搜索（例如：传奇金色水豚，皇冠帽，◉ 眼）
bun scripts/find-buddy.js --species capybara --rarity legendary --shiny --hat crown --eye "◉"

# 3. 验证
node scripts/verify.js <搜到的UID>

# 4. 修改配置
# 编辑 ~/.claude.json，只保留 userID，删除 companion 字段

支持的定制参数

参数	可选值
物种	duck, dragon, capybara, ghost, robot...（18种）
稀有度	common → legendary（最高）
眼睛	· ✦ × ◉ @ °
帽子	none, crown, tophat, halo, wizard...
性格	通过 5 项属性调节

常见问题

Q: 需要等多久？

条件越严格越慢。legendary + shiny + 特定物种 + 特定眼睛 + 特定帽子，同时满足的概率约千万分之一，通常几分钟到几十分钟。

Q: 支持 OAuth 用户吗？

支持，详见项目 README。

👉 关注"北灵聊AI"，获取最新更新