使用 Claude Code、Codex CLI 等 AI Agent 编写代码时，最令人困扰的是什么？终端日志飞速滚动，稍不注意就无法判断 Agent 卡在了哪一步。当你输入“帮我重构这个模块”后，只能在屏幕前干等，完全不清楚它是在思考、运行测试，还是已经陷入停滞。
今天分享一个近期在 GitHub 上热度很高的开源项目——Clawd-on-desk。它本质上是一款面向开发者的桌面宠物，但不同于传统卖萌桌宠，Clawd-on-desk 能够自动感知 AI Agent 的实时运行状态，只需余光一瞥，就能知道 Agent 正在思考、调用工具，还是已经完成任务。
01. 项目简介
Clawd-on-desk 本质上是一款专门为 AI Agent 设计的桌面宠物应用。普通桌宠仅具备动画效果，而它能够实时监听 Claude Code、Codex CLI、Cursor Agent、Qwen Code、opencode 等多种 CLI/Agent 的会话状态，并将这些状态转化为桌面上的动态视觉反馈：
- 当你提交 prompt 后，桌宠立即进入思考状态，一眼就能看出 AI 正在处理请求。
- Agent 调用工具、执行命令或修改文件时，桌宠切换为打字或工作动画，直观显示忙碌状态。
- 当子 Agent 并行运行时，桌宠显示独特动画，清晰提示后台任务正在并发执行。
- Agent 请求权限时，桌面弹出审批气泡，点击允许或拒绝即可，无需切换到终端寻找确认提示。
- 任务顺利完成，桌宠自动播放庆祝动画，比传统提示音更加直观醒目。
- 当你离开电脑或开启免打扰模式，桌宠自动进入睡眠状态，避免干扰。
除了状态可视化功能，Clawd-on-desk 最具实用性的当属权限审批气泡。当 Claude Code、Codex CLI、CodeBuddy、opencode 等工具发起权限请求时，桌宠会弹出浮动审批卡片，你可以直接点击允许或拒绝，无需时刻紧盯终端等待确认，大大提升了开发效率。
如果你在远程服务器上运行 Claude Code 或 Codex CLI，同样可以无缝使用。Clawd-on-desk 支持将远程状态和权限请求转发到本地桌面。此外，它还提供了 Mobile / PWA 功能：开启后，通过手机访问配对链接，即可实时查看本机 Agent 的会话状态。一边刷手机一边掌握 Agent 进度，体验非常流畅。
Clawd-on-desk 内置了三套默认主题：
- Clawd：像素螃蟹风格，带有复古气息。
- Calico：三花猫主题，走萌系可爱路线。
- Cloudling：云宝主题，造型轻盈讨喜。
更令人惊喜的是，Clawd-on-desk 支持自定义主题，并可导入 Codex Pet 动画包。如果你喜欢DIY桌宠或像素动画，这个项目具有很高的可玩性。
02. 项目实测
上手非常简单：下载对应操作系统的安装包并运行，然后启动你的 AI Agent 即可。
case 1 完整跑一个任务
在标准任务流程中，桌宠的状态切换非常直观：从思考到工作，再到完成后的庆祝动画，整个过程一目了然。
case 2 权限气泡
当 Agent 需要获取权限时，桌宠会在最上层显示审批气泡，直接点击即可处理，无需再费力在终端中寻找确认提示。
case 3 错误状态
当任务出错时，桌宠会切换到对应的错误形态，让你一眼就能发现异常所在。
case 4 远程控制
Clawd-on-desk 的远程控制功能非常实用。只需在程序中填写你的 VPS 信息即可。
填写完毕后，点击连接按钮即可建立通信。
首次使用需要点击“首次认证”按钮进行链接。成功链接并安装 HOOK 后，远程运行 Agent 时即可在本地审批权限。
这里有一个小提示：远端服务器建议使用私钥登录。如果使用密码登录，可能会持续显示如下错误提示：[fail] 创建远端 hook 目录 - root@000.000.000.000: Permission denied (publickey,password)。
case 5 手机伴侣
在 Clawd-on-desk 设置中开启 Mobile / PWA 功能后，使用手机打开配对链接。
打开链接后，手机上即可显示各个 Agent 项目的运行状态。无论你是外出还是坐在沙发上刷手机，都能随时掌握进度。
03. 挖一挖
根据 Stack Overflow 2025 年度调查数据，专业开发者中有 14.9% 每天在工作中使用 AI Agent，9.2% 每周使用，7.7% 偶尔使用；在这些使用 Agent 的开发者中，83.5% 将其应用于软件工程任务。这一渗透率表明 AI Agent 在开发领域的普及程度已经相当高。
然而，调查也显示 87% 的受访者担心 Agent 输出的准确性，81% 的受访者顾虑安全和隐私问题。
这些数据揭示了一个现实问题：开发者愿意使用 Agent，但同时需要能够看到 Agent 的具体行为。Clawd-on-desk 并不负责编写代码，它的核心功能是将 Claude Code、Codex CLI 等 Agent 的运行状态、权限请求以及远程会话信息实时同步到桌面。
对于个人开发者而言，Clawd-on-desk 最直接的价值在于减少反复切换终端的频率，避免错过权限请求、误判进度以及远程任务不透明所导致的问题成本。当 AI Agent 成为开发环境中的常驻工具时，状态可视化、权限可控、远程可接管将成为 AI 编程工作流的基础体验。
而 Clawd-on-desk 以一种有趣的方式实现了这一切。
