Claude Pet 项目说明

Claude Pet 是一个陪伴 Claude Code 使用的 Windows 桌面宠物。它不是单纯放在桌面上的装饰，而是会跟随 Claude Code 的工作状态变化，用更直观、更轻松的方式提醒你：Claude 现在在做什么、有没有卡住、是否需要你确认权限，或者任务是不是已经完成了。

简单来说，它就像一个常驻桌面的“小助手”，帮你把 Claude Code 里比较容易错过的信息，变成桌面上的动画、气泡和弹窗提醒。

如何开始？

此项目模仿codex 的桌宠而来，你可以喂给codex一张图片，让codex帮你生成一些图片以及状态机，弄出有些粗糙的动画效果（其实我这个做了高清版，但是受模型生图一致性限制效果一般）。再用ai读取此项目文档形成可加载的图包。

它可以做什么？

1. 在桌面上显示一个会动的宠物

启动后，Pet 会出现在桌面上，并保持在其他窗口上方。它会根据 Claude Code 的状态做出不同反应：

• 空闲时安静待机
• Claude 开始工作时切换到工作动画
• 等待用户输入或审批时显示等待状态
• 任务完成时做出完成反馈
• 出错时进入失败提示状态
• Claude 回复结束后显示对应状态

这样你不用一直盯着终端，也能大概知道 Claude Code 当前是不是还在处理任务。

2. 显示 Claude Code 的实时状态气泡

宠物旁边会有一个状态框，用来显示当前项目和任务状态，例如：

• 当前连接的是哪个项目
• Claude 正在调用什么工具
• 是否正在等待权限
• 当前任务进度是多少
• 是否有待处理审批

状态框可以点击：如果有审批，会打开审批窗口；如果没有审批，会尝试把你带回对应的 Claude Code 终端。

3. 处理 Claude Code 的权限审批

当 Claude Code 需要权限，比如运行命令、访问文件、执行某些工具时，Pet 可以弹出审批窗口，让你直接在桌面上处理。

支持的操作包括：

• 允许一次
• 始终允许当前建议范围
• 拒绝请求
• 输入拒绝理由
• 跳转回对应 Claude Code 终端查看详情

这比只在终端里等权限提示更醒目，也更适合你在切换窗口、做别的事情时及时发现请求。

4. 在 Claude 等你选择时弹出选项窗口

如果 Claude Code 需要你从几个选项中选择下一步，Pet 会显示一个选择窗口。

你可以直接点击选项，Pet 会把选择发送回对应的 Claude Code 终端。如果它识别不到选项，也会提示你回到终端手动处理。

这个功能适合那些 Claude 需要用户确认方向、选择方案或继续下一步的场景。

5. 出错后帮助恢复任务

当 Claude Code 出现停止失败、连接中断等情况时，Pet 会弹出恢复窗口，提示你当前任务可能中断。

恢复窗口里可以：

• 查看出错信息
• 回到对应终端
• 一键发送“继续任务”，尝试让 Claude Code 接着做下去

它不能保证所有中断都能自动恢复，但可以减少你手动找终端、复制指令、重新输入的麻烦。

6. 支持多个 Claude Code 会话

如果你同时开了多个 Claude Code 会话，Pet 会记录不同会话的状态，并在托盘菜单里列出来。

你可以从菜单里看到：

• 哪个项目正在工作
• 哪个项目在等待
• 哪个项目有审批
• 当前是否有多个待处理请求

点击对应会话后，Pet 会尝试聚焦到相关终端窗口。

7. 可以自定义外观和显示方式

Pet 支持一些桌面使用习惯上的调整：

• 调整宠物大小
• 拖动宠物位置
• 拖动状态框位置
• 设置状态框大小
• 隐藏或显示状态框
• 暂停状态框自动弹出
• 开关提示音
• 设置审批窗口自动弹出，或改成点击状态框再打开
• 切换宠物形象
• 打开图包安装目录，添加自定义宠物图包

也就是说，它不是固定死的桌面挂件，而是可以根据你的屏幕布局和使用习惯调整。

8. 常驻系统托盘，方便管理

Pet 会在系统托盘里提供菜单，方便你快速操作：

• 显示或隐藏 Pet
• 显示或隐藏状态框
• 查看 Claude Code 会话
• 查看待审批请求
• 调整宠物大小
• 调整状态框大小
• 切换宠物形象
• 打开日志
• 复制当前项目路径
• 开关自动打开
• 退出程序

平时它可以安静地待在桌面和托盘里，需要时再提醒你。

适合什么场景？

这个项目适合经常使用 Claude Code 的人，尤其是这些情况：

• Claude Code 经常长时间执行任务，你不想一直盯着终端
• 权限审批提示容易被忽略
• 同时开多个项目或多个 Claude Code 会话
• 希望用更直观的方式知道 Claude 是否在工作、等待或出错
• 想让 Claude Code 的使用体验更轻松一点、更有陪伴感

总结

Claude Pet 的核心作用，是把 Claude Code 原本藏在终端里的状态，搬到桌面上来。

它可以陪着你看 Claude 工作、提醒你处理权限、帮你回到对应终端、在出错时提示恢复，还能通过动画和状态框让整个开发过程不那么冷冰冰。它不是替代 Claude Code，而是给 Claude Code 加了一个更直观、更友好的桌面交互层。