ccn 是一个小程序,由 Claude Code 通过 hooks 调用。Claude 完成或需要你时,它会向手机发送推送通知,让你在手机上批准、拒绝或回复。后台不会运行任何东西,任何终端都能用。
01安装与配对
macOS 和 Linux
curl -fsSL https://claudecodenotifier.com/install.sh | sh -s 482913
Windows(PowerShell)
irm https://claudecodenotifier.com/install.ps1 | iex; ccn pair 482913
Windows 支持目前为测试版。
Homebrew
brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn && ccn pair 482913
已安装 Node.js 的用户
npx @touchtap/ccn pair 482913
每行命令都会一次完成 ccn 的安装和配对。若想只安装、不带代码,去掉代码部分(| sh,或 && 之前的部分),稍后再运行 ccn pair CODE。把 482913 换成你手机上的代码。代码有效期 5 分钟,过期后应用会生成新的。配对会在 ~/.claude/settings.json 中添加七项配置,文件中的其他内容保持不变。
02你能得到什么
- Claude 已完成:一轮对话结束的瞬间,立刻推送通知。
- 权限:在手机上允许一次、本次会话内允许,或拒绝。
- 提问:Claude 让你选择时,直接选一个答案。
- 后续回复:Claude 完成后,立刻在手机上发送下一条指令。
如果你在最近 30 秒内有过键盘输入,就不会有任何等待:终端照常询问,手机只收到一条提示。如果你不在,终端会等你在手机上回复,你一碰键盘就不再等待。你可以在应用中为每台电脑调整这些时间设置。
03命令
ccn pair CODE与手机配对并安装 hooksccn doctor检查 hooks、配对和连接状态ccn test发送测试通知ccn devices列出已配对的手机,或撤销配对ccn config show显示这台电脑的设置ccn sync立即获取在手机上更改的设置04Mac 应用
Claude Code Notifier 的 Mac 菜单栏应用仍可使用,而且免费。如果你更喜欢应用而不是终端,可以下载,或运行 brew trust --cask touch-tap/tap/claude-code-notifier && brew install --cask touch-tap/tap/claude-code-notifier。与 ccn 不同,它无需手机就能显示 Mac 通知并触发 webhook,但需要 iTerm2、kitty 或 tmux 才能从手机回复。请勿在同一台 Mac 上同时运行两者,否则每条通知都会收到两次。若要从应用切换到 ccn,请运行 ccn pair CODE --replace-mac-app 完成配对,它会移除应用的 hooks,然后退出应用。
05卸载
ccn uninstall
这会从 settings.json 中移除 hooks、撤销配对并删除本地状态。然后删除可执行文件:macOS 和 Linux 上是 ~/.local/bin/ccn,Windows 上是 %LOCALAPPDATA%\Programs\ccn,或运行 brew uninstall ccn。