Claude Code 手机通知、提问与回复：Ntfyx 接入指南

在 iPhone 或 Android 安装 Ntfyx，用手机配对 macOS 或 Linux 电脑上的签名 CLI，再运行 ntfyx setup claude-code 或安装 Ntfyx 插件。完成 Hook 发送任务状态通知；AskUserQuestion 桥接和显式本地 MCP 提问支持选择或文字回复。原生权限审批已验证 Linux x64；macOS 原生审批回到终端。安装接入不会让所有 Claude 交互都变成远程可控。

• 一条命令设置、插件与提问支持
• English guide

Ntfyx 把 Claude Code 的任务通知和支持的问题发送到 iPhone、Android 手机或手机授权的 Web 收件箱。安装配套 CLI，再使用一条命令设置或 Ntfyx 插件。AskUserQuestion 桥接将单选题转成按钮，并提供文字替代回答；多选题当前通过输入选项编号回答。Agent 也可以显式调用本地 MCP 提问。原生工具权限审批采用下文单独的 Linux x64 兼容范围和超时规则。

• 插件与 AskUserQuestion 设置
• 下载手机 App 和 CLI

只想知道任务是否结束，可以包装一条 Claude Code 命令。需要回答支持的工具权限请求，可以安装 Ntfyx Hook，在手机核对原请求。需要在另一台设备继续整个 Claude 对话时，可以考虑 Claude 官方 Remote Control。

在 macOS 或 Linux 电脑安装当前 Ntfyx CLI 0.1.4，并在 iPhone（iOS 18.4+）或 Android 手机（Android 10+）安装 Ntfyx。当前公开手机版本为 iPhone 1.1.2、Android 1.1.1；Android 推送需要 Google Play 服务。只安装 CLI 不会自动连接手机。免费版包含一个活跃 Topic，多个来源可以共用，无需为每个来源另购 Topic。

1. 在电脑显示新的配对二维码；不要公开二维码。
2. 在手机打开 Connect Topic，扫码并新建或选择一个命名 Topic，授权这台电脑。
3. 以下命令使用 Work 作为 CLI 本地连接别名；请替换为你实际配置的别名。

curl -fsSL https://ntfyx.me/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"
ntfyx version --json
ntfyx connect
ntfyx topics

• 配对与 CLI 设置（英文）
• 当前下载与可用状态

以下示例需要已经安装、认证并有权执行所请求任务的 Claude Code。Claude Code 的使用受你自己的账户和套餐约束。-p 会执行一个提示并退出；包装脚本观察的是进程退出，不是交互式聊天每一轮的 Hook。

• Claude Code 官方 CLI 说明

用于 shell 通知的同一份小脚本也适用于 Claude Code。它只发送通用完成状态，并保留原命令退出码。

curl -fsSLo notify-after.sh https://ntfyx.me/examples/scripts/notify-after.sh
cat notify-after.sh

在你有权向所配置 Claude 服务提供 README 的项目中，执行下面的只读请求。按原有策略核对 Claude 客户端提出的权限请求。进程退出后，Ntfyx 会向 Work 发送 Task finished 或 Task failed。

bash notify-after.sh Work claude -p "Explain this project's README without changing files."

消息送达并在手机本地解密后，手机显示通知。由手机授权的浏览器也能接收新发送给它的消息。回到原终端阅读 Claude 的回答；没有收到提醒时，检查 CLI 配对、终端警告与手机通知设置。

• 通知排查（英文）
• 可选 Web 收件箱（英文）

先预览将修改的配置，再在已配对电脑应用。setup 保留无关配置，注册本地 MCP 工具与生命周期 Hook。setup 和 Ntfyx 插件二选一，避免重复 Hook。支持的 PermissionRequest 在100秒宿主 Hook 超时内，等待签名回答最多90秒；既有拒绝规则仍然生效。

1. 保持电脑上的 Claude 运行，让正常任务按既有策略触发一次权限请求。
2. 在手机检查完整工具上下文。Allow 只授权本次调用，Deny 阻止它。
3. 请求不支持、超时或回复验证失败时，回到终端处理。迟到的 Allow 不会重新启动已结束的调用。

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

• 宿主兼容范围（英文）
• 插件安装与功能范围
• 无害的独立审批示例（英文）

Claude Remote Control 通过 Claude App 或浏览器继续本机会话，并提供手机推送选项。本机电脑和 Claude 进程必须持续运行。其当前要求包括符合条件的 Pro、Max、Team 或 Enterprise 订阅及 Claude 登录；API key 和自定义 API endpoint 配置不在适用范围。需要完整会话时，可以选择该方案；Ntfyx 同时把普通脚本通知和其他来源的请求整理到命名 Topic 中。

• Claude Remote Control 官方要求与手机通知
• 通知工具选型（英文）

脚本已用编译后的 CLI、真实本地加密中继和 Web 收件箱签名回复进行测试；自动测试中的手机授权使用程序化身份。相关示例截图是本地 Web 测试的合成消息，不是 iPhone 或 APNs 送达证据。通知包装脚本使用无害的 shell 进程测试，本教程没有新发起付费 Claude 请求。原生宿主测试独立覆盖上文列出的版本与运行模式。Ntfyx 当前没有在 ChatGPT 或 Claude 应用目录公开收录。

• 示例源码与验证范围

完成提醒、工具权限请求和缺失信息需要不同接入方式。按对应指南选择支持的权限 Hook，或通过 CLI／本地 MCP 显式请求选项或文字回复。已有终端提示不会自动转发。

• Agent 等待输入：通知与回复
• 多个 Agent 与项目
• SSH 与服务器任务