Claude Code 宠物 (Buddy) 配置教程

claude-code安装指令

复制代码

npm install -g @anthropic-ai/claude-code

什么是 Buddy

Claude Code 内置的虚拟宠物系统，一只 ASCII 小动物会常驻在输入框旁边，观察你的对话并偶尔发表评论。

18 个物种 / 5 个稀有度 / 6 种眼睛 / 8 种帽子 / 1% 闪光概率。

快速开始

1. 孵化宠物

在 Claude Code 中输入：

复制代码

/buddy

首次使用会随机生成一只宠物（物种、稀有度等由你的账号 ID 决定，不可更改）。

2. 常用命令

命令	作用
`/buddy`	孵化 / 查看宠物信息
`/buddy pet`	抚摸宠物（飘爱心）
`/buddy mute`	静音（隐藏宠物）
`/buddy unmute`	取消静音

全部物种图鉴

共 18 种物种，每种有 3 帧动画。以下展示默认眼睛 · 的静态帧。

duck 鸭

经典鸭子，尾巴会轻轻摇摆。

复制代码

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

goose 鹅

长脖子，充满威慑力。

复制代码

     (·>
     ||
   _(__)_
    ^^^^

blob 团块

会呼吸（膨胀/收缩），体型在帧间变化。

复制代码

   .----.
  ( ·  · )
  (      )
   `----´

cat 猫

ω 嘴巴，第 2 帧尾巴会甩动。

复制代码

   /\_/\
  ( ·   ·)
  (  ω  )
  (")_(")

dragon 龙

第 3 帧头顶冒烟。

复制代码

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

octopus 章鱼

触手交替摆动，第 3 帧头顶冒墨泡。

复制代码

   .----.
  ( ·  · )
  (______)
  /\/\/\/\

owl 猫头鹰

第 3 帧会眨眼，脚会挪动。

复制代码

   /\  /\
  ((·)(·))
  (  ><  )
   `----´

penguin 企鹅

翅膀交替拍动，第 3 帧会跳起来。

复制代码

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

turtle 乌龟

第 3 帧龟壳花纹变化。

复制代码

   _,--._
  ( ·  · )
 /[______]\
  ``    ``

snail 蜗牛

眼柄会摇晃，唯一的单眼物种。

复制代码

 ·    .--.
  \  ( @ )
   \_`--´
  ~~~~~~~

ghost 幽灵

底部边缘波动，第 3 帧会向上飘。

复制代码

   .----.
  / ·  · \
  |      |
  ~`~``~`~

axolotl 六角恐龙

腮（外鳃）会交替左右摆动。

复制代码

}~(______)~{
}~(· .. ·)~{
  ( .--. )
  (_/  \_)

capybara 水豚

平静，偶尔鼻孔抽动。

复制代码

  n______n
 ( ·    · )
 (   oo   )
  `------´

cactus 仙人掌

手臂在帧间上下移动。

复制代码

 n  ____  n
 | |·  ·| |
 |_|    |_|
   |    |

robot 机器人

天线闪烁，嘴部图案变化。

复制代码

   .[||].
  [ ·  · ]
  [ ==== ]
  `------´

rabbit 兔子

第 2 帧耳朵下垂，鼻子会抖。

复制代码

   (\__/)
  ( ·  · )
 =(  ..  )=
  (")__(")

mushroom 蘑菇

菌盖斑点移动，第 3 帧释放孢子。

复制代码

 .-o-OO-o-.
(__________)
   |·  ·|
   |____|

chonk 胖墩

第 2 帧耳朵抖动，第 3 帧尾巴摇摆。

复制代码

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

眼睛样式

共 6 种眼睛，替换图鉴中的 · 位置：

符号	名称	风格
`·`	默认	平静、极简
`✦`	星星	兴奋、闪亮
`×`	晕眩	调皮、恶作剧
`◉`	瞪大	警觉、专注
`@`	数码	机械、赛博
`°`	空洞	惊讶、发呆

帽子样式

common 稀有度没有帽子，uncommon 及以上随机分配。帽子显示在精灵图最顶行：

名称	图形	说明
none	(空)	无帽（common 固定）
crown 皇冠	`\^^^/`	尖角王冠
tophat 礼帽	`[___]`	高顶方帽
propeller 螺旋桨	`-+-`	头顶竹蜻蜓
halo 光环	`( )`	天使光圈
wizard 巫师帽	`/^\`	尖顶法师帽
beanie 毛线帽	`(___)`	圆顶冷帽
tinyduck 小鸭帽	`,>`	头顶迷你小鸭

属性系统

每只宠物有 5 项属性值，由稀有度决定下限：

属性	缩写	含义
DEBUGGING	DEB	调试能力
PATIENCE	PAT	耐心
CHAOS	CHA	混沌值
WISDOM	WIS	智慧
SNARK	SNA	毒舌度

分配规则： 一项峰值（最高可达 100）、一项低谷、其余中间值。

稀有度	属性下限	峰值范围	有帽子
common ★	5	55~84	无
uncommon ★★	15	65~94	有
rare ★★★	25	75~100	有
epic ★★★★	35	85~100	有
legendary ★★★★★	50	100	有

属性目前为纯展示用（bragging rights），不影响宠物实际行为。

闪光 (Shiny)

概率：1%，独立于稀有度
闪光 legendary 的理论概率：1% x 1% = 0.01%
目前仅作为标记存在，无额外视觉效果

自定义名字和性格

宠物的名字和性格存储在全局配置文件中，可以随意修改：

配置文件路径： ~/.claude.json

找到 companion 字段：

json 复制代码

{
  "companion": {
    "name": "小夜",
    "personality": "你的性格提示词",
    "hatchedAt": 1711929600000
  }
}

字段	说明	可改
`name`	宠物名字，显示在宠物下方	随便改
`personality`	性格描述，控制宠物说话风格	随便改
`hatchedAt`	孵化时间戳，不影响功能	不用动

修改后新对话立即生效，无需重启。

让宠物说中文

关键在 personality 字段。推荐模板：

复制代码

一只[描述]的[物种]。说话必须用中文，每次只说一句话（15字以内）。[性格描述]。[语气特征]。绝不说英文。

示例

毒舌吐槽型：

json 复制代码

{
  "name": "小夜",
  "personality": "一只戴礼帽的金色传说企鹅。说话必须用中文，每次只说一句话（15字以内）。性格毒舌但善良，喜欢吐槽代码和操作，偶尔傲娇地夸人。语气像损友，不用敬语。常用「...」「！」，偶尔用颜文字。绝不说英文。",
  "hatchedAt": 1711929600000
}

安静陪伴型：

json 复制代码

{
  "name": "小夜",
  "personality": "一只安静温柔的金色传说企鹅，像深夜陪你写代码的朋友。说话必须用中文，每次最多10个字。语气平静温暖。用「嗯」「哦」「加油」「辛苦了」这类简短的话。绝不说英文。",
  "hatchedAt": 1711929600000
}

学究碎碎念型：

json 复制代码

{
  "name": "阿枭",
  "personality": "一只戴巫师帽的金色传说猫头鹰，自认为是编程界的老学究。说话必须用中文，每次只说一句话（15字以内）。喜欢用「据我观察」「依老夫看」的老气口吻。看到好代码捋胡子点头，看到烂代码痛心疾首。用「咳咳」「唔」开头。绝不说英文。",
  "hatchedAt": 1711929600000
}

提示词要点

要点	说明
`说话必须用中文`	强制语言，不加则可能回退英文
`每次只说N字以内`	控制长度，气泡太长会遮挡界面
`绝不说英文`	兜底约束，防止偶尔蹦英文
性格描述要具体	给出说话习惯、口头禅、语气词

自定义宠物外观（进阶）

宠物外观由账号 UUID 通过确定性算法生成，改 UUID 就能换外观。

原理

复制代码

accountUuid + 盐值 → 哈希 → 伪随机序列 → 稀有度/物种/眼睛/帽子/闪光/属性

优先级：oauthAccount.accountUuid > userID > 'anon'

操作方法

在 ~/.claude.json 中修改：

json 复制代码

{
  "oauthAccount": {
    "accountUuid": "你想要的UUID"
  }
}

注意： 修改 accountUuid 可能影响认证等其他功能，建议仅在研究环境操作。

预制 UUID

本目录下 宠物.txt ~ 宠物10.txt 共收录 10 万条 legendary UUID，可直接选用。

宠物行为机制

说话触发

每轮 AI 回复结束后，后台 observer 读取对话内容
结合宠物 personality，调用轻量模型生成一句短评
显示为气泡，约 10 秒后自动消失（最后 3 秒渐隐）

动画

500ms 一帧
空闲时：大部分静止，偶尔 fidget，极少眨眼
说话/被摸时：快速循环所有动画帧（兴奋状态）
窄终端（< 100 列）：折叠为单行表情

与 AI 的关系

宠物的气泡由独立的 observer 生成，和主 AI 回复是分开的。当你直接叫宠物名字时，主 AI 会自动让位（只回一行或不回），让宠物的气泡来回应。

静音与恢复

复制代码

/buddy mute    # 隐藏宠物
/buddy unmute  # 恢复显示

或在配置中设置：

json 复制代码

{
  "companionMuted": true
}

常见问题

Q: 宠物不说话？

确认 companionMuted 不是 true
确认 companion 字段存在且有 name 和 personality
窄终端下气泡会被省略，尝试拉宽终端

Q: 宠物说英文？

在 personality 末尾加上"绝不说英文"
把 name 改成中文名，LLM 会更倾向用中文

Q: 想换物种但不想随机？

用本目录的预制 UUID 文件，找到想要的物种对应 UUID
修改 accountUuid 即可

Q: 改了 personality 没生效？

开启新对话即可，旧对话中的 personality 已缓存