cc guga

一款由 Claude Code 驱动的轻量级桌面陪伴宠物。 能够根据您的 AI 编码工作流程自动做出反应，并切换闲置与工作动画。

✨ 功能特性

• 🐧 透明且置顶的桌面宠物
• 🖱️ 完全可拖动的伴随窗口
• 🎯 跟随模式 —— 宠物会跟随您的光标在屏幕上移动
• 🚶 自由模式 —— 宠物可以自由行走，并带有重力/掉落物理效果
• 🤖 Claude Code 集成
  • 当您编码或聊天时，自动切换到工作动画
  • 当 Claude 完成任务后，恢复为闲置状态
• 🎨 自定义宠物支持
  • 将符合规范的逐帧精灵表放入 pets/ 文件夹
  • 启动时自动检测
• 🧩 内置角色
  • CSS Slime（史莱姆）
  • CSS Penguin（企鹅）
  • GUGUGAGA（预装精灵宠物）
  • Doro（预装精灵宠物）

---

📦 安装指南

从 Releases 页面下载最新的 exe 安装包进行安装。

系统要求

• Windows 10 及以上版本
• WebView2 运行时（通常系统已预装）

---

🚀 快速上手

1. 安装并启动 cc guga
2. 右键点击宠物
3. 选择：
   • 切换皮肤（Switch Skin）
   • 模式 → 跟随 / 自由（Mode → Follow / Free）
4. 配置 Claude Code 钩子

---

🔌 Claude Code 集成配置

将以下配置添加到 .claude/settings.local.json：

{
  "hooks": {
    "UserPromptSubmit": [{
      "hooks": [{
        "type": "command",
        "command": "安装目录\\resources\\scripts\\hook-working.cmd",
        "timeout": 10
      }]
    }],
    "Stop": [{
      "hooks": [{
        "type": "command",
        "command": "安装目录\\resources\\scripts\\hook-idle.cmd",
        "timeout": 10
      }]
    }]
  }
}

---

🙏 致谢

精灵渲染方案参考了 oc-claw（MIT）。

宠物素材来源于 codexpet.xyz。

---

📥 下载

前往 Releases 下载最新版 cc guga_1.0.0_x64-setup.exe。