Skip to main content

概述

Buddy 是 Claude Code 内置的虚拟宠物系统。在 REPL 中通过 /buddy 命令可以孵化一只随机生成的宠物伴侣,它会出现在输入框旁边,陪伴你的编码过程。
Feature Flag: FEATURE_BUDDY=1

启用方式

FEATURE_BUDDY=1 bun run dev
孵化窗口:2026 年 4 月 1-7 日期间启动时,会在 REPL 顶部显示彩虹色的 /buddy 提示。4 月 7 日之后命令仍然可用,但不再自动提示。

命令

命令说明
/buddy查看当前宠物信息和属性
/buddy hatch孵化一只新宠物(首次使用)
/buddy rehatch重新随机生成宠物(替换现有)
/buddy pet撸宠物,触发爱心动画
/buddy mute静音宠物(隐藏)
/buddy unmute取消静音

宠物属性

物种(18 种)

DuckGooseBlobCat
DragonOctopusOwlPenguin
TurtleSnailGhostAxolotl
CapybaraCactusRobotRabbit
MushroomChonk

稀有度

稀有度星级权重
Common60%
Uncommon★★25%
Rare★★★10%
Epic★★★★4%
Legendary★★★★★1%
孵化时基于种子随机决定,存在极低概率出现 Shiny(闪光)变体。

属性值

每只宠物拥有 5 项属性(0-100):
  • DEBUGGING — 调试能力
  • PATIENCE — 耐心程度
  • CHAOS — 混乱指数
  • WISDOM — 智慧值
  • SNARK — 毒舌度

外观

每只宠物还有随机的外观配件:
  • 眼睛: · × @ °
  • 帽子: none, crown, tophat, propeller, halo, wizard, beanie, tinyduck

数据存储

宠物信息存储在 ~/.claude.jsoncompanion 字段中。宠物的外观属性(物种、稀有度、属性值等)基于用户 ID 的哈希确定性生成,不可通过编辑配置文件来篡改稀有度。

相关源码

文件说明
src/commands/buddy/buddy.ts/buddy 命令处理
src/buddy/companion.ts宠物生成与加载
src/buddy/types.ts类型定义(物种、稀有度、属性)
src/buddy/sprites.ts终端像素画渲染
src/buddy/CompanionSprite.tsxReact 组件(输入框旁显示)
src/buddy/useBuddyNotification.tsx启动提示通知
src/buddy/prompt.ts宠物相关 prompt 模板