使用说明

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 收件箱是可选接收端,只能接收授权后发给它的新消息。

Terminal
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 交互终端接管的验收范围仍不同。超时、未知请求或无效回答会回到终端,不自动允许。

Terminal
ntfyx setup claude-code --dry-run
ntfyx setup claude-code

ntfyx setup codex --dry-run
ntfyx setup codex

让 Agent 请你选择环境

#

可枚举的答案适合用选项请求。把 Work 替换成 ntfyx topics 显示的本地别名。这条命令只询问要检查哪个环境,不会向所选环境发布任何内容。

Terminal
ntfyx ask "接下来检查哪个环境?" \
  --choice staging=预发布 --choice production=生产 \
  --topic Work --wait 60s --expires 90s --json

让 Agent 请你补充一句指示

#

需要“检查一下结账流程”这样的说明时,使用文字请求。给 Agent 配置本地 MCP,并要求它在需要你回答时主动调用 ntfyx_ask。现有的 AskUserQuestion 或终端问题不会自动变成 Ntfyx 请求。文字回答是工作流输入,不能直接作为 shell 命令执行。

Terminal
ntfyx ask "接下来检查什么?" \
  --text --topic Work --wait 60s --expires 90s --json

跑通一次无副作用的演示

#

下载并阅读示例脚本后再执行。脚本只在收到已验证的选项或文字回答后打印完成提示,不执行发布、购买等外部操作;未回答时不会继续。回答签名校验和单次领取由 CLI 处理。

Terminal
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 使用同一交互协议,商店购买与推送服务不同。恢复购买不会恢复加密密钥。