前言
"什么？Claude Code 终端里居然藏着一只电子宠物？"
前几天 Anthropic 的 Claude Code 源码意外泄露，51 万行代码被网友扒了个底朝天，结果发现里面藏着一个代号 "BUDDY" 的完整电子宠物系统——这事直接在技术圈炸了锅。Anthropic 索性顺水推舟，在 2.1.89 版本正式上线了这个功能。输入 /buddy，系统会根据你的用户 ID 哈希生成一只独一无二的宠物，陪你写代码、调 Bug、熬夜赶需求。
但问题来了：你的宠物完全由哈希决定，想养龙还是养鸭子，全看命。
传奇（Legendary）掉率只有 1%，闪光（Shiny）概率也是 1%，想拿到一只 ✨ 闪光传奇龙？综合概率 0.01%，比抽卡还离谱。
好在，开源社区出手了。L站风佬开发的 cc-buddy 工具，让你一条命令自定义宠物的一切——物种、稀有度、帽子、属性，全部由你做主。
今天这篇文章，带你从安装到完全自定义，5 分钟搞定你的专属 Buddy。
一、Claude Code Buddy 是什么？
2026 年 4 月 1 日，Anthropic 在 Claude Code CLI 中上线了一个隐藏的电子宠物系统。你在终端输入 /buddy，就会孵化出一只属于你的宠物伙伴。
它不只是个摆设——宠物会出现在你的终端输入框旁边，偶尔冒个爱心、打个哈欠，陪你度过每一个 debug 的深夜。
宠物属性系统包含：
- 18 种物种：从普通的鸭子、猫咪，到史诗级的龙、章鱼，再到传说级的 Nebulynx
- 5 级稀有度：Common → Uncommon → Rare → Epic → Legendary
- 6 种眼睛样式：· ✦ × ◉ @ °
- 8 种帽子：皇冠、礼帽、螺旋桨帽、光环、巫师帽……
- 闪光（Shiny）：1% 概率的特殊变种，闪闪发光
- 5 项 RPG 属性：DEBUGGING、PATIENCE、CHAOS、WISDOM、SNARK
但这一切，原来都由你的 UserID 哈希决定。 抽到什么就是什么，想换？只能祈祷重新安装。
直到 cc-buddy 出现。
二、一键安装 cc-buddy
cc-buddy 是一个 Node.js 工具，不需要全局安装，直接用 npx 运行即可。
前提条件：
- Node.js 已安装（建议 v18+）
- Claude Code 已通过 npm 全局安装（
npm i -g @anthropic-ai/claude-code）
运行命令：
npx cc-buddy
启动后你会看到这样的交互菜单：
🎰 Claude Buddy 宠物重铸器 v2.3.0
运行时: Node.js (wyhash 回退) | Hash: FNV-1a (npm install)
你想做什么？
[1] 🔍 搜索宠物
[2] 👀 查看当前宠物
[3] ✏️ 自定义名字/性格
[4] 🔓 完全自定义 (patch cli.js)
[5] 📋 物种图鉴
[6] 🧪 自检 Hash
[7] 🌐 切换语言
[8] 👋 退出
功能一目了然，下面我们一步步来。
三、查看当前宠物
选择 [2] 查看当前宠物，看看你系统默认生成了什么：
🔍 当前宠物:
🐉 DRAGON
★★★★★ legendary ✨ SHINY!
Eyes: × | Hat: 👑 crown
DEBUGGING ████████████████████ 100
PATIENCE ███████████░░░░░░░░░ 54
CHAOS ██████████░░░░░░░░░░ 49
WISDOM ███████████░░░░░░░░░ 57
SNARK ███████████████░░░░░ 77
如果你运气好，可能已经是一只传奇龙了。但大多数人抽到的是普通的 Pebblecrab 或 Mossfrog。
想自定义？进入下一步。
四、完全自定义宠物（核心功能）
这是 cc-buddy 最强大的功能——选项 [4] 完全自定义 (patch cli.js)。
它会修改 Claude Code 的 cli.js，让你的自定义配置覆盖默认的哈希计算值。
Step 1：确认 Patch
⚠ 仅适用于 npm 全局安装 (npm i -g @anthropic-ai/claude-code)。
不适用于原生二进制安装 (cli.anthropic.com)。
确认 patch? [Y/n]: y
输入 y 确认，cc-buddy 会自动备份原文件（cli.js.original），随时可以恢复。
Step 2：解锁气泡反应
解锁宠物气泡反应? (关闭遥测的用户需要此补丁) [y/N]: y
✓ 气泡反应已解锁!
关闭遥测的用户必须打这个补丁，否则宠物不会冒泡。
Step 3：解锁 /buddy 命令
为第三方 API 用户启用 /buddy? [y/N]: y
✓ /buddy 已为所有用户解锁!
如果你用的是 Bedrock、Vertex 或自定义 API 地址，这一步让你也能使用 /buddy。
Step 4：选择物种
物种 (回车保持当前):
[1] 🦆 duck [7] 🦉 owl [13] 🦫 capybara
[2] 🪿 goose [8] 🐧 penguin [14] 🌵 cactus
[3] 🫧 blob [9] 🐢 turtle [15] 🤖 robot
[4] 🐱 cat [10] 🐌 snail [16] 🐰 rabbit
[5] 🐉 dragon [11] 👻 ghost [17] 🍄 mushroom
[6] 🐙 octopus [12] 🦎 axolotl [18] 🐈 chonk
18 种物种任选。想养龙？选 [5]。想要一只巨型胖猫？选 [18] chonk。
Step 5：选择稀有度
[1] ★ common [4] ★★★★ epic
[2] ★★ uncommon [5] ★★★★★ legendary
[3] ★★★ rare
不用多说，直接选 [5] 传说级。
Step 6：选择眼睛和帽子
眼睛: [1] · [2] ✦ [3] × [4] ◉ [5] @ [6] °
帽子: [1] — [2] 👑 [3] 🎩 [4] 🧢 [5] 😇 [6] 🧙 [7] ⛑ [8] 🐤
选你喜欢的组合。闪亮的大眼睛 ✦ + 皇冠 👑，经典搭配。
Step 7：设置闪光和属性
闪光? [y/N]: y
DEBUGGING [?]: 100
PATIENCE [?]: 100
CHAOS [?]: 100
WISDOM [?]: 100
SNARK [?]: 100
全部拉满，五维全 100，打造一只六边形战士。
Step 8：命名和性格描述
✏️ 给它取个名字: fish
✏️ 写一句性格描述: A highly disciplined coding agent focused on execution
取个有个性的名字，写一句属于它的座右铭。
最终确认
✓ 自定义宠物已写入! 重启 Claude Code → /buddy
{"rarity":"legendary","eyes":"✦","hat":"crown","shiny":true,
"stats":{"DEBUGGING":100,"PATIENCE":100,"CHAOS":100,"WISDOM":100,"SNARK":100},
"name":"fish"}
重启 Claude Code，输入 /buddy，你的专属宠物就出现了。
五、常见问题
Q：patch 后怎么恢复原版？
cc-buddy 会自动备份 cli.js.original，恢复只需一条命令：
cp /Users/gfish/.nvm/versions/node/v24.13.1/lib/node_modules/@anthropic-ai/claude-code/cli.js.original /Users/gfish/.nvm/versions/node/v24.13.1/lib/node_modules/@anthropic-ai/claude-code/cli.js
Q：原生二进制安装能用吗？
不能。cc-buddy 的 patch 功能仅支持 npm 全局安装方式。如果你是从 cli.anthropic.com 安装的，需要先切换到 npm 安装。
Q：宠物会影响 Claude Code 功能吗？
完全不会。Buddy 系统是独立的前端展示层，不影响任何代码生成、对话、工具调用等核心功能。
Q：Claude Code 更新后会失效吗？
npm 更新 Claude Code 会覆盖 cli.js，需要重新运行 npx cc-buddy 打补丁。好消息是 cc-buddy 会记住你的配置，重新 patch 很快。
六、总结
Claude Code 的 Buddy 系统是 Anthropic 给开发者的一份小惊喜——在冰冷的终端里养一只电子宠物，让编码多了一点温度。
而 cc-buddy 把这份惊喜玩到了极致：
- 18 种物种随意选择，龙、幽灵、蘑菇……想养什么养什么
- 5 级稀有度自由切换，传说级不再是梦
- 闪光效果、眼睛、帽子、属性全部自定义
- 支持第三方 API 用户解锁 /buddy 功能
- 一键恢复，随时可以回到原版
一条命令 npx cc-buddy，5 分钟搞定。给你的 Claude Code 配一只最酷的宠物吧。
参考链接
cc-buddy 开源项目（风佬 @fengshao1227）： github.com/fengshao122…
L 站原帖（风佬文章）： linux.do/t/topic/187…
Claude Code Buddy 完整攻略（18 种物种 + 5 级稀有度）： help.apiyi.com/claude-code…
ClaudeFa.st Buddy 机制深度解析： claudefa.st/blog/guide/…
欢迎关注公众号 FishTech Notes，一块交流使用心得！
