首页分享 Claude Code 宠物 (Buddy) 配置教程

Claude Code 宠物 (Buddy) 配置教程

来源：萌宠菠菠乐园时间：2026-04-05 07:08

Claude Code 宠物 (Buddy) 配置教程

claude-code安装指令

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

什么是 Buddy

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

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

快速开始

1. 孵化宠物

在 Claude Code 中输入：

/buddy 1

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

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

全部物种图鉴

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

duck 鸭

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

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

长脖子，充满威慑力。

(·> || _(__)_ ^^^^ 1234 blob 团块

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

.----. ( · · ) ( ) `----´ 1234 cat 猫

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

/_/ ( · ·) ( ω ) (")_(") 1234 dragon 龙

第 3 帧头顶冒烟。

/^ /^ < · · > ( ~~ ) `-vvvv-´ 1234 octopus 章鱼

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

.----. ( · · ) (______) //// 1234 owl 猫头鹰

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

/ / ((·)(·)) ( >< ) `----´ 1234 penguin 企鹅

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

.---. (·>·) /( ) `---´ 1234 turtle 乌龟

第 3 帧龟壳花纹变化。

_,--._ ( · · ) /[______] `` `` 1234 snail 蜗牛

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

· .--. ( @ ) _`--´ ~~~~~~~ 1234 ghost 幽灵

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

.----. / · · | | ~`~``~`~ 1234 axolotl 六角恐龙

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

}~(______)~{ }~(· .. ·)~{ ( .--. ) (_/ _) 1234 capybara 水豚

平静，偶尔鼻孔抽动。

n______n ( · · ) ( oo ) `------´ 1234 cactus 仙人掌

手臂在帧间上下移动。

n ____ n | |· ·| | |_| |_| | | 1234 robot 机器人

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

.[||]. [ · · ] [ ==== ] `------´ 1234 rabbit 兔子

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

(__/) ( · · ) =( .. )= (")__(") 1234 mushroom 蘑菇

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

.-o-OO-o-. (__________) |· ·| |____| 1234 chonk 胖墩

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

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

眼睛样式

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

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

帽子样式

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

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

属性系统

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

属性缩写含义DEBUGGINGDEB调试能力PATIENCEPAT耐心CHAOSCHA混沌值WISDOMWIS智慧SNARKSNA毒舌度

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

稀有度属性下限峰值范围有帽子common ★555~84无uncommon ★★1565~94有rare ★★★2575~100有epic ★★★★3585~100有legendary ★★★★★50100有

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

闪光 (Shiny)

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

自定义名字和性格

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

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

找到 companion 字段：

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

json

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

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

让宠物说中文

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

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

毒舌吐槽型：

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

json

12345

安静陪伴型：

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

json

12345

学究碎碎念型：

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

json

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

自定义宠物外观（进阶）

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

原理

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

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

操作方法

在 ~/.claude.json 中修改：

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

json

12345

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

预制 UUID

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

宠物行为机制

说话触发每轮 AI 回复结束后，后台 observer 读取对话内容结合宠物 personality，调用轻量模型生成一句短评显示为气泡，约 10 秒后自动消失（最后 3 秒渐隐）动画 500ms 一帧空闲时：大部分静止，偶尔 fidget，极少眨眼说话/被摸时：快速循环所有动画帧（兴奋状态）窄终端（< 100 列）：折叠为单行表情与 AI 的关系

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

静音与恢复

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

或在配置中设置：

{ "companionMuted": true }

json

123

常见问题

Q: 宠物不说话？

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

Q: 宠物说英文？

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

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

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

Q: 改了 personality 没生效？

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

Claude Code 宠物 (Buddy) 配置教程