使用说明
Codex 手机通知与权限审批：Ntfyx 接入指南
用 Ntfyx 在 iPhone、Android 或 Web 接收 Codex 任务提醒与支持的权限请求。了解本地 Hook、MCP、/hooks 信任，以及 Linux x64 和 macOS 的审批边界。
更新于
如何在手机接收 Codex 提醒并确认权限？
#用 Ntfyx 配对 iPhone 或 Android 手机，再运行 ntfyx setup codex 或安装 Ntfyx 插件。完成 Hook 发送任务提醒，本地 MCP 可以请求选项或文字回答。原生权限审批需要文档所列 Linux x64 交互式 TUI，并由你在 /hooks 中信任 Hook。macOS 原生审批回到终端；不会拦截 Codex request_user_input，也不会在 codex exec 中提供原生权限审批。
这项接入提供什么？
#Ntfyx 把支持的 Codex 权限请求发送到已配对的 iPhone、Android 手机或手机授权的 Web 收件箱。正在运行的 Codex 调用获得经过验证的 Allow 或 Deny。这是本地 CLI 接入，不会把 Ntfyx 加入 ChatGPT 云端应用目录，也不会把整个 Codex 会话搬到手机。
开始前需要准备什么？
#在 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。
- 在电脑显示新的配对二维码；不要公开二维码。
- 在手机打开 Connect Topic，扫码并新建或选择一个命名 Topic，授权这台电脑。
- 以下命令使用 Work 作为 CLI 本地连接别名；请替换为你实际配置的别名。
curl -fsSL https://ntfyx.me/install.sh | bash
export PATH="$HOME/.local/bin:$PATH"
ntfyx version --json
ntfyx connect
ntfyx topics预览并安装接入配置
#在运行 Codex 会话的同一电脑、同一用户下执行 setup。它在 hooks.json 中加入 PermissionRequest 与 Stop Hook，并注册本地 Ntfyx MCP server。先检查 dry-run；已经安装 Ntfyx Agent 插件时，使用现有插件，不再叠加同一组 Hook。
codex --version
ntfyx setup codex --dry-run
ntfyx setup codex在 Codex 中核对并信任 Hook
#打开交互式 Codex 会话，输入 /hooks，检查两个 Ntfyx Hook。只有它们符合你的预期配置时，才由你本人信任。CLI 不能代替你授予信任；保留原有 sandbox、approval policy 和拒绝规则。
- 测试权限请求前，先用 ntfyx send 确认已配对连接正常。
- 使用你本来就打算运行的无害任务。Codex 为 Bash 或 apply_patch 请求权限时，在手机核对这次确切请求。
- 先选择 Deny 并确认拟执行操作被阻止。只有确实希望执行时，才对新的无害请求测试 Allow。
codex没有收到手机请求时，检查什么？
#该 Hook 用于交互式终端会话。在已验证版本中，codex exec 关闭审批，不触发这个权限 Hook；app-server 审批路径尚未验证。宿主更新后的请求必须符合支持的 payload 格式，Ntfyx 才能回答。
| 现象 | 检查项 |
|---|---|
| 没有执行 Hook | 在 /hooks 核对信任，检查 setup 或插件安装。 |
| 没有权限请求 | 核对交互模式，以及本地策略是否确实要求确认。 |
| 回到终端 | 检查宿主版本、Linux x64、工具类型和上下文大小。 |
| 请求超时 | 在本地回答；迟到的手机回答不会恢复已结束调用。 |
| 已签名的 Deny | 操作必须保持阻止；不能静默重试成 Allow。 |
已经验证的范围
#2026年9月30日，真实 Codex 0.158.0 的 Linux x64 交互式 TUI、Bash 与 apply_patch Allow / Deny 测试，使用编译后的 Ntfyx CLI 和本地加密中继通过。接收端是程序化身份，不是实体 iPhone。这些结果验证上述宿主决策，不涵盖所有 Codex 版本、macOS 原生审批、APNs 送达或独立安全审计；不支持的输入回到本地宿主处理。
还需要用量与 reset-credit 提醒吗？
#用量提醒是单独启用的任务。它只读本地 Codex 状态，在限额或 reset 卡变化时发送通知，不兑换 reset 卡，也不审批工具。
Agent 等待你补充信息时
#完成提醒、工具权限请求和缺失信息需要不同接入方式。按对应指南选择支持的权限 Hook，或通过 CLI／本地 MCP 显式请求选项或文字回复。已有终端提示不会自动转发。