Claude Code

📖 简介

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           │
│                                      │
╰──────────────────────────────────────╯

⌨️ 斜杠命令参考

📊 宠物属性详解

五维属性影响宠物在编码过程中的行为风格：

属性解读建议

• 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 插件区分

切勿混淆：

🔄 跨设备同步

由于宠物由账号 ID 确定性生成，在任何设备上使用 Claude Code 都会显示同一只宠物：

bash
复制
# 电脑 A
❯ cc /project
❯ /buddy
🍄 Moth 出现...

# 电脑 B 登录同一账号
❯ cc /another-project
❯ /buddy
🍄 仍然是 Moth（同一只蘑菇）

同步内容：

• 物种、外观、稀有度 ✅
• 五维属性 ✅
• 亲密度（临时，会话级）❌

🛠️ 故障排除

🔬 技术细节（进阶）

Spores 三层架构

宠物系统使用 Spores 架构进行确定性生成：

1. Bones（骨架层）：基于 hash(userId + "friend-2026-401") 计算

   • 决定物种（18 种）、稀有度（5 级）、基础属性区间

2. Meat（血肉层）：在骨架基础上填充

   • 精确五维属性值（0-100）
   • 性格倾向（内向/外向）

3. 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. 根据属性调整策略

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! 🐱🐉🍄