如何5分钟上手Coucou安装、配置刘海守护器的新手完整教程【免费下载链接】coucouA tiny friend that lives in your notch (macOS) or at the top of your screen (Windows, Linux) and keeps an eye on your coding agents: Claude Code, Codex, Cursor, Gemini CLI, Antigravity and more.项目地址: https://gitcode.com/gh_mirrors/co/coucouCoucou 是一款免费开源的刘海守护器一只名叫 Mochi 的软萌小精灵住进你 MacBook 的刘海Windows 和 Linux 上则趴在屏幕顶部帮你 7×24 盯着 Claude Code、Gemini CLI、Antigravity 等 AI 编程助手的每一次会话——它在读什么文件、改了什么代码、跑哪条命令一目了然需要审批权限时点一下 Allow 即可全程不用切出你正在做的事。本教程带你 5 分钟完成 Coucou 安装与核心配置。为什么你需要 Coucou 刘海守护器AI 编程助手干活时最怕什么两件事一是它卡在权限确认上你却在刷网页毫无察觉二是它干完了你不知道干错了你不知道。Coucou 把这些问题变成了抬眼即见 实时会话面板每个 AI 编程助手一个彩色胶囊逐步显示它正在读、写、执行什么✅ 刘海里点按审批Claude Code 的权限请求直接弹出 Allow / Deny 按钮一键放行 直接聊天在刘海面板里就能和 Claude或 Gemini、OpenAI对话 文件拖进来把任意文件拖到刘海Mochi 会变成箱子吃掉它再回答你关于这个文件的问题 隐私设计无遥测、无账号API 密钥存系统钥匙串只访问你自己配置的服务。没有会话运行时它会悄悄隐身鼠标靠近刘海还会探头打招呼 ——监控工具居然还能治愈。快速安装 Coucou三大平台步骤macOS 一键安装步骤macOS 15从项目的 Releases 发布页下载最新的Coucou.zip解压把Coucou.app拖入/Applications启动macOS 询问确认时点击Open。从 0.1.0 升级的用户注意macOS 可能针对你保存的每个密钥弹出一次授权提示输入 Mac 密码并选择Always Allow即可。Windows 与 Linux 获取方式Windows官方安装程序暂时下线微软 Defender 误报未签名安装包复核中。当前建议自行构建几分钟即可只装到当前用户、不弹管理员提示git clone https://gitcode.com/gh_mirrors/co/coucou cd coucou/windows npm install npm run pack # 安装包生成在 windows/release/Linux0.1.1 betax86_64下载 AppImage / .deb / .rpm 任选其一# AppImage发行版通用 chmod x Coucou-Linux-*.AppImage ./Coucou-Linux-*.AppImage # Debian / Ubuntu sudo apt install ./Coucou-Linux-*.deb # Fedora / openSUSE sudo dnf install ./Coucou-Linux-*.rpmPC 上没有刘海所以 Mochi 住在屏幕顶部中央不需要时缩回上边缘。各平台差异详见 windows/README.md。Coucou 配置教程5 分钟完成核心设置点击菜单栏macOS或系统托盘Windows/Linux的 Coucou 图标 →Settings…按下面三张表过一遍即可。第一步安装 Claude Code 钩子最关键进入Settings → Claude Code → Install hooks。Coucou 会先给~/.claude/settings.json做带日期的备份合并自己的钩子配置并把完整 diff 展示给你你确认前不写入任何内容你自己的钩子绝不被改动卸载时只移除 Coucou 的条目。原理是 Coucou 启动时放一个超小的中继程序macOS 的nb-hook/ Windows 的coucou-hook.exe见 windows/hook/它收到 Claude Code 的钩子事件后通过 Unix socket / 命名管道转发给应用。如果 Coucou 没在运行钩子 300 毫秒内直接退出——Claude Code 永远不会被阻塞或拖慢。配置完成后Mochi 就能实时播报你的每个会话了第二步配置 API 密钥与聊天功能配置项用途密钥存放位置Anthropic API key刘海内聊天、文件问答macOS 钥匙串 / Windows 凭据管理器 / Linux Secret ServiceGoogle AI / OpenAI key(macOS)切换其他模型聊天系统钥匙串Gemini CLI、Antigravity 钩子(macOS)这两个助手的独立会话面板各自的Install hooks按钮密钥只存系统级安全存储不落盘、不上传。聊天框上方点击模型名即可切换提供方。第三步挑选常驻胶囊Active PillsSettings → Active pills里勾选你实际使用的工具和助手Gemini CLI、Antigravity、Anthropic、GitHub、Stripe、Vercel、Notion、Cal.com 等它们会以彩色小 Mochi 常驻在刘海旁边没勾选的工具则会话结束即消失。所有胶囊的定义都集中在 NotchBuddy/Sources/App/PillCatalog.swift 这一份单一事实源里维护。日常使用与刘海里的 Mochi 互动你的操作Mochi 的反应鼠标悬停刘海 / 屏幕顶边探头说你好 点击小胶囊展开完整面板悬停 Mochi眨眼、眼睛放大点它一下被捏扁一脸不爽快速点 3 下原地转晕几秒 文件拖到刘海变箱子吃掉文件再问你问题或发邮件(macOS)把 Mochi 拖到某个窗口把该窗口挂成 Claude 的上下文(macOS)权限请求到达弹出 Allow / Deny点完自动回到工作Esc收起面板玩到上头的话大概会变成这样进阶玩法文件拖拽与服务集成把终端输出、日志、合同 PDF 直接拖到刘海Mochi 吞掉后即可在面板里对它提问macOS 上还能一键通过 Mail.app 把文件发出去Stripe、n8n、GitHub、Vercel、Resend、Notion、Cal.com 都内置了轻量轮询器各自占一个彩色胶囊面板空闲时自动暂停、零打扰。更完整的接入与事件字段说明见 docs/INTEGRATIONS.md 与 docs/AGENTS.md——哪怕自研工具只要会往 socket 发 JSON 事件加个coucou_agent字段就能在刘海拥有自己的胶囊。新手常见问题FAQCoucou 会阻塞或拖慢 Claude Code 吗不会。中继程序只给 Coucou 300 毫秒响应时间应用没开、变慢或崩溃都会干净退出权限请求超时也没人回复时Claude Code 照旧在终端里问你工作流完全不受影响。没有刘海的 MaciMac / Mac mini / 外接显示器合盖能用吗能。Mochi 会自动改坐屏幕顶部的一条小栏里功能完全一致。Coucou 会收集我的数据吗无遥测、无账号。密钥只存系统钥匙串唯一的网络请求是发往你自己配置的服务。日志也留在本机如 Windows 的%LOCALAPPDATA%\Coucou\coucou.log。Windows / Linux 功能有缩水吗权限审批反而更强任意终端都支持暂缺邮件发送、拖拽 Mochi 挂窗口、跳转指定终端窗口这几个 macOS 功能详见 windows/README.md。小结到这里你已经完成了 Coucou 刘海守护器的全部上手路径下载安装 → 装 Claude Code 钩子 → 填密钥 → 勾选常驻胶囊实际耗时不到 5 分钟。之后每次 AI 编程助手开工抬眼就能看到它在忙什么、何时需要你点头——把盯 agent这件枯燥的事交给一只会转晕的小精灵吧。【免费下载链接】coucouA tiny friend that lives in your notch (macOS) or at the top of your screen (Windows, Linux) and keeps an eye on your coding agents: Claude Code, Codex, Cursor, Gemini CLI, Antigravity and more.项目地址: https://gitcode.com/gh_mirrors/co/coucou创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
