ccn 是一个小程序，由 Claude Code 通过 hooks 调用，支持 macOS、Windows 和 Linux。安装后，Claude 完成、需要权限或提问的那一刻，你就会收到桌面通知。随时配对手机，这些时刻也会以推送通知送达，让你在手机上批准、拒绝或回复。后台不会运行任何东西，任何终端都能用。

已有代码？从手机应用拿到了 6 位数代码？直接跳到配对手机：每条安装命令都可以带上代码，一步完成配对。还没有应用？下载 iOS 版或 Android 版。

01安装

macOS 和 Linux

curl -fsSL https://claudecodenotifier.com/web/install.sh | sh

Windows（PowerShell）

irm https://claudecodenotifier.com/web/install.ps1 | iex

Windows 支持目前为测试版。winget 和 Scoop 软件包即将推出。

Homebrew

brew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn

已安装 Node.js 的用户

npx @touchtap/ccn pair

每条命令都会安装 ccn 及其 hooks，之后 Claude Code 完成或需要你时，这台电脑上就会出现通知。不需要手机，后台也不会运行任何东西。ccn 会在 ~/.claude/settings.json 中添加七项配置，文件中的其他内容保持不变。有手机应用给的代码？配对手机中的命令可以一次完成安装和配对。

中国大陆用户

npx --registry=https://registry.npmmirror.com @touchtap/ccn pair

在中国大陆访问 GitHub 和 npm 官方源可能很慢或失败。这条命令通过 npmmirror 国内镜像安装 ccn（需要 Node.js），不需要访问 GitHub。

02配对手机

配对是可选的，也不会阻塞任何事情：无论是否配对了手机，ccn 都会继续在这台电脑上发通知。配对之后，每条通知也会以推送形式送到手机，你可以在手机上批准、拒绝或回复。配对有两种方式。

扫描终端里的二维码

ccn pair

运行 ccn 或 ccn pair。它会打印一个二维码和一个链接，24 小时内有效：用手机相机扫描二维码，或在手机上打开链接。没有应用时，链接会先引导你去商店；有应用时，手机会自动连接。ccn pair --no-wait 打印之后立即返回，你可以继续工作，稍后再扫。

输入应用里的代码

ccn pair 482913

在手机上打开 Claude Code Notifier 并添加电脑。应用会显示一个 6 位数代码，以及要运行的完整命令，代码已经填好。如果已经安装了 ccn，运行 ccn pair 加上代码即可。否则，每条安装命令都可以带上代码，一次完成安装和配对：

安装方式要运行的命令

macOS 和 Linuxcurl -fsSL https://claudecodenotifier.com/web/install.sh | sh -s 482913

Windows（PowerShell）irm https://claudecodenotifier.com/web/install.ps1 | iex; ccn pair 482913

Homebrewbrew trust --formula touch-tap/tap/ccn && brew install touch-tap/tap/ccn && ccn pair 482913

已安装 Node.js 的用户npx @touchtap/ccn pair 482913

npmmirror（中国大陆）npx --registry=https://registry.npmmirror.com @touchtap/ccn pair 482913

把 482913 换成你手机上的代码。代码有效期 24 小时，过期后应用会生成新的。

在未配对手机的情况下收到十条桌面通知后，ccn 会附上一行提示，建议运行 ccn pair。ccn config set pair_nudges off 可关闭。

03你能得到什么

单独使用时，ccn 会在 Claude 完成、需要权限或提问时在这台电脑上显示通知。配对手机后，你还能：

Claude 已完成：一轮对话结束的瞬间，立刻推送通知。
权限：在手机上允许一次、本次会话内允许，或拒绝。
提问：Claude 让你选择时，直接选一个答案。
后续回复：Claude 完成后，立刻在手机上发送下一条指令。

如果你在最近 30 秒内有过键盘输入，就不会有任何等待：终端照常询问，手机只收到一条提示。如果你不在，终端会等你在手机上回复，你一碰键盘就不再等待。你可以在应用中为每台电脑调整这些时间设置。

04命令

命令作用

ccn pair显示配对手机用的二维码和链接（24 小时内有效）并等待

ccn pair CODE用应用里的 6 位数代码配对

ccn pair --no-wait打印二维码和链接后立即返回

ccn doctor检查 hooks、配对和连接状态

ccn test发送测试通知

ccn devices列出已配对的手机，或撤销配对

ccn config show显示这台电脑的设置

ccn config set pair_nudges off关闭桌面通知之后的配对提示

ccn sync立即获取在手机上更改的设置

ccn upgrade立即把 ccn 更新到最新版本

ccn config set auto_update off关闭每日更新检查

ccn unlock购买许可证并解锁这台电脑（见“许可证”）

05许可证

在 claudecodenotifier.com/licence 购买的许可证可解锁与最多 3 台电脑配对的所有手机。许可证绑定在电脑上：密钥输入到 ccn 中，而不是手机应用里。

ccn unlock在浏览器中购买许可证并解锁这台电脑（--lifetime 为一次性付款）

ccn activate KEY在这台电脑上使用你的密钥（--replace NAME 可释放另一台电脑的名额）

ccn deactivate释放这台电脑的名额，以便在别处使用密钥

ccn licence显示方案、续订日期以及使用该密钥的电脑

没有许可证时，ccn 可能每天在 Claude Code 中显示一行提示，并发送一条桌面通知，说明如何解锁。设置 CCN_NO_NUDGE=1 即可关闭。

06更新

ccn upgrade

ccn 会自动保持最新：每天在后台检查一次新版本并安装。ccn upgrade 立即更新，ccn config set auto_update off 关闭每日检查。如果你是通过 Homebrew 或 npm 安装的，ccn 会把更新交给包管理器，并告诉你要运行的命令。

07Mac 应用

Claude Code Notifier 的 Mac 菜单栏应用仍可使用，而且免费。如果你更喜欢应用而不是终端，可以下载，或运行 brew trust --cask touch-tap/tap/claude-code-notifier && brew install --cask touch-tap/tap/claude-code-notifier。与 ccn 不同，它能触发 webhook，但需要 iTerm2、kitty 或 tmux 才能从手机回复。请勿在同一台 Mac 上同时运行两者，否则每条通知都会收到两次。若要从应用切换到 ccn，请运行 ccn pair CODE --replace-mac-app 完成配对，它会移除应用的 hooks，然后退出应用。

08卸载

ccn uninstall

这会从 settings.json 中移除 hooks、撤销配对并删除本地状态。然后删除可执行文件：macOS 和 Linux 上是 ~/.local/bin/ccn，Windows 上是 %LOCALAPPDATA%\Programs\ccn，或运行 brew uninstall ccn。

ccn forget

从中继服务器删除这台电脑，并移除 ccn。