← 返回列表

Agent 用法 GitHub · qing-turnaround/claude-chan

用 claude-chan 桌宠在桌面上批准 Claude Code 权限，不用切回终端

打开一个会动的桌面宠物，Claude Code 工作时它打字、要权限时它举手，在卡片上点一下即可允许或拒绝命令。

开始尝试

效果

README 内嵌了动作（Cheer / Wave / Stretch / Snack / Walk）与状态 GIF、菜单与设置截图，以及各服装角色设定图；支持五套服装（Hoodie / Scholar / Maid / Spark Spirit / Clawd），推荐帖附演示视频，本站不托管截图或视频。

这是什么

新在哪里：以前批准 Claude Code 的权限要切回终端看提示、做选择；现在权限卡片直接弹在桌面宠物旁边，点一下 Allow / Always allow / Deny，或在她举手时双击头部就能放行。

怎么做到的：从 Releases 下载对应平台安装包并启动；右键宠物勾选 Link Claude Code，它会自动在 ~/.claude/settings.json 添加 7 个 hooks（用系统自带 curl 转发事件，首次修改前备份为 settings.json.claude-chan.bak）；之后 Claude Code 运行时宠物按状态反应，权限请求以卡片显示命令或文件与要改动的行，点 Allow / Always allow（带 Claude Code 建议的规则）/ Deny，或在举手时双击头部允许一次。

适合谁
经常使用 Claude Code、希望不切终端就能处理权限请求的开发者。
能帮你
把 Claude Code 的权限确认搬到桌面宠物上，减少在终端与其它窗口间来回切换。

评分 三项分开看，不合成总分；热度不等于好用

新颖性
全新做法 · 2026-10-20 出现
热度
未知
易上手
很容易上手
怎么评的

三项都由本站记录的事实按固定规则算出，编辑不能直接改档位；规则改动会写进更新说明。

新颖性

  • ●●● 全新做法，且有来源依据的出现时间在最近 30 天内
  • ●●○ 老工具新用法或近期刚开放，且有来源依据的时间在最近 30 天内
  • ●○○ 出现时间超过 30 天、未核实到精确日期，或已不再是新做法
  • 其他 出现时间未核实、晚于今天，或新颖类型未核实时按最低一档处理，不靠猜测加分

热度

  • ●●● 最近一次每周人工确认为“热门”：最近 14 天里独立讨论、实际案例、持续时间、传播平台、相对关注五项门槛全部满足（规则 heat-v1）
  • ●●○ 最近一次人工确认为“观察中”：前三项至少一项达到，或讨论增长 ≥ 50%，且至少 2 个独立案例
  • ●○○ 最近一次人工确认为“未进入跟踪”
  • 其他 还没有人工确认过的热度记录时显示“未知”。热度只统计本站已接入的信源，不代表全网

易上手

  • ●●● 准备门槛低且难度入门：不需要新账号或付费，首次尝试不超过 30 分钟，公开可用，会复制粘贴即可
  • ●●○ 准备门槛中等，或门槛低但需要改少量代码或配置
  • ●○○ 准备门槛高：需要商业软件或付费服务、首次尝试超过 2 小时、特殊硬件或网络、排队或邀请且无替代方案，或需要专业知识
  • 其他 只有介绍、还没有站内步骤，或关键步骤已失效时显示“暂不可试”；门槛未核实时显示“未核实”

怎么尝试

  • 时间 首次约 15 分钟
  • 费用 费用待核验：README 未提到收费，安装包从 GitHub Releases 下载；原站未说明费用。
  • 账号 不需要新账号
  • 环境 Windows 10/11（x64 或 arm64）、macOS（Apple silicon 或 Intel）、Linux（AppImage 或 .deb，需合成桌面环境）；需已安装 Claude Code 2.1.113 或更新版本。
  • 准备 安装包：从 GitHub Releases 下载对应系统版本
  • 准备 Claude Code 2.1.113 或更新版本：权限批准卡片依赖较新版本的权限 hook
  • 准备 系统自带 curl：Link Claude Code 添加的 7 个 hooks 用它转发事件，无需 Node

替代方案：终端内直接回答权限提示。能做到：Claude Code 本身就在终端里询问权限，回答后宠物卡片会自动消失；宠物未运行时 Claude Code 照常在终端询问。；差别：需要在终端与其它窗口间切换，多会话时要逐个查看终端；桌宠方式把请求集中成举手提醒与可点卡片。。

完成替代方案不算复现本实践。

按下面的步骤就能做出第一个结果。复制命令不会自动执行。

  1. 下载并安装对应系统版本

    从 Releases 下载 Windows 的 Claude-chan-Setup-x.y.z-x64.exe（ARM PC 用 -arm64.exe）、macOS 的 Claude-chan-x.y.z-arm64.dmg 或 -x64.dmg、或 Linux 的 Claude-chan-x.y.z-x86_64.AppImage / -amd64.deb。构建尚未签名：Windows 出现 SmartScreen 时点 More info → Run anyway；macOS 首次打开被阻止时到 System Settings → Privacy & Security 点 Open Anyway，或运行 xattr -dr com.apple.quarantine /Applications/Claude-chan.app。

    预期结果：软件安装完成，启动后宠物出现在桌面下方。

  2. 链接 Claude Code

    右键宠物 → 勾选 Link Claude Code。它会在 ~/.claude/settings.json 添加 7 个 hooks，首次修改前把设置文件备份为 settings.json.claude-chan.bak；hooks 用系统自带 curl 转发事件，宠物未运行时它们什么都不做也不会报错。

    预期结果：配置文件出现宠物添加的 hooks，宠物开始随 Claude Code 状态变化。

  3. 跑一次 Claude Code 看状态反应

    在终端里让 Claude Code（2.1.113 或更新版本）思考、运行工具并完成一轮。

    预期结果：宠物盘腿打字；完成一轮后跳起来欢呼。

  4. 在宠物卡片上批准权限

    当 Claude Code 请求权限时，卡片会显示命令或文件与要改动的行，点 Allow、Always allow（带 Claude Code 建议的规则）或 Deny；也可以在她举手时双击她的头部允许一次。

    预期结果：无需切回终端，Claude Code 收到允许或拒绝并继续执行。

  5. （可选）暂停或彻底移除集成

    取消勾选 Link Claude Code 只暂停（hooks 保留，再勾选立即恢复，不必重启正在运行的 Claude Code）；要永久移除用 Settings → Remove from Claude Code，只移除她自己的 hooks。

    预期结果：取消或移除后 Claude Code 回到终端内询问权限的方式。

原始来源：Claude Code 桌宠：举手催你批准权限 ↗