使用说明
消息到手机,带着原问题回复。
接收 Claude Code、Codex 与脚本的手机通知。已有公开 Topic 免配对收发;受保护 Topic 配对后支持加密 CLI 消息与验证应答。
先选收到通知,还是回答 Agent。
已有公开 Topic 免配对收发,知道链接的人和服务端都能阅读内容。自己的脚本也可使用私有 HTTPS 仅发送链接,服务读取输入后再加密投递。需要验证应答时,配对受保护 Topic;这条路径的 CLI 与 Agent 内容端到端加密。
你选择来源,手机接收与回复。
你可以主动发送,接入自己关心的 Agent、脚本和服务,也可以在“发现”主动订阅官方通知源。受保护 Topic 的来源由手机授权,随时可以撤销;公开 Topic 则允许持有标识的人发送。收件箱没有广告,也不会自动插入无关内容。用 Topic 整理工作,用静音时段控制提醒。
消息何时发送由你和接入的来源决定,Ntfyx 不会自动判断哪些内容是你感兴趣的。配对测试、连接与必要安全状态属于收件箱的运行信息。
完成自己的自动化任务
复制完整示例,再分别核对原任务退出码、服务发送回执和手机实际收到的消息。
从一条 HTTPS 通知开始
可以。在手机打开 HTTPS 推送后准备 MyNotify。App 自动生成简短的 sk_ 仅发送 key 和专属 HTTPS 发送链接。点击“发送”收到 hello,或复制链接,用 GET 访问时,最后一段是编码后的消息;也可保留整条复制地址不变,POST 动态文本、JSON 或 form 内容,无需更新 App 或安装 CLI。CLI 0.3.0 与本地 MCP 另经手机批准 Webhook 管理后可创建独立 wh_ 发送 key;监控授权不能复用,撤销管理也不会自动停用已有发送 URL。HTTPS 服务会读取这份明文请求,再为已授权接收端加密投递。完整链接包含发送 key,请保管好;可在 App 重新生成 key,使旧链接失效。它不能读取消息、管理收件箱或接收 Agent 回复。
按实际流程操作
两篇案例列明操作步骤、实际验证范围,以及失败或超时后如何判断。
来电式消息强提醒
可以,用于受保护 Topic。Ntfyx iPhone 和 Android 1.6.0 起,在设置主动开启默认关闭的 Call 通知,并授予所需系统权限。CLI 0.4.1 可指定 --alert-mode call,本地 MCP 使用 alert_mode=call,JSON Webhook 使用 ntfyx.alert_mode=call。它用于提醒查看消息,不进行语音通话,也不批准任务执行。符合条件的提醒受 Topic 静音与安静时段控制;Android 全屏展示还取决于通知和渠道权限。iOS 后台登记最长 24 小时,需要每天打开 App 续期;登记不可用时退回普通通知。静音状态变化前已在途的 iOS 系统来电可能短暂出现后立即结束。专注模式、系统设置、网络和投递限制仍适用,不保证送达或响铃。
每小时检查关心的服务
在“发现 → 我的监控”添加公开 HTTP 或 HTTPS 地址。每小时检查一次,要求最终 HTTP 状态为 2xx,也可要求响应包含指定文本,或简单 JSON 对象字段等于指定的基础类型值。每个服务在系统 My Monitor Topic 中对应一个 Session,所有检查结果进入同一会话,不占自定义 Topic 额度。App 1.5.3 可先预览文本或 JSON 再填写预期,默认仅失败时推送;正常结果静默留在会话,关闭此选项则每次检查都提醒。已配对的 CLI 与本地 MCP 可在手机明确批准后管理同一组监控,授权覆盖全部 My Monitor 项、最长 24 小时且可撤销。监控服务会读取地址、规则和响应,逐次检测记录保留七天;有检查活动的每周计划于下周一 00:00 UTC 发送带表情的英文非静默周报,统计次数、已完成检查的成功率和响应时间,仍遵守静音与投递设置。这是每小时监控,不是实时事故响应或 SLA。
Agent 提问与验签回复
CLI 与 Agent 工作流使用支持的 Windows、macOS 或 Linux 电脑与 Ntfyx 手机版本;HTTPS 通知无需安装 CLI。iPhone 1.8.3 与 Android 1.8.2 的公开状态见下载页,新能力需核对已安装版本。
- 在电脑安装 CLI,并运行 ntfyx connect,显示连接二维码。
- 在手机选择 MyNotify 或自己的受保护 Topic,扫描并确认电脑来源。
- 电脑运行 ntfyx send 发送通知;需要你回答时,运行 ntfyx ask。
- 在手机查看通知或回复;发送端验证回复签名后,按对应操作的规则继续。
下方 shell 安装命令用于 macOS / Linux;Windows 请先使用下载页的 PowerShell 或 npm 安装说明,再运行相同的 connect、send 与 ask 命令。
curl -fsSL https://ntfyx.me/install.sh | bash
ntfyx connect
ntfyx send "备份完成"
ntfyx ask "继续执行?" --allow-deny从电脑,到你的口袋
看得见的连接过程。
打开 Ntfyx → 连接 Topic
等待手机扫码…✓ Work · 已连接让工作, 随时联系你。
连接 Topic,接收第一条消息。
对准电脑上的二维码
收件箱
电脑发来的消息会显示在这里。
9 月 29 日 星期二
9:41点一下通知,查看消息 ↑电脑发起连接
运行 ntfyx connect,生成一次性连接二维码。
手机扫码,命名 Topic
用 Ntfyx 扫码,创建 Work 通道,也可选择已有 Topic。
电脑发送消息
一条命令即可发送。CLI 或 Agent 在本地加密消息。
手机收到,就这么简单
iPhone 本地解密通知,点开即可在 Topic 里查看。
受保护 Topic 流程演示。公开 Topic 与 HTTPS 发送无需这次配对;二维码和消息均为示例。 了解完整流程 →
在手机创建或选择 Topic 后,扫码授权对应发送端。手机分别授权每个来源与浏览器;中继处理路由元数据、时间、大小与请求状态,不读取消息明文。Web 仅收到授权后发给它的新消息。
Agent 在等你,而你离开了电脑
完成任务、请求操作权限、需要你选择或补充信息,是三类不同的等待。完成通知可以用 send;支持的权限适配可以回传允许或拒绝;普通问题需要 Agent 主动调用 ask 或本地 MCP,不会自动接管任意终端输入。
Topic 整理消息来源
免费版每天 100 条消息,其中 Call 最多 10 条、应答请求最多 10 条;1 个监控、1 个订阅。通知源订阅与公开 Topic 关注共享名额,Topic 数量不作为付费权益。公开 Topic 支持普通与富消息,受保护 Topic 还支持已核验的应答与 Call。
一个自定义 Topic 可以按 Session 整理多个任务;增加已授权发送端或浏览器,不等于创建新 Topic。每日静音默认时段为 22:00–09:00,默认关闭;开启后只暂停推送提醒,消息仍然同步,回复仍然可用。
每件事,一个 Session 会话
CLI 0.1.3+ 与当前客户端支持 Inbox → Topic → Session → 消息记录。同一 Topic 内使用相同 session ID 即可聚合任务消息;不传 ID 时,每条消息独立成会话。确认与选项直接在原消息下操作,文字回复点击那条消息后,在带引用的输入区填写。当前公开 CLI 0.6.1 已包含这些参数,可通过 ntfyx upgrade 升级。
官方通知订阅:只需手机,主动选择
不需要。在 iPhone 或 Android App 中打开“发现”,核对公开通知源后确认订阅,无需电脑、CLI、扫码配对或 Ntfyx 账号。后续更新进入对应 Topic,可在手机暂停或退订。每个来源分别说明覆盖范围和更新频率,不使用私有 Agent 消息生成这些内容。
11 个独立来源包括科技热点、Show HN 新产品、GitHub 日周月趋势、Tibo Codex reset 公开公告、OVH VPS 补货、人工复核的官方 AI 福利、Epic 游戏赠送、App Store 精选软件限免和 基金套利通知。基金套利通知覆盖6只股票指数与债券LOF,保留行情时间和已披露净值日期;双向差价及申赎条件仍需核验,不代表可执行套利。来源分别说明覆盖范围、更新频率和状态;订阅接收后续符合条件的内容,不回放旧预览。限免资格、库存和活动期限以原始来源为准。
投稿自己的通知插件
任何人都可自行采集,用脚本提交插件介绍与示例,无需注册或凭据。管理员在 App 原请求点“确定/拒绝”;后续每条通知也独立待审,通过后才公开发布。示例仅供审核和预览;平台不执行投稿者代码,原内置官方源的自动采集照常。
Web 收件箱
在电脑打开 Web Inbox,用手机扫描浏览器二维码并授权。浏览器使用独立密钥,只能查看授权后发给它的新消息,也可以回答问题。手机可以撤销浏览器访问;撤销不能删除浏览器已经收到的内容。
Chrome 扩展与桌面通知
Chrome 扩展 0.2.4 已在 Chrome 应用商店公开。当前受保护消息协议要求 Chrome 0.4.0,截至 2026 年 10 月 28 日该版已提交、仍待审;公开 0.2.4 上架不代表兼容新版协议。等待兼容扩展期间可使用手机授权的 Web 收件箱。 扩展提供桌面提醒、工具栏未读数量、Topic 与 Session 记录,以及原消息确认和引用回复。每个 Topic 需要主手机分别授权;Chrome 关闭或电脑休眠时可能延迟通知。现有 Web 收件箱仍可使用。
加密保护什么?
受保护 Topic 中 CLI 与 Agent 消息的标题、正文、选项和回复在设备上端到端加密;公开 Topic 的名称和消息对服务端及持有标识或链接的人可见。明确的监控 / Webhook 管理固定授权问题及手机签名答案会披露给服务端核验。HTTPS 推送与 Webhook 请求在加密投递前对服务可见;可选供应商验证 secret 由服务加密存储,并在验签时以明文验证原始 body,是托管 secret,并非服务端不可见;My Monitor 会读取监控地址、规则和响应,公开发布者知道自己发送的内容。中继转发密文,仍处理标识符、时间、大小和推送令牌等运行元数据。不要在监控 URL 或请求示例中放密钥。尚未完成独立安全审计。
请单独保管恢复文件与恢复码;客服不能解密丢失密钥的历史消息。恢复购买也不会恢复加密密钥。
本机 Codex 用量提醒与公开 reset 公告
电脑上的个人用量观察,与通知商城中的 Tibo 公开 reset 公告是两个独立来源。只想关注公开公告,可直接在手机订阅,不需要安装本机观察器。查看公开公告的实际来源和范围。
Ntfyx 在你的电脑上读取 Codex 用量(只读,不读取 Codex 登录文件,也不会使用 reset 卡),只把提醒内容端到端加密后发到手机:新的 reset 卡、未使用的 reset 卡将在 3 天或 24 小时内过期、用量达到 80% 或 95%、用过一半以上的额度窗口已重置、额度用完或恢复可用。首次检查只发一条概况。
ntfyx watch codex-usage --dry-run
ntfyx setup codex-usagesetup 会在 Linux 安装 systemd 用户定时器,在 macOS 安装 LaunchAgent,默认每 15 分钟检查一次;--remove 可卸载。完整说明(英文)
手机上怎样使用 Claude Code 与 Codex?
按完整会话、完成提醒、权限审批与问题回答分别选择,比较官方 Remote Control、Happy、Pushary、ntfy Hook 与 Ntfyx 的适用范围。
与其他通知工具怎样选?
Ntfyx 将任务消息、绑定原问题的回答、Topic/Session 记录与可选的通知商城放在一起,工作流可以等待已核验的确认、选择或文字答案。推送服务和机器人的回复、加密及集成能力各有不同,应结合其当前官方文档和自己的接入需求选择。
Agent、ChatGPT 与 Claude
Claude Code 与 Codex 支持的权限请求可以发到手机审批;原生审批已验证 Linux x64,Apple 芯片 Mac 原生审批已验证 Claude Code 2.1.303 与 Codex 0.163.0,需 CLI 0.1.5+;Intel Mac 仍回到终端(Claude 需显式启用 ntfyx setup claude-code --permissions on、ntfyx setup codex,也可以用插件安装),pi 有对应的扩展包,其他支持 CLI 或本地 stdio MCP 的 Agent 可以使用 Ntfyx 通知与提问工具。已验证的版本与平台见 Agent 说明。当前没有在 ChatGPT 或 Claude 应用目录发布集成;能在 AI 搜索中找到官网,与在聊天应用中直接调用工具,是不同的能力。