如何在 Claude Code 中获取并自定义 Buddy 宠物：从基础指令到高阶刷取指南

2026年3月31日，凌晨2点17分。

程序员社区里的一条朋友圈截图开始疯传：“最近大家都在刷Claude Buddy电子宠物，看到了一篇刷黄金版本的教程。”

配图里，一只ASCII风格的小鸭子坐在终端输入框旁，栩栩如生。

三分钟后，截图在各大群聊扩散。一小时后，GitHub上一个名为 cc-buddy 的仓库星标数开始激增。没人预料到，一次意外的源码泄露，竟在72小时内点燃了整个开发者圈的热情。

源头：一个59.8MB的“失误”

时间倒回24小时前。3月30日，Anthropic 像往常一样发布了 Claude Code 的新版本 @anthropic-ai/claude-code@2.1.88。起初一切如常，直到有开发者发现，这个 npm 包附带了一个高达 59.8MB 的 source map 文件。

这意味着超过 51.2 万行的 TypeScript 源码完全暴露。开发者们立即开始了“考古挖掘”。在 src/buddy/ 目录下，一个完整的、名为 Buddy 的子系统浮出水面——包含完整的代码、资源文件、动画系统，甚至独立的 System Prompt。

根据源码注释，官方原计划在4月1日至7日进行愚人节预览，5月才正式上线。然而，在源码泄露37小时后，Anthropic 做出了一个出人意料的决定：直接发布 2.1.89 版本，向所有用户开放 /buddy 指令。

官方的更新日志只有简单一句：/buddy is here for April 1st — hatch a small creature that watches you code.

但泄露的源码注释透露了更深层的设计哲学：“Buddy is a separate entity and is not you (Claude).” 它并非 Claude 的附庸，而是一个独立的数字生命。

初遇：我的第一只 Common Blob

更新 Claude Code 后，我在终端输入了 /buddy。一个蛋壳图案在输入框旁出现，经过三帧简单的动画，蛋壳裂开，一只灰色的、看起来睡眼惺忪的 Blob（史莱姆）跳了出来。

使用 /buddy card 查看它的详细信息：

• 物种：Blob
• 稀有度：Common（60% 概率）
• 属性：DEBUGGING 23, PATIENCE 67, CHAOS 45, WISDOM 34, SNARK 12

“原来我是那60%的大多数。” 我把截图发到技术群里，立刻引发了共鸣。有人抽到 Common 鸭子，有人是 Uncommon 猫，更有人炫耀着自己刚刚孵出的 Legendary 龙。

那一刻我明白了，这不仅仅是一个彩蛋，更是一个充满随机性和收集乐趣的轻量级游戏。

解密：Buddy 的“骨骼”与“灵魂”

要玩转这个系统，需要理解其核心设计。每只 Buddy 都由两部分构成：

Bones（骨骼） —— 决定其外在形态与基础属性：

• 物种：共18种（如 Blob, Duck, Dragon 等）。
• 稀有度：5个等级（Common, Uncommon, Rare, Epic, Legendary）。
• 眼睛样式：6种可选。
• 帽子：8种样式（仅 Uncommon 及以上稀有度拥有）。
• 闪光（Shiny）：独立1%概率触发的特殊视觉效果。
• 五维隐藏属性：DEBUGGING（调试）、PATIENCE（耐心）、CHAOS（混沌）、WISDOM（智慧）、SNARK（毒舌）。

Soul（灵魂） —— 它的名字和自定义的性格描述。

最关键的核心机制是：Bones 永不存盘，Soul 才存盘。
Bones 由 hash(userID + salt) 实时计算得出，采用的算法是 Bun.hash/wyhash + Mulberry32。这意味着什么？你首次启动时获得的 Buddy 骨骼（物种、稀有度等）是确定性的，无法通过常规方式重置。 除非，你找到改变那个“种子”的方法。

进阶：使用 cc-buddy 工具进行“重铸”

开发者 @fengshao1227 在 GitHub 上开源了一个名为 cc-buddy 的工具，彻底改变了游戏规则。这个零依赖的纯 JavaScript 工具实现了一个简单却强大的思路：暴力穷举随机生成的 userID，计算其对应的 Buddy Bones，直到匹配你心仪的目标组合。

操作流程如下：

1. 通过 npm 全局安装或直接运行：

   npx cc-buddy

2. 工具启动后，你会看到一个交互式菜单。

3. 选择 [1] 搜索并应用宠物，然后依次选择你的目标：

   • 物种（如 dragon）
   • 稀有度（如 legendary）
   • 眼睛样式
   • 帽子
   • 是否要求闪光（Shiny）
   • 设置搜索次数（例如 500 万次）

4. 确认后，终端开始快速滚动尝试次数。整个过程依赖于本地 Node.js 的计算能力。

   尝试次数：164,030... 892,441... 2,103,982...

5. 当找到匹配项时，工具会提示：

   Found: legendary dragon (shiny) @ 4,721,056

6. 输入 Y 确认应用。工具会自动备份你的 ~/.claude.json 配置文件，并向其中注入包含目标 userID 种子的 companionOverride 配置块。

7. 重启 Claude Code，再次输入 /buddy。这一次，蛋壳中孵出的将是你梦寐以求的传奇闪光宠物。

18种宠物全图鉴

以下是社区整理的 Buddy 物种图鉴，每一只都有独特的 3 帧 ASCII 动画，闪光版周身会有特效环绕：

DUCK 鸭子 —— 经典的橡胶鸭调试法化身。

 < ( . )___
   ( ._> --´`

GOOSE 鹅 —— 脾气暴躁的程序员精神图腾。

    ( .>
   ||
 _(__)_
 ^^^^

CAPYBARA 水豚 —— 社区最爱，佛系与松弛感的代表。

 n______n
( . . )
( oo )
------´`

DRAGON 龙 —— 力量与传奇的象征。

   /^\ /^\
  < . . >
  ( ~~ )
  -vvvv-´`

CHONK 胖猫 —— 以超级可爱的形态治愈你的编程时光。

  /\ /\
 ( . . )
 ( .. )
 ------´`

此外还有 Blob、Cat、Octopus、Owl、Penguin、Turtle 等，总计 18 种各具特色的宠物。在云栈社区的讨论中，水豚、龙和胖猫常年位居人气榜前列。

社区热潮与未来想象

从 X 上的晒图狂欢，到各种自制增强工具（如本地卡牌编辑器、Tauri 桌面浮窗版），Buddy 系统迅速形成了活跃的衍生生态。它之所以能引发共鸣，或许是因为它触及了开发者一个隐秘的需求：对抗编码时的孤独感。

面对冰冷的终端、沉默的代码和红色的报错，一只会眨眼、会吐槽、会对你的操作做出反应的小宠物，提供了一种简单的数字陪伴。Anthropic 的混合设计也很巧妙——确定性算法防止滥用，同时开放 Override 接口满足了极客的探索欲。

关于未来，社区的想象天马行空：Buddy 的属性是否可能实际影响编码辅助？是否会推出多宠物养成系统？能否与 Claude Projects 联动，让宠物参与项目管理？当然，官方后续也可能增加校验机制，因此建议玩家适度探索，并务必备份好原始配置文件。

行动起来

总而言之，Claude Buddy 不仅仅是一个愚人节玩笑。它是一次关于“AI 作为伙伴”的生动实验。现在，你可以打开终端，开始你的陪伴之旅：

# 确保 Claude Code 为最新版
claude update
# 运行重铸工具，寻找你的本命伙伴
npx cc-buddy

你会孵化出一只佛系的水豚、霸气的闪光龙，还是一只爱吐槽的胖猫？无论结果如何，都欢迎来 云栈社区 的开发者广场分享你的 Buddy，看看谁的伙伴更有个性。