使用说明
AI Agent 手机通知：完成提醒、提问与回复
接收 Claude Code、Codex 和脚本的任务完成通知，在 iPhone 或 Android 上确认、选择或回复文字，用 Topic 与 Session 整理任务。
更新于
如何让 AI Agent 通知手机？
#Ntfyx 是 AI Agent 通知与手机回复工具，把 Claude Code、Codex 和脚本的任务进展送到 iPhone 或 Android。在 Windows、macOS 和 Linux 上安装 CLI 并与手机配对，即可发通知或配置支持的 Agent 接入。任务明确提问时，可以在手机的原问题下回答，由等待中的电脑核验回复；电脑和等待进程需要继续运行。
完成通知、问题回答与权限审批分别接入
#先选择需要接入的事件，再配置 Hook。通知报告结果，问题等待输入，原生权限请求由 Agent 宿主控制。
| 需求 | Ntfyx 接入 | 范围 |
|---|---|---|
| Agent 完成时通知 | 完成 Hook 或 ntfyx send | Claude Code setup 支持兼容的 Windows、macOS 和 Linux 宿主。Codex 自动 Hook 仅 macOS/Linux；Windows 使用显式 MCP 或 CLI 调用。 |
| 远程回答问题 | ntfyx ask / ntfyx_ask | 确认、选项或文字。Claude 有 AskUserQuestion 桥接；Codex 原生 request_user_input 不会被拦截。 |
| 审批工具权限 | 显式启用原生适配 | 限 Linux x64 或 Apple 芯片 Mac 的已验证宿主组合，需核对版本和运行模式；其他组合回到终端。 |
先收到一条通知，再回答一个问题
#配对后使用默认已授权 Topic，或用 --topic 选择已有别名。下面发送测试消息，再询问接下来检查什么，不会执行你的答案。回复时保持 CLI 等待。
ntfyx send "任务已完成，可以查看结果" --title "Agent 进展"
ntfyx ask "接下来检查什么？" --text --wait 60s --expires 90s --json与通知脚本和远程会话工具有什么区别？
#Ntfyx 将任务消息、绑定原问题的回答、Topic/Session 记录与可选的通知商城放在一起，工作流可以等待已核验的确认、选择或文字答案。推送服务和机器人的回复、加密及集成能力各有不同，应结合其当前官方文档和自己的接入需求选择。
| 你的流程 | 选择时核对 |
|---|---|
| 只需告知任务结束 | 桌面通知器或 HTTP 推送 Hook 可能已经够用；核对手机投递、平台要求和维护成本。 |
| 询问后继续等待中的任务 | Ntfyx 将确认、选项和文字回复绑定原问题；发送端核验并领取答案后继续。 |
| 阅读并控制整个会话 | 可比较 Claude Remote Control、Happy 等完整会话工具。Ntfyx 传递选定消息和问题，不镜像整个终端。 |
多个 Agent 可以共用一个收件箱吗？
#Topic 汇集已授权来源的消息。同一次任务在同一个 Topic 内使用相同 session ID，进展和回复就会留在一个 Session 会话中。不传 session ID 时，每条新消息独立成会话。分组不会授权其他 Topic，也不会导出 Agent 的完整对话。
免费范围与加密范围是什么？
#免费包含 1 个通知订阅、1 个供自己工具使用的自定义 Topic，以及 1 个每小时检查的监控项。MyNotify 可接收 HTTPS 通知，系统 My Monitor Topic 不占自定义 Topic 额度。可以接收 Agent 消息，在原问题下确认、选择或引用回复文字。无需注册 Ntfyx 账号，仍受共享的消息、请求、设备及存储限制约束。
手机没有提醒怎么办？
#先核对配对和所选 Topic，再检查手机通知权限、专注模式、静音和安静时段。Android 推送需要 Google Play 服务。服务已受理不等于手机已展示提醒；拒绝、过期或未通过核验的答案不允许任务继续。
需要更强的提醒，或检查服务是否正常？
#需要关注的消息可以显式请求可选 Call 提醒。服务能够主动发事件时使用 HTTP Webhook；服务提供公开接口、需要每小时检查时使用 My Monitor。更强的提醒不会批准任务执行。