使用说明

消息到手机,带着原问题回复。

接收 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 回复。

MyNotify 请求、仅发送 key 与送达状态 · 下载与版本可用状态

按实际流程操作

两篇案例列明操作步骤、实际验证范围,以及失败或超时后如何判断。

来电式消息强提醒

可以,用于受保护 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 系统来电可能短暂出现后立即结束。专注模式、系统设置、网络和投递限制仍适用,不保证送达或响铃。

Call 通知的开启方式、发送示例与平台限制 · 在手机回复 AI Agent

每小时检查关心的服务

在“发现 → 我的监控”添加公开 HTTP 或 HTTPS 地址。每小时检查一次,要求最终 HTTP 状态为 2xx,也可要求响应包含指定文本,或简单 JSON 对象字段等于指定的基础类型值。每个服务在系统 My Monitor Topic 中对应一个 Session,所有检查结果进入同一会话,不占自定义 Topic 额度。App 1.5.3 可先预览文本或 JSON 再填写预期,默认仅失败时推送;正常结果静默留在会话,关闭此选项则每次检查都提醒。已配对的 CLI 与本地 MCP 可在手机明确批准后管理同一组监控,授权覆盖全部 My Monitor 项、最长 24 小时且可撤销。监控服务会读取地址、规则和响应,逐次检测记录保留七天;有检查活动的每周计划于下周一 00:00 UTC 发送带表情的英文非静默周报,统计次数、已完成检查的成功率和响应时间,仍遵守静音与投递设置。这是每小时监控,不是实时事故响应或 SLA。

My Monitor 规则、频率与异常恢复

Agent 提问与验签回复

CLI 与 Agent 工作流使用支持的 Windows、macOS 或 Linux 电脑与 Ntfyx 手机版本;HTTPS 通知无需安装 CLI。iPhone 1.8.3 与 Android 1.8.2 的公开状态见下载页,新能力需核对已安装版本。

  1. 在电脑安装 CLI,并运行 ntfyx connect,显示连接二维码。
  2. 在手机选择 MyNotify 或自己的受保护 Topic,扫描并确认电脑来源。
  3. 电脑运行 ntfyx send 发送通知;需要你回答时,运行 ntfyx ask。
  4. 在手机查看通知或回复;发送端验证回复签名后,按对应操作的规则继续。

下方 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

从电脑,到你的口袋

看得见的连接过程。

●   TerminalWork   ·   9:41
ntfyx — zsh
❯ ntfyx connect
演示二维码,不能用于实际连接
连接你的 iPhone

打开 Ntfyx → 连接 Topic

等待手机扫码…✓   Work · 已连接
二维码仅限一次 · 5 分钟有效
✓ Work · iPhone 已连接
❯ ntfyx send "Build passed"
↗   已在本地加密✓   消息已接收 Work
❯
你的电脑 CLI / Agent
9:41
Ntfyx

让工作, 随时联系你。

连接 Topic,接收第一条消息。

连接 Topic×

对准电脑上的二维码

✓已识别连接码Topic Work
Ntfyx+

收件箱

Work1 条消息0
✓连接成功

电脑发来的消息会显示在这里。

Terminal 9:41Build passed

来自你的电脑。 在 iPhone 本地解密。

⌁ 端到端加密

9 月 29 日 星期二

9:41点一下通知,查看消息 ↑
你的 iPhone
01 / 04

电脑发起连接

运行 ntfyx connect,生成一次性连接二维码。

受保护 Topic 流程演示。公开 Topic 与 HTTPS 发送无需这次配对;二维码和消息均为示例。 了解完整流程 →

入门与模式选择

消息链路 · 每个接收端收到独立的加密副本
CLI / Agent加密并签名
Ntfyx 中继密文与推送唤醒
iPhone / Web验证并解密
签名并加密的回复返回原发送端

在手机创建或选择 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 升级。

Session 会话与消息回复:完整说明和示例

官方通知订阅:只需手机,主动选择

不需要。在 iPhone 或 Android App 中打开“发现”,核对公开通知源后确认订阅,无需电脑、CLI、扫码配对或 Ntfyx 账号。后续更新进入对应 Topic,可在手机暂停或退订。每个来源分别说明覆盖范围和更新频率,不使用私有 Agent 消息生成这些内容。

11 个独立来源包括科技热点、Show HN 新产品、GitHub 日周月趋势、Tibo Codex reset 公开公告、OVH VPS 补货、人工复核的官方 AI 福利、Epic 游戏赠送、App Store 精选软件限免和 基金套利通知。基金套利通知覆盖6只股票指数与债券LOF,保留行情时间和已披露净值日期;双向差价及申赎条件仍需核验,不代表可执行套利。来源分别说明覆盖范围、更新频率和状态;订阅接收后续符合条件的内容,不回放旧预览。限免资格、库存和活动期限以原始来源为准。

核对全部通知源与免费订阅方式

投稿自己的通知插件

任何人都可自行采集,用脚本提交插件介绍与示例,无需注册或凭据。管理员在 App 原请求点“确定/拒绝”;后续每条通知也独立待审,通过后才公开发布。示例仅供审核和预览;平台不执行投稿者代码,原内置官方源的自动采集照常。

投稿指南、Python 脚本与机器可读 Schema

Web 收件箱

在电脑打开 Web Inbox,用手机扫描浏览器二维码并授权。浏览器使用独立密钥,只能查看授权后发给它的新消息,也可以回答问题。手机可以撤销浏览器访问;撤销不能删除浏览器已经收到的内容。

打开 Web 收件箱 · 浏览器使用说明

Chrome 扩展与桌面通知

Chrome 扩展 0.2.4 已在 Chrome 应用商店公开。当前受保护消息协议要求 Chrome 0.4.0,截至 2026 年 10 月 28 日该版已提交、仍待审;公开 0.2.4 上架不代表兼容新版协议。等待兼容扩展期间可使用手机授权的 Web 收件箱。 扩展提供桌面提醒、工具栏未读数量、Topic 与 Session 记录,以及原消息确认和引用回复。每个 Topic 需要主手机分别授权;Chrome 关闭或电脑休眠时可能延迟通知。现有 Web 收件箱仍可使用。

Chrome 扩展:状态、配对、回复与通知限制

加密保护什么?

受保护 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-usage

setup 会在 Linux 安装 systemd 用户定时器,在 macOS 安装 LaunchAgent,默认每 15 分钟检查一次;--remove 可卸载。完整说明(英文)

手机上怎样使用 Claude Code 与 Codex?

按完整会话、完成提醒、权限审批与问题回答分别选择,比较官方 Remote Control、Happy、Pushary、ntfy Hook 与 Ntfyx 的适用范围。

手机使用 Agent 的方案比较与官方来源

与其他通知工具怎样选?

Ntfyx 将任务消息、绑定原问题的回答、Topic/Session 记录与可选的通知商城放在一起,工作流可以等待已核验的确认、选择或文字答案。推送服务和机器人的回复、加密及集成能力各有不同,应结合其当前官方文档和自己的接入需求选择。

与 ntfy、Bark、Pushover、Gotify 的官方资料比较 · 免费使用与常见问题

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 搜索中找到官网,与在聊天应用中直接调用工具,是不同的能力。

Agent 与 MCP 配置 · 脚本通知示例 · 常见问题 · English documentation