使用说明
Agent 等待确认或输入时,如何从手机回复
Claude Code、Codex 或脚本跑到一半等你回答?区分完成通知、权限审批与补充信息,用 Ntfyx 从手机回复允许、选项或文字。
更新于
任务没有结束,但 Agent 已经在等你
#Agent 可能跑完测试后,需要你选择环境、解释需求,或确认下一步操作。离开终端时,这个等待很容易被错过。Ntfyx 把加密问题送到手机或已授权的 Web 收件箱;发送端验证回答签名后,按相应工作流继续。完成通知、工具权限和普通提问需要不同的接入方式。
| 当前状态 | 接入方式 | 下一步 |
|---|---|---|
| 任务或命令已结束 | send 或完成 Hook | 收到结果,不需要回答。 |
| 支持的工具请求操作权限 | 原生 PermissionRequest 适配 | 把允许或拒绝回传给这次调用。 |
| 需要你选择或补充信息 | ask 或本地 stdio MCP | 工作流收到已验证的选项或文字。 |
| 任意终端提示正在等待 | 显式接入,或回到终端 | 不会自动读取和接管所有输入提示。 |
连接前的准备
#电脑或服务器需要 Ntfyx CLI 0.1.2,手机需要可用的主手机 App。iPhone 版本正在等待 App Store 审核;Android 1.0.0 已提交 Google Play 生产审核,目前只向已配置的内部测试者开放。这些状态不表示已公开上架。Android 推送需要 Google Play 服务。手机独立授权每台电脑或服务器;Web 收件箱是可选接收端,只能接收授权后发给它的新消息。
curl -fsSL https://ntfyx.me/install.sh | bash
ntfyx connect
ntfyx topics原生权限审批如何接入
#先运行 dry-run,查看将修改的配置,再安装适配器。Linux x64 上已有 Claude Code 的 Bash、Edit、Write,以及 Codex 的 Bash、apply_patch 真实宿主验证。Codex 需要本人在 /hooks 信任配置,并使用交互式 TUI;codex exec 不会发起审批。macOS 原生审批和 Claude 交互终端接管的验收范围仍不同。超时、未知请求或无效回答会回到终端,不自动允许。
ntfyx setup claude-code --dry-run
ntfyx setup claude-code
ntfyx setup codex --dry-run
ntfyx setup codex让 Agent 请你选择环境
#可枚举的答案适合用选项请求。把 Work 替换成 ntfyx topics 显示的本地别名。这条命令只询问要检查哪个环境,不会向所选环境发布任何内容。
ntfyx ask "接下来检查哪个环境?" \
--choice staging=预发布 --choice production=生产 \
--topic Work --wait 60s --expires 90s --json让 Agent 请你补充一句指示
#需要“检查一下结账流程”这样的说明时,使用文字请求。给 Agent 配置本地 MCP,并要求它在需要你回答时主动调用 ntfyx_ask。现有的 AskUserQuestion 或终端问题不会自动变成 Ntfyx 请求。文字回答是工作流输入,不能直接作为 shell 命令执行。
ntfyx ask "接下来检查什么?" \
--text --topic Work --wait 60s --expires 90s --json跑通一次无副作用的演示
#下载并阅读示例脚本后再执行。脚本只在收到已验证的选项或文字回答后打印完成提示,不执行发布、购买等外部操作;未回答时不会继续。回答签名校验和单次领取由 CLI 处理。
curl -fsSLo input-demo.sh https://ntfyx.me/examples/scripts/input-demo.sh
cat input-demo.sh
bash input-demo.sh Work choice
bash input-demo.sh Work text超时、拒绝和重复回答会怎样
#等待时长不能超过请求有效期。除非明确选择保留 pending,CLI 等待超时后会取消请求。拒绝、过期、校验失败或不确定的领取结果,都不能授权下一步操作。已经结束的调用不会被迟到的允许回复复活。单次领取控制回答消费,不能保证其他服务的外部操作恰好执行一次。
| 结果 | 应采取的行为 |
|---|---|
| 回答有效,且成功领取消费权 | 只继续对应的工作流。 |
| 拒绝或过期 | 停止,或回到终端处理。 |
| 网络或签名校验失败 | 报告失败或未知状态,不猜回答。 |
| 已经消费,或领取结果未知 | 不要盲目重复外部操作。 |
与远程控制整个会话的区别
#Ntfyx 传递通知和单次问题。如果需要查看完整 Claude 对话并在另一台设备继续会话,可以比较 Claude 官方 Remote Control。没有支持的权限适配时,仍能做完成通知,但不代表可以自动转发任意终端输入。
手机、隐私与恢复
#标题、问题、选项和回答在设备上加密,中继仍可见路由元数据、时间和大小。设备被入侵仍可能暴露明文。iPhone 和 Android 使用同一交互协议,商店购买与推送服务不同。恢复购买不会恢复加密密钥。