Claude Code Tamagotchi

Claude Code Tamagotchi是一个住在你Claude Code状态栏里的数字小伙伴，陪你敲代码、做项目，像经典电子宠物一样有情绪、有需求，但又不止于“陪伴”。

对开发者来说，它不是挂在钥匙链上的小玩具，而是扎根在你工作场景里的“智能伙伴”：既能在你连续编码时提醒吃饭、在修复bug时为你开心，更核心的是，它内置了实验性的行为强制系统——相当于给Claude Code装了一道“安全网”，能实时监控Claude的操作行为，检测并阻止违反你指令的操作，让AI始终按你的要求行事。

举个超真实的场景：凌晨2点你还陷在调试里，状态栏里的宠物突然弹出想法：💭 "嘿……我们已经这样搞了 4 个小时了。或许吃个点心回来，bug 还在那儿？"
它既是编码搭子、生活教练，更是Claude Code的“行为监督员”。

核心亮点：实验性行为强制系统

这个功能是Claude Code Tamagotchi的核心价值，目前还在持续优化中（可能偶尔误判合法操作），但能实实在在帮你管控Claude的操作：

• 核心作用：实时监控Claude Code的行动，检测偏离指令的行为，甚至中断违规操作，实现AI操作的“问责制”。
• 反馈优化：如果遇到“误报”（合法操作被阻止），欢迎提交issue反馈，需包含3类信息：
  ✅ Claude试图执行的操作
  ✅ 你实际的指令要求
  ✅ 系统弹出的违规提示信息
  每一份反馈都能帮助我们优化违规检测逻辑，让它更智能、更精准。

AI驱动的行为监控：不止陪伴，更会“监督”

宠物的智能体现在两大核心系统，能给你实时反馈：

1. 实时情境化观察

宠物会根据Claude的操作生成贴合场景的想法，还会随行为变化情绪：

• 想法示例：
  💭 "GroqClient.ts？那……实际上是答案所在的地方！"
  💭 "又回到 README.md 了？那里一定有黄金！"
  💭 "又是 AnimationManager.ts？这只宠物快转晕了！"
• 情绪变化：
  😊 开心：Claude完美遵循指令时
  😕 担忧：Claude似乎偏离任务时
  😠 恼怒：Claude做了与要求不符的事时
  😡 愤怒：Claude反复忽略你的请求时

2. 违规检测（实验性）

启用后可提前阻止有害操作，常见违规类型如下：

真实案例：违规系统曾捕获Claude试图在未被要求的情况下提交更改，成功阻止了这次越权操作！

快速开始：30秒安装Claude Code电子宠物

前置准备

• Claude Code：你的AI编码工具
• Bun：轻量快速的JavaScript运行时（安装命令：curl -fsSL https://bun.sh/install | bash）
• 一颗愿意养宠物的耐心❤️

30秒极简安装

# 全局安装
bun add -g claude-code-tamagotchi

# 编辑Claude Code配置文件：~/.claude/settings.json
{
  "statusLine": {
    "type": "command",
    "command": "bunx claude-code-tamagotchi statusline",
    "padding": 0
  }
}

# 配置完成，你的宠物就活啦！🎉

三种安装选项（按需选择）

✅ 选项1：全局安装（最简单，基础功能）

# npm安装
npm install -g claude-code-tamagotchi
# 或Bun安装
bun add -g claude-code-tamagotchi

# 同步更新~/.claude/settings.json（同上）

⚠️ 注意：全局安装仅包含「状态栏宠物」「CLI交互命令」，无「Claude Code斜杠命令」「默认违规检测」。

✅ 选项2：克隆仓库（完整功能，推荐）

# 克隆仓库
git clone https://github.com/Ido-Levi/claude-code-tamagotchi.git
cd claude-code-tamagotchi

# 运行自动设置脚本（一键搞定所有配置）
./setup.sh
# 脚本会自动完成：
# - 安装依赖包
# - 配置/pet-*系列斜杠命令
# - 设置状态栏显示
# - 安装违规检测钩子
# - 宠物直接可用！

✅ 选项3：手动设置（适合追求完全掌控的开发者）
如需自定义安装流程，可查看项目仓库的完整手动设置说明。

开启违规检测（全局安装必看）

若你选择全局安装但想使用违规检测功能，需额外两步配置：

1. 在shell配置文件中启用功能：

export PET_VIOLATION_CHECK_ENABLED=true

2. 给~/.claude/settings.json添加预钩配置：

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "*",
        "hooks": [
          {
            "type": "command",
            "command": "bunx claude-code-tamagotchi violation-check"
          }
        ]
      }
    ]
  }
}

开启AI功能（让宠物更智能）

✅ 快速设置（30秒搞定）：

# 1. 从https://console.groq.com/keys获取免费GROQ API密钥
# 2. 运行设置脚本
./enable-feedback.sh
# 3. 完成！宠物拥有AI观察/违规检测能力🎉

✅ 手动设置：

# 启用AI实时观察
export PET_FEEDBACK_ENABLED=true
export GROQ_API_KEY="你的GROQ API密钥"

# 启用违规检测
export PET_VIOLATION_CHECK_ENABLED=true

💡 为什么选GROQ？

• ⚡ 50ms极速响应：实时反馈无延迟
• 💰 成本极低：个人使用几乎免费
• 🚀 定制芯片：专为即时LLM推理设计

🎮 如何与宠物互动？三种方式超便捷

1. Claude Code斜杠命令（内置操作）
   所有命令以/pet-开头，直接在Claude Code中使用：

• /pet-feed pizza - 喂宠物吃披萨（支持多种食物）
• /pet-play ball - 和宠物玩球（支持多种玩具）
• /pet-pet - 抚摸宠物
• /pet-clean - 给宠物洗澡
• /pet-sleep - 哄宠物睡觉
• /pet-wake - 叫醒宠物
• /pet-stats - 查看宠物完整状态（附护理建议）
• /pet-name Buddy - 给宠物改名
• /pet-help - 查看所有命令
• /pet-reset - 重置宠物（谨慎操作！）

2. CLI命令（任意终端可用）
   全局安装后，在任何终端都能操作：

# 喂宠物
claude-code-tamagotchi feed pizza

# 和宠物玩耍
claude-code-tamagotchi play ball

# 查看宠物状态
claude-code-tamagotchi stats

# 抚摸宠物
claude-code-tamagotchi pet

# 给宠物取名
claude-code-tamagotchi name "Mr. Fluffkins"

3. 可选食物/玩具清单

• 食物：pizza、cookie、sushi、apple、burger、donut、ramen、taco、ice_cream、salad
• 玩具：ball、frisbee、puzzle、laser、rope、bubbles、feather、mouse_toy

🐶 读懂你的宠物：状态与情绪全解析

宠物的情绪表情

从面部表情就能判断宠物状态：

• (◕ᴥ◕)/(◕ᴗ◕) - 开心且状态良好
• (◕‿◕) - 超级开心
• (-ᴥ-) - 睡着了
• (◕︵◕) - 难过（需要关注！）
• (@_@) - 身体不舒服

核心状态值（低于30%会触发⚠️警告）

• 🍖 饥饿度：随编码时长下降，及时投喂！
• ⚡ 精力值：随时间消耗，让宠物睡觉恢复！
• 🧼 清洁度：会逐渐变脏，定期洗澡！
• ❤️ 幸福度：综合评分，尽量保持高位！

趣味想法系统

宠物会根据上下文分享“心里话”，覆盖这些场景：

• 吐槽你的代码：“又一个TODO注释？真的吗？”
• 表达自身需求：“我的肚子咕咕叫了！”
• 输出“人生哲学”：“分号会梦见行尾吗？”
• 提醒工作习惯：“自从你上次休息，已经过去 47 次更新了……”
  这些想法并非随机，会贴合当前编码场景、宠物情绪变化。