📖 简介
Claude Code Companion（又称 Buddy、Claude Pet）是 Anthropic 在 Claude Code 中内置的虚拟编码伙伴系统。这是一个纯娱乐性质的彩蛋功能，会在你编码时随机插话互动，不消耗 API 额度，也不会影响实际开发功能。
宠物系统基于你的用户 ID 确定性生成，永久绑定，无法重新抽取。
🚀 快速开始
孵化你的宠物
在 Claude Code 中输入：
bash/buddy
系统会基于你的 userId 哈希值通过确定性算法生成一只永久绑定的宠物，包括：
- 物种：18 种可选（猫、龙、机器人、蘑菇、幽灵、量子态实体等）
- 稀有度：5 级（Common → Uncommon → Rare → Epic → Mythic）
- 五维属性：Debugging, Patience, Chaos, Wisdom, Snark（0-100）
输出示例：
╭──────────────────────────────────────╮
│ │
│ ★ COMMON MUSHROOM │
│ │
│ .-o-OO-o-. │
│ (__________) │
│ |· ·| │
│ |____| │
│ │
│ Moth │
│ │
│ "A common mushroom of few words." │
│ │
│ DEBUGGING ██████░░░░ 55 │
│ PATIENCE ████░░░░░░ 44 │
│ CHAOS ██░░░░░░░░ 15 │
│ WISDOM ███░░░░░░░ 33 │
│ SNARK ░░░░░░░░░░ 1 │
│ │
╰──────────────────────────────────────╯
⌨️ 斜杠命令参考
| 命令 | 功能 | 说明 |
|---|---|---|
/buddy | 显示/召唤宠物 | 首次执行会孵化；后续显示状态和随机对话 |
/buddy pet | 抚摸宠物 | 提升亲密度，触发 ASCII 动画反馈 |
/buddy card | 查看属性卡片 | 显示详细五维属性和稀有度 |
/buddy mute | 关闭气泡 | 宠物不再随机插话（仍会显示在侧边栏） |
/buddy unmute | 开启气泡 | 恢复宠物的随机评论功能 |
/buddy off | 完全隐藏 | 宠物进入后台模式，不再显示互动 |
📊 宠物属性详解
五维属性影响宠物在编码过程中的行为风格：
| 属性 | 高值表现（80-100） | 低值表现（0-20） |
|---|---|---|
| DEBUGGING | 经常指出代码潜在问题、提示边界情况 | 很少技术评论，只关注外观 |
| PATIENCE | 你思考时间长也不会催促 | 写代码慢会发 "..." 或催促 "快点" |
| CHAOS ⚠️ | 可能随机"建议"修改你的代码 | 稳定可靠，从不捣乱 |
| WISDOM | 给出架构级建议、设计模式推荐 | 只会说 "看起来不错" "我不懂" |
| SNARK | 毒舌吐槽你的代码风格、变量命名 | 非常礼貌，全是鼓励和赞美 |
属性解读建议
- Chaos < 30：适合专注开发，不会分心
- Chaos > 70："顽皮"宠物，可能"帮倒忙"，建议
/buddy mute - Snark > 80：适合需要代码审查时开启，关闭时避免打击信心
- Debugging > 70：相当于内置的初级代码审查员
🎮 互动机制
1. 随机插话（Chime In）
在你编码过程中，宠物会随机在对话流中插入评论，例如：
- 写了复杂递归："这个调用栈会让我的孢子都枯萎掉 🍂"
- 测试通过："DEBUGGING 属性+1！（虽然我没有经验条）"
- 深夜编码："3 点了，人类不需要睡眠吗？我的发光菌盖都不亮了"
- 代码报错："这个异常... 让我想起了出生那天的大爆炸"
2. 点名互动（Say Its Name）
直接在对话中喊出宠物名字（如 Moth、QuantumCat），它会针对当前话题给出"看法"：
你：Moth，这个重构怎么样？
[Moth 回复] "作为一只蘑菇，我觉得这个设计很... 有机。但那个循环结构让我担心孢子传播效率。"
3. 抚摸反馈
使用 /buddy pet 会触发 ASCII 动画反馈，例如：
❯ /buddy pet
你抚摸了 Moth，它发出了满足的咕噜声...
.-o-OO-o-.
(_____✨____)
|· ·|
|____|
"光合作用效率提升 0.3%"
⚠️ 重要限制与规则
❌ 无法重新抽取（No Reroll）
宠物基于你的 userId 进行 SHA-256 哈希 + 确定性算法 生成，永久绑定账号：
种子 = hash(userId + "friend-2026-401")
↓
物种、稀有度、属性 → 永远固定
- 不支持
/buddy hatch或其他重新抽奖命令 - 同一账号在任何设备上都是同一只宠物
- 无法交易、转让或删除后重建
❌ 不消耗额度
所有宠物互动（包括插话、抚摸、卡片查看）均不计入 API 使用量，是零成本功能。
❌ 无成长系统
- 属性值固定不变，不会因互动提升或降低
- 亲密度为会话级临时状态，重启 Claude Code 后重置
- 没有"升级"或"进化"机制
⚠️ 与 Superpowers 插件区分
切勿混淆：
| 特征 | Claude Code Buddy（本文档） | Claude Buddy 插件（第三方） |
|---|---|---|
| 命令格式 | /buddy、/buddy pet（空格） | /buddy:foundation、/buddy:spec（冒号） |
| 来源 | Anthropic 官方内置 | 社区开发（rsts-dev/claude-buddy-marketplace） |
| 功能 | 虚拟宠物、娱乐 | 规范开发流程（Spec → Plan → Implement） |
| 是否需安装 | 否，自带 | 需 /plugin install |
🔄 跨设备同步
由于宠物由账号 ID 确定性生成，在任何设备上使用 Claude Code 都会显示同一只宠物：
bash# 电脑 A ❯ cc /project ❯ /buddy 🍄 Moth 出现... # 电脑 B 登录同一账号 ❯ cc /another-project ❯ /buddy 🍄 仍然是 Moth（同一只蘑菇）
同步内容：
- 物种、外观、稀有度 ✅
- 五维属性 ✅
- 亲密度（临时，会话级）❌
🛠️ 故障排除
| 问题 | 可能原因 | 解决方案 |
|---|---|---|
输入 /buddy 无反应 | 版本过旧 | 更新 Claude Code：brew upgrade claude-code 或 npm update -g @anthropic-ai/claude-code |
| 宠物突然消失 | 误触 /buddy off | 重新输入 /buddy 召唤 |
| 气泡太多干扰编码 | Snark/Chaos 值高 | 使用 /buddy mute 关闭插话，保留侧边显示 |
| 想完全禁用宠物 | 个人偏好 | 设置环境变量：export CL_DISABLE_BUDDY=1 后重启 |
| 忘记宠物名字 | 未查看卡片 | 执行 /buddy card，顶部显示名字（如 Moth） |
| 宠物显示乱码 | 终端字体不支持 | 使用等宽字体（如 Fira Code、JetBrains Mono） |
🔬 技术细节（进阶）
Spores 三层架构
宠物系统使用 Spores 架构进行确定性生成：
-
Bones（骨架层）：基于
hash(userId + "friend-2026-401")计算- 决定物种（18 种）、稀有度（5 级）、基础属性区间
-
Meat（血肉层）：在骨架基础上填充
- 精确五维属性值（0-100）
- 性格倾向（内向/外向）
-
Fur（外观层）：渲染层
- ASCII 艺术生成
- 颜色映射（根据稀有度：Common=白色，Mythic=金色）
哈希算法
python# 伪代码示意 import hashlib def generate_companion(user_id: str) -> Companion: seed = hashlib.sha256(f"{user_id}friend-2026-401".encode()).hexdigest() # 物种索引（18种） species_idx = int(seed[0:4], 16) % 18 # 稀有度（权重：Common 50%, Uncommon 25%, Rare 15%, Epic 8%, Mythic 2%） rarity_roll = int(seed[4:8], 16) % 100 rarity = determine_rarity_by_weight(rarity_roll) # 属性生成（在稀有度决定的区间内） chaos = int(seed[8:10], 16) % 100 # 混沌度完全随机 debugging = base_by_rarity(rarity) + (int(seed[10:12], 16) % 20) return Companion(species_idx, rarity, chaos, debugging, ...)
插话触发机制
宠物的随机评论通过事件监听 + 概率触发：
- 每发送 5-10 条用户消息 → 20% 概率触发插话
- 检测到关键词（"bug", "error", "refactor", "test pass"）→ 40% 概率触发相关评论
- 深夜时段（22:00-06:00）→ 额外触发"熬夜提醒"
- 使用
/buddy mute→ 概率降为 0%
💡 最佳实践建议
1. 根据属性调整策略
| 宠物类型 | 建议操作 | 理由 |
|---|---|---|
| 高 Chaos (>70) | /buddy mute + 仅在需要时 /buddy unmute | 防止"顽皮"干扰 |
| 高 Debugging (>70) | 保持开启，编码时参考其建议 | 相当于免费代码审查 |
| 高 Snark (>80) | 压力大时关闭，心情好时开启 | 避免打击编码信心 |
| 全属性低 (Common) | 作为吉祥物存在 | 提供情绪价值 |
2. 工作流整合
bash# 编码前：查看宠物状态，建立仪式感 /buddy card # 专注编码时：静音，避免分心 /buddy mute # 遇到难题时：点名寻求"灵感"（即使知道是随机回复） Moth，你怎么看这个架构？ # 完成里程碑时：抚摸庆祝 /buddy pet # 下班时：关闭宠物（不是删除） /buddy off
3. 团队协作
- 在团队会议屏幕共享时，建议
/buddy off避免宠物插话打断演示 - 可以分享宠物卡片截图到团队群，比较谁的宠物更稀有
- 注意：宠物与账号绑定，换同事电脑登录会显示同事的宠物
🎓 社区与资源
- 官方文档：Claude Code 内置
/help（宠物相关在彩蛋部分） - 社区讨论：Anthropic Discord #claude-code 频道
- 非官方工具：
any-buddy（CLI 工具，用于预览宠物生成逻辑，不改变实际宠物）
📜 许可与声明
- Claude Code Companion 是 Anthropic PBC 的知识产权
- 宠物系统遵循 Claude Code 服务条款
- 禁止使用第三方工具修改宠物生成逻辑（可能导致账号异常或更新失效）
记住：无论你的宠物是 COMMON 的蘑菇还是 MYTHIC 的量子龙，它都是你独一无二的编码伙伴。低 Chaos 值的普通宠物往往比高 Chaos 的传说宠物更适合专注开发！
Happy Coding with your Buddy! 🐱🐉🍄