claude-code-notifier
工作原理 指南 常见问题
◐简体中文
English العربية Deutsch Español Français עברית Italiano 日本語 한국어 Nederlands Polski Português (Brasil) Русский Türkçe Tiếng Việt 简体中文 繁體中文
开始使用
全部指南

获取 Claude Code 通知的所有方式对比

更新于 2026年10月31日 · 阅读约 7 分钟
本页内容 01选项一览 02内置:由终端通知你 03自己写 hook:桌面通知 04自己写 hook:推送到手机 05Anthropic 的 Remote Control 和 Claude 应用 06专用通知工具 07Claude Code Notifier 的定位 08如何选择 09常见问题

获取 Claude Code 通知有五种方式:内置的终端通知;自己写一个弹出桌面提醒的 hook;写一个 hook 通过 ntfy、Telegram、Slack 或 Discord 等服务发送 push;Anthropic 官方的 Remote Control 配合 Claude 手机 app;以及专门的通知工具。前三种免费,只能告诉你发生了什么。Remote Control 和专用工具还能让你直接在手机上回应。选哪种,取决于你只是需要知道,还是还需要处理。

01选项一览

方案在哪里收到能回复吗?配置
内置通知(preferredNotifChannel)电脑上的终端否无需配置,或改一项设置
自己写的桌面 hook(osascript、notify-send、PowerShell)你的电脑否在 settings.json 里加几行
自己写的 push hook(ntfy、Pushover、Telegram、Slack、Discord)手机、聊天 app不能,除非自己实现一个 hook,外加账号、bot 或 topic
Remote Control 配合 Claude app手机、浏览器能,可操作整个会话登录 Claude app,用 Remote Control 启动会话
开源审批 hook(例如 claude-remote-approver)手机,通过 ntfy权限请求和提问npm install,安装 ntfy app
托管式通知 app(例如 Claude Code Notifier、Pushary)手机 app权限请求、提问等安装 CLI,配对或注册

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 包,使用 PermissionRequest hook 和 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 都会运行。但要避免让两个工具同时响应权限请求;如果两个工具对同一事件发通知,会收到重复提醒。

Claude Code Notifier Claude Code 完成任务或需要你介入时,手机会收到 push,你可以直接在手机上批准、拒绝或回复。ccn 命令行工具在 Mac、Windows 和 Linux 上均可免费使用。
下载 iOS 版 下载 Android 版 安装 ccn

相关指南

  • Claude Code 内置通知:terminal bell 与 preferredNotifChannel介绍 Claude Code 内置提醒的工作方式、preferredNotifChannel 各个取值的作用,以及如何配置 iTerm2、Apple Terminal、Kitty、Ghostty 和 tmux。
  • 用 ntfy 实现 Claude Code 推送通知(自己动手)用 ntfy 把 Claude Code 提醒发到手机:适用于 Mac、Windows 和 Linux 的 hook 脚本、settings.json 配置项,以及如何让 topic 保持私密。
  • 将 Claude Code 通知发送到 Telegram、Slack 或 Discord一个 hook 脚本,即可把 Claude Code 提醒发送到 Telegram bot、Slack incoming webhook 或 Discord webhook,支持 Mac、Windows 和 Linux。
  • 在手机上批准 Claude Code 权限请求Claude Code 的 PermissionRequest hook 可以返回 allow 或 deny。本文介绍如何在手机上回应权限提示,可以自己动手,也可以用 ccn。
claude-code-notifier

Claude Code Notifier 是一款独立的第三方应用,与 Anthropic, PBC 无关联,亦未获其认可或赞助。“Claude”和“Claude Code”是 Anthropic, PBC 的商标。

应用 iOS 应用 Android 应用 适用于 macOS、Windows 和 Linux 的 ccn 全部指南
法律信息 隐私政策 服务条款 其他语言 © 2026 touchtap。保留所有权利。 TouchTap Ltd 注册于英格兰和威尔士,公司编号 13942589。