AI Claude Pet 使用说明

文章链接：https://blog.csdn.net/qq_43201350/article/details/162233408

🐱ClaudePet

陪你写代码的桌面虚拟宠物(Electron 小部件),跟 Claude Code 集成。

一、它是什么

一个住在桌面角落的像素宠物,会根据你的Claude Code使用情况反应。像电子鸡一样养:喂它、陪它玩、抚摸它,看它从 Baby 长大成 Adult。

三种状态条 :🍗 饥饿 / 😊 快乐 / ⚡ 精力

成长阶段 :Baby(幼年) → Teen(100 EXP,青少年) → Adult(500 EXP,成年)

6 种心情表情

心情	表现	触发
😊 Happy	蹦跳	吃饱喝足、快乐值高
🎾 Playful	跳跃	刚陪玩完、精力充沛
😟 Worried	摇晃	快乐低 / 快饿了
😐 Bored	晃荡	很久没搭理它
😴 Sleepy	歪头	精力耗尽
😵 Confused	晃动	API 限流或连不上

二、唤起宠物的三种方式

方式 1:自动启动(默认)✅

开机自动运行,啥都不用做。关闭路径:宠物设置面板 → Auto-start。

方式 2:命令行

claude-pet

已在跑 → 静默退出,不会重复打开
没跑 → 启动并进入托盘驻留

方式 3:桌面快捷方式(推荐)

新建快捷方式,目标填:

D:\Program Files\nodejs\claude-pet.cmd

双击即可唤起,也能固定到任务栏。

三、Claude Code 斜杠命令

在任何 claude 会话里直接输入即可:

命令	效果
`/feed`	喂食,饥饿 -30%,EXP +5
`/play`	玩耍,快乐 +25%
`/pet`	抚摸,饥饿 -10%、快乐 +10%、精力 +10%(性价比最高)
`/name <名字>`	给宠物起名;不带参数显示当前名字

注意:

命令文件已装到 ~/.claude/commands/ ,所有项目通用
新装的命令需要 新开一个 Claude Code 会话 才能识别
首次运行命令 Claude Code 会请求 bash 权限,同意即可

四、实用功能/技巧

界面

Always on Top :右键托盘 → 开启置顶,永远浮在编辑器之上
拖动 :按住宠物直接拖到任意位置,下次启动还在那
系统托盘 :关窗口不退出,托盘静默驻留
4 国语言 :中 / 英 / 韩 / 日,设置里切换

自定义外观

Settings→ Skins,三种皮肤模式:

单图 :一张图走所有心情
Per-mood :每种心情一张图
Sprite sheet :精灵图帧动画

养成技巧

最快涨 EXP : /pet 一条命令影响 3 个属性
保持心情 :只喂不玩会 😟;一直不理会 😐;挂机一夜会 😴
困惑 😵 不用管 :多半是 Anthropic API 限流,自己会好
离线也能养 :本地会扫描 ~/.claude/projects/ 下 JSONL 会话文件估算用量

五、数据来源(它怎么知道你在写代码)

Anthropic OAuth Usage API(每 5 分钟轮询)
       ↓ 限流 429 时降级
本地 JSONL 会话解析(~/.claude/projects/)
       ↓
心情引擎 → 像素动画 + 对话气泡

主路径 :每 5 分钟调用 Anthropic 用量 API
降级路径 :API 限流时扫本地会话文件
交互驱动 :斜杠命令立即反馈,不等轮询

六、关键文件位置

用途	路径
可执行文件	`D:\Program Files\nodejs\claude-pet.cmd`
npm 包	`d:\nvm\v20.19.5\node_modules\claude-pet\`
宠物名	`~/.claude-pet/name.txt`
事件日志 (feed/play/pet)	`~/.claude-pet/events.jsonl`
进程锁	`~/.claude-pet/app.pid`
斜杠命令	`~/.claude/commands/{feed,play,pet,name}.md`
配置(Electron store)	`%APPDATA%\claude-pet\config.json`

手动改名 (不用打开 Claude Code 也能改):

echo "新名字" > ~/.claude-pet/name.txt

改完重启宠物生效。

手动触发事件 (脚本化自动喂养):

echo "{\"type\":\"feed\",\"timestamp\":\"$(date -u +%Y-%m-%dT%H:%M:%S.000Z)\"}" >> ~/.claude-pet/events.jsonl

七、故障排查

看不到窗口

托盘里找 :任务栏右下角 🐱 图标,右键显示
托盘折叠了 :点向上的 ^ 箭头展开
拖屏幕外了 :右键托盘找 reset position,或删配置重启
被遮挡 :开启 Always on Top

检查是否在运行

tasklist | grep electron

看到 4 个 electron.exe 就是它(1 主进程 + 3 渲染/工具进程)。

命令没反应 / 名字没更新

进程可能缓存了旧状态,彻底重启:

taskkill //F //IM electron.exe
claude-pet

PID 锁死

如果 claude-pet 启动后立刻静默退出但实际没跑:

rm ~/.claude-pet/app.pid
claude-pet

宠物状态 😵 Confused

不用管。通常是AnthropicAPI 限流(429),几分钟内自动恢复。

八、安装/卸载(备忘)

安装 (当时由于electron被墙,用了镜像):

export ELECTRON_MIRROR=https://npmmirror.com/mirrors/electron/
npm install -g claude-pet

卸载 :

npm uninstall -g claude-pet
rm -rf ~/.claude-pet
rm ~/.claude/commands/{feed,play,pet,name}.md

九、参考

项目主页:https://github.com/scm1400/claude-mama
作者:scm1400
版本:v1.0.0(2026-03 发布)
许可证:ISC

宠物正在陪你写代码 🐾*