获取 Claude Code 通知有五种方式:内置的终端通知;自己写一个弹出桌面提醒的 hook;写一个 hook 通过 ntfy、Telegram、Slack 或 Discord 等服务发送 push;Anthropic 官方的 Remote Control 配合 Claude 手机 app;以及专门的通知工具。前三种免费,只能告诉你发生了什么。Remote Control 和专用工具还能让你直接在手机上回应。选哪种,取决于你只是需要知道,还是还需要处理。
01选项一览
preferredNotifChannel)电脑上的终端否无需配置,或改一项设置osascript、notify-send、PowerShell)你的电脑否在 settings.json 里加几行02内置:由终端通知你
当 Claude Code 完成任务或在等待权限 prompt,而你似乎不在时,它本身就会发出通知。默认情况下,它在 iTerm2、Ghostty 和 Kitty 中发送桌面通知,在 Apple Terminal 中只在某种特定情况下响铃,在其他终端里则什么都不做。可以通过 preferredNotifChannel 设置修改这一行为,例如设为 "terminal_bell",让所有终端都收到响铃字符。
优点:无需安装,在会转发通知的 terminal 里通过 SSH 也能用。局限:只能提醒你面前这台电脑,很多 terminal(包括 IDE 内置 terminal)默认收不到任何提醒,而且无法回复。详见terminal 响铃指南。
03自己写 hook:桌面通知
Hook 可以让 Claude Code 在固定时机运行命令。Notification hook 会在 Claude 需要你处理时触发(权限 prompt 等待约六秒,或 Claude 完成后空闲约 60 秒)。Stop hook 则在一轮对话结束时立即触发。把任意一个指向你所用平台的通知命令,就能在 Mac、Windows 和 Linux 的任何 terminal 中收到提醒。Claude 完成时收到通知的指南里有完整步骤。
优点:免费、私密、完全可控,不需要联网。局限:仍然只在那台电脑上提醒;在无界面服务器或 SSH 环境下,桌面通知命令根本没有桌面可显示(参见 SSH 下的通知)。
04自己写 hook:推送到手机
同一个 hook 也可以改为调用推送服务。常见选择:
- ntfy:用一行
curl发布到某个 topic,在 iPhone 或 Android 上的 ntfy 应用接收。ntfy.sh 免费使用,也可以自建服务器。参见 ntfy 指南。 - Pushover:提供 API,每月有免费消息额度,并有自己的应用。单条消息最多 1,024 个字符。
- Telegram、Slack 或 Discord:通过 bot 或 incoming webhook 把消息发到你平时就在看的聊天里。参见 Telegram、Slack 和 Discord 指南。
优点:无论你在哪都能推送到手机,便宜甚至免费,发送的内容一清二楚。局限:只能单向。手机能告诉你 Claude 在等你,但会话仍要等你回到键盘前。你还得自己管理密钥(topic 名称、token、webhook URL),并决定什么时候不发送,因为不管你在不在电脑前,hook 都会触发。
05Anthropic 的 Remote Control 和 Claude 应用
Remote Control 可以把 iPhone 和 Android 上的 Claude 应用,或浏览器中的 claude.ai/code,连接到你电脑上运行的 Claude Code 会话。你能看到完整对话并直接输入,权限 prompt 和 AskUserQuestion 提问也会转发到手机。在 /config 中打开 Push when actions required 和 Push when Claude decides 后,应用会发送推送通知;当你正在已连接的 terminal 中输入或其处于焦点时,则不会推送。
优点:Anthropic 官方出品,手机上能看到完整会话,不涉及第三方。局限(据 Anthropic 文档):需要通过 claude.ai 登录的 Pro、Max、Ultra、Team 或 Enterprise 套餐,不支持 API key,也不支持 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 或自定义 ANTHROPIC_BASE_URL。Team 和 Enterprise 需要由 Owner 开启。会话必须以 Remote Control 方式启动(或设置为启动时自动连接),而“decides”类推送何时发送由 Claude 决定;除了这两个开关,没有按事件的配置。
06专用通知工具
有几款工具基于上面的 hook 构建,并增加了回复能力。
- claude-remote-approver 是一个开源(MIT)npm 包,使用
PermissionRequesthook 和 ntfy。每个权限请求都会变成带有 Approve 和 Deny 按钮的通知,AskUserQuestion的选项也会变成按钮。如果超时(默认 120 秒)仍无响应,Claude Code 会回退到 terminal prompt。 - Pushary 是托管服务,通过
npx pushary@latest setup配置。它会安装 Claude Code hook,在 Claude 完成时发送推送,并支持在手机上批准或回答。 - Claude Code Notifier(我们的产品)包含
ccn——一款适用于 Mac、Windows 和 Linux 的免费命令行工具,以及 iPhone 和 Android 手机应用。它是独立产品,并非 Anthropic 出品。
还有一些开源项目提供现成脚本,把提醒发到 ntfy、Discord 或桌面。如果你想 DIY 又不想自己写脚本,值得看看。
07Claude Code Notifier 的定位
如果只需要单向提醒,十行左右的 hook 配合 ntfy 或桌面通知工具就完全够用,而且零成本。
Claude Code Notifier 解决的是收到提醒之后的事。单独安装 ccn 时,它会在 Claude 完成、需要权限或提问时,在 Mac、Windows 或 Linux 上显示桌面通知。配对手机后,你可以:
- 在手机上对权限请求选择允许一次、本次会话内允许或拒绝
- 在 Claude 让你做选择时选出答案
- 在 Claude 完成后立即发送下一条指令
它还会判断你是否在场。如果你在最近 30 秒内有输入,就不会等待:terminal 照常询问,手机最多收到一条提示。如果你不在,terminal 会等待手机的回复,最长不超过你设定的上限,一旦你碰到键盘就立即停止等待。由于它是 hook,任何 terminal 都能用,包括 IDE terminal,也不需要在会话中开启 Remote Control。手机应用需要订阅或买断,参见价格。从 ccn 页面安装。
08如何选择
- 你坐在电脑前,只想要个提醒:内置通知或桌面 hook。
- 你想让手机震一下,然后走回去处理:ntfy 或聊天 webhook。
- 你想在手机上看到完整对话,并且用 claude.ai 套餐登录:Remote Control。
- 你想在手机上批准、回答并继续任务,而且人在键盘前时不被打扰:选择 Claude Code Notifier 这类专用工具。
09常见问题
Claude Code 有内置通知吗?
有。它会在 iTerm2、Ghostty 和 Kitty 中发送桌面通知,也可以把 preferredNotifChannel 设为 "terminal_bell",在任何 terminal 中响铃。不过它只能提醒运行 terminal 的那台电脑。如需手机推送,Anthropic 提供了配合 Claude 应用使用的 Remote Control。
有什么免费方式能在手机上收到 Claude Code 通知?
用 Notification 或 Stop hook 运行 curl,发到免费的 ntfy topic,再在手机上装 ntfy 应用即可。ntfy 指南里有可直接复制的配置。它能告诉你 Claude 在等待,但不能替你回复。
可以在手机上批准 Claude Code 的权限请求吗?
可以,用 Remote Control,或基于 PermissionRequest hook 的工具,比如 claude-remote-approver 或 Claude Code Notifier。参见在手机上批准权限。
可以同时使用多种方式吗?
可以,不同来源的 hook 都会运行。但要避免让两个工具同时响应权限请求;如果两个工具对同一事件发通知,会收到重复提醒。