Claude Code notifications: phone alerts and replies

Install Ntfyx on iPhone or Android, pair the signed companion CLI on your Windows, macOS or Linux computer, then use ntfyx setup claude-code or the Ntfyx plugin. Completion hooks send task updates. The AskUserQuestion bridge and explicit local MCP questions let you choose or type a reply. Native permission decisions retain verified Linux x64 support.

Apple silicon Mac native approvals are verified with Claude Code 2.1.303 and Codex 0.163.0 and require CLI 0.1.5+. Intel Mac native approvals remain unverified and return to the terminal. Setup does not make every Claude interaction remotely controllable.

• One-command Claude Code setup and question support

On Windows, use direct CLI setup or local MCP. Claude Code hooks require 2.1.139+; an older or unknown version gets MCP only. Codex on Windows provides MCP questions without automatic hooks. The marketplace plugin uses POSIX shell hooks; use direct setup on Windows. Native tool permission approvals retain their separate platform and host policy.

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

ntfyx setup codex --dry-run
ntfyx setup codex

• Windows installation and platform scope

Ntfyx brings task notifications and supported questions from Claude Code to your iPhone, Android phone or authorized Web Inbox. Install the companion CLI and use the one-command setup or Ntfyx plugin. The AskUserQuestion bridge forwards single-choice questions with a text alternative; multi-select uses typed option numbers.

Explicit questions can also use local MCP. Native tool permission decisions have separate Linux x64 / Apple silicon Mac compatibility and timeout requirements below.

• Claude Code plugin and AskUserQuestion setup
• Download the phone app and CLI

For a simple “finished” alert, wrap a Claude Code command. For a supported permission decision, install the Ntfyx hook and review the request on your phone. To continue the whole Claude conversation from another device, consider Claude’s own Remote Control.

For the protected CLI scripts below, install Ntfyx CLI 0.6.0+ on Windows, macOS or Linux and the app on iPhone (iOS 18.4+) or Android (Android 10+). Android background push requires Google Play services. Pair the CLI as the same user who runs the task; installing it alone does not authorize the sender.

Free includes 100 messages per UTC day. Use ntfyx topics to find your local alias and replace Work in the examples. The shell installer below is for macOS/Linux; Windows installation and current phone availability are on the download page.

1. Run ntfyx connect on the trusted computer and keep the fresh QR private.
2. Use the phone’s private Topic connection flow to authorize this Source. Update older apps from the store and follow the private scanning entry; current versions are listed in the quickstart.
3. Confirm one actual phone message before adding the wrapper to your own task.

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

• Pairing and CLI setup
• Current downloads and availability

This example needs Claude Code installed, authenticated and permitted to run the requested task. Claude Code usage is governed by your own account and plan. The -p option runs a prompt and exits. This wrapper observes the process exit; it is not a hook for every turn of an interactive chat.

• Claude Code CLI reference

The same small wrapper used for shell notifications works with Claude Code. It sends only a generic completion status and preserves the command’s exit code.

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

From a project whose README you are allowed to share with your configured Claude service, run this read-only request. Review any permissions requested by your Claude client under your normal policy. On process exit, Ntfyx sends Task finished or Task failed to Work.

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

Your phone displays the encrypted notification after delivery and local decryption. A phone-authorized browser can receive newly addressed messages too. Open the original terminal to read the answer. If no notification arrives, check CLI pairing, the warning in the terminal and phone notification settings.

• Notification troubleshooting
• Optional Web Inbox

Preview the changes, then apply them on the paired computer. Setup preserves unrelated configuration and registers local MCP tools plus lifecycle hooks. Use setup or the Ntfyx plugin, not both. A supported PermissionRequest waits up to 90 seconds for the signed answer inside a 100-second host hook timeout.

Existing deny rules still apply.

1. Keep Claude running on the computer and let an ordinary task reach a permission request under your existing policy.
2. Check the complete tool context on the phone. Allow authorizes that invocation once; Deny blocks it.
3. On an unsupported request, timeout or verification error, return to the terminal. A late Allow cannot restart an ended invocation.

ntfyx setup claude-code --permissions on --dry-run
ntfyx setup claude-code --permissions on

• Host compatibility and plugin installation
• Try a harmless standalone approval

Claude Remote Control continues a local session through the Claude app or browser, with mobile push options. The local computer and Claude process must stay running. Its current requirements include an eligible Pro, Max, Team or Enterprise subscription and Claude sign-in; API-key or custom API-endpoint setups are excluded.

Choose it when you want the full conversation. Ntfyx also carries ordinary script notifications and requests from other sources into named Topics.

• Claude Remote Control: requirements and mobile notifications
• Compare notification tools

These scripts were tested with the compiled CLI, a real local encrypted relay and signed replies from the Web Inbox. Phone authorization in that automated test used a programmatic identity. The screenshots show synthetic messages from that local Web test; they are not iPhone or APNs delivery evidence.

The wrapper was exercised with harmless shell processes; this tutorial test did not make a new paid Claude request. Separate real-host tests cover the versions and modes stated above. Ntfyx is not currently listed in the ChatGPT or Claude app directories.

• Read the example source and verification scope

Completion alerts, tool permission requests and missing information need different integrations. Use the guide below to choose a supported permission hook or explicitly ask for a choice or text reply through the CLI or local MCP. Existing terminal prompts are not automatically forwarded.

• Agent waiting for input: notifications and replies
• Multiple coding agents and projects
• SSH and remote server jobs

Compare full-session access, completion notifications, permission decisions and answers, with official sources, encryption scope, account requirements and starting prices.

• Claude Code and Codex on your phone

Choose a guide by task completion, waiting for input and agent host.

• Codex notifications and replies
• An agent is waiting for input
• AI agent notifications on your phone