桌面宠物不是摆设：Coucou 如何监控 Claude Code 状态与处理审批

让 AI 辅助写代码早就不是新鲜事了。可把任务丢给模型之后，很多人还是忍不住隔一会儿就瞟一眼终端：它还在跑吗？是不是停在等我批准命令？刚才又改了哪些文件？

Coucou 想把这个过程变轻松一些。macOS 上它在刘海位置放了一只叫 Mochi 的小家伙；没有刘海的 Windows、Linux 系统则把入口放在屏幕上方。你不用一直盯着终端，也能查看会话状态、改动记录，还能处理支持的审批请求。它披着桌面宠物的外壳，真正切入的反而是 Agent 工作流程 里“等人接手”的环节。

可爱只是入口，重要的是别漏掉那次等待

Mochi 会眨眼，眼睛会跟着鼠标转，点一下还会短暂眩晕。对开发者来说更实用的地方在于：它能把 Claude Code 的读取、修改、执行状态都收进一个小窗口。文件被改动时，会显示文件名和增删行数，点进去还能看完整 diff。

这么做的意义不是用动画去替换终端，而是降低查看状态的成本。你可以先忙别的事情，等确实需要介入时再切回来。

Claude Code 的权限申请有 Allow、Deny、Always 三种选项；遇到 AskUserQuestion，也可以直接在界面上作答，或者回到终端处理。别把这理解成自动放行：它只是在提供一条人工判断的通道，而不是替你完成所有安全决定。

不是读屏，而是接收事件

在 macOS 上，Coucou 的界面用原生 SwiftUI 和 AppKit 构建，Mochi 则通过 Canvas 绘制。面板后有一段 nb-hook 接收来自 Claude Code 的 hook 事件，再经 Unix socket 转发给应用；审批时等待用户选择，然后把结果回传。

Windows 和 Linux 端使用 Tauri 2。Windows 的事件中继走命名管道，Linux 则用 Unix socket，并不会把 Mac 的窗口原样硬搬到其他平台。

项目目前还接入了 Codex、Cursor、OpenCode、Amp、Hermes 等工具，但各家的事件接口和审批能力并不一致。尤其是 Hermes：能显示状态，不代表当前版本和配置一定支持在 Coucou 里完成权限审批。Windows/Linux 平台文档把审批标注为在 Hermes 中处理，所以在接入之前务必核对对应平台文档，别只看“支持列表”。

离开 Mac，也别让审批一直悬着

iPhone 端围绕 macOS 上运行的会话工作：查看状态、回答问题、发送新命令，还能在锁屏实时活动中处理权限请求，允许操作需要 Face ID。

源码里有一个细节值得留意：手机返回的结果必须与当前等待请求的“指纹”匹配，这个指纹包含会话、工具、命令等信息。过时的决定，或者针对另一条命令的决定，都不会被直接采用。手机端只给出允许或禁止两个选项，不支持 Always。

真正重要的不是“手机上能点确认”，而是远程审批到底批准了什么。会话同步使用用户自己的私有 CloudKit 数据库，项目名、命令等敏感信息用 iCloud 密钥加密；实时活动通知通过 Cloudflare Worker 完成。官方解释中继只能看到代理名称和状态，这并不构成完全离线方案，但也不需要注册 Coucou 账号。

小组件同样可以展示 Agent 和服务的状态，GitHub、Vercel、Stripe 等都能作为选项，不必把所有服务都接上才能使用会话面板。

聊天、监控、审批不能混为一谈

Coucou 也带聊天功能，可以放文件进去，然后向 模型 提问。云端模型需要你自己的 API key；本地模型则连接已经运行好的 Ollama 或 LM Studio。不同平台支持的能力有差异，不能把 README 里 macOS 的操作直接照搬到 Windows 或 Linux 上。

在我看来，它更像是给现有工具增加一个轻量入口，而不是重新做一个编程 Agent。模型、代码执行和主要工作仍由原工具完成，Coucou 只负责把当前状态和需要你反应的时机展示出来。

先试演示，再接真实会话

普通用户可以从官方 Releases 获取对应系统版本。macOS 需要 15 及以上；Windows 可选 10 或 11，但官方说明下载包尚未经过数字签名，下载前请核实来源和校验信息。不能把开源等同于安全保证。

如果不想一开始就配置密钥和钩子，可以打开 Settings → General → Demo，选择 Try demo mode，就能看到会话流程、差异对比、审批、问答和服务卡片。不过演示使用的是脚本和样例数据，并不等同于真实 Agent 运行结果。

正式接入 Claude Code 会话时，再到设置里安装 hooks。官方提到安装器会备份配置、合并 hooks，并在写入前显示差异。聊天 API key 和会话接入也是两码事：查看编程会话，并不需要先买一套聊天 API。

要让 iPhone 与 Mac 联动，需满足这些条件：iOS 18 及以上、Mac 端 Coucou 0.1.9 及以上、两端登录同一个 Apple Account。官方目前提供了 TestFlight 入口，但 README 注明测试资格可能尚未开放，App Store 版本也不能视为已正式发布。

最让我感兴趣的，并不是给 Agent 加一个卖萌形象，而是把“AI 正在工作”和“此刻需要人来选择”清楚地区分开。少盯几次终端，不等于少管几次权限。一个好的入口应该让你更能介入其中，而不是让你更随意地放行。

项目地址：https://github.com/Louis-CFM/coucou