Claude Code notifications: six ways, compared
Updated
Quick answer
There are six ways to know that Claude Code needs you: the terminal’s own notification, a hook that shows a desktop alert, a hook that pushes to ntfy or a chat app, Anthropic’s Remote Control with the Claude app, an open source approval hook, and a notifier app. The first three are free and one-way. The last three let you answer from the phone, and differ in price, in what they require and in what they show.
Facts below were checked on 17 November 2026, in Anthropic’s Claude Code docs and on each product’s own pages, unless another date is given.
At a glance
Swipe the table sideways to see all columns.
| Way | Reaches you | Answer from there | Needs |
|---|---|---|---|
| Terminal notification | Your computer | No | iTerm2, Ghostty or Kitty, or the bell |
| Hook, desktop alert | Your computer | No | A hook and a system command |
| Hook to ntfy or a chat | Phone, chat app | No | A hook, a topic or a webhook |
| Remote Control | Claude app, browser | Yes, the whole conversation | A Claude plan and a claude.ai sign-in |
| Open source approval hook or channel | Chat app | Yes | Your own code, or the channels preview |
| Notifier app | Phone | Yes | The app and one command |
Built into the terminal
Claude Code alerts you by itself, with no setup, in some terminals: a desktop notification when it detects iTerm2, Ghostty or Kitty, and nothing in most others, including the terminals inside VS Code and JetBrains IDEs. Set preferredNotifChannel to "terminal_bell" to ring the bell anywhere. Over SSH, setting it to your local terminal sends the notification back through the connection.
Two limits. The alert only reaches the computer you are sitting at. And it waits until you look away: a permission prompt triggers it after about six seconds without a keystroke, a finished task about sixty seconds after Claude stops.
Your own hooks
Hooks are commands Claude Code runs at fixed points, configured in ~/.claude/settings.json. Three kinds of hook cover the three remaining free options.
- A desktop alert. A
Stophook runs the moment Claude finishes responding, aNotificationhook when it waits for you. Point them atosascript,notify-sendor PowerShell. Free, instant, and still limited to the screen in front of you. - A push to ntfy or a chat app. The same hooks call
curl: ntfy for a phone notification with no account, or a Telegram bot, a Slack or a Discord webhook. Free and quick, and one-way: you learn that Claude waits, then walk back to answer. - An approval hook. A
PermissionRequesthook can return the decision itself, allow or deny, so it can wait for your answer from elsewhere and hand it back. You write the waiting part around a bot or a server of your own. The open source route that needs no code is Claude Code’s channels, a research preview: the Telegram and Discord channel plugins, open source in Anthropic’s official plugin marketplace, relay permission prompts to the chat, and the first answer, terminal or chat, applies. Channels need Bun, Anthropic authentication through claude.ai or a Console API key, and a session started with--channels.
Whatever you build, your deny rules still win: a hook’s allow cannot get past them.
Remote Control and the Claude app
Anthropic’s own route. Remote Control connects a session running on your computer to the Claude app and claude.ai/code, and the app can push “when a long-running task finishes or when Claude needs a decision”, with two switches in /config: Push when Claude decides and Push when actions required. It puts the whole conversation on your phone, and it involves no third party.
It needs a Pro, Max, Ultra, Team or Enterprise plan with a claude.ai sign-in; API keys, Amazon Bedrock, Google Cloud’s Agent Platform and Microsoft Foundry are not supported. Each session has to be connected to Remote Control, the push is skipped while you are typing in or focused on the connected terminal, and on iOS a Focus or a notification summary can hold it back. iPhone users have open reports of pushes without sound and of a missing Approve button.
Notifier apps
Notifier apps install hooks for you and give the phone side a proper interface. Listed in alphabetical order:
Swipe the table sideways to see all columns.
| App | Price | Phones | What you can do from the phone |
|---|---|---|---|
| Agentfy | Free tier with 100 alerts; paid plans, prices dated on the comparison page | iPhone, iPad | Follow sessions; it does not send answers back |
| Claude Code Notifier | Command line tool free; paid phone app, prices dated on the comparison page | iPhone, iPad, Android | Allow once, allow for the session or deny; answer questions; send the next instruction |
| Monish | Free: no subscription, no in-app purchase | iPhone | Allow or deny, allow for the session or always allow a command; answer questions; reply to send the next instruction |
| Pushary | Paid plans with a 3-day trial, prices dated on the comparison page | iPhone, Android | Approve or deny confirmation questions from the notification |
Claude Code Notifier and Monish both have a live card on the lock screen and neither asks for an account. Monish also takes Codex, Cursor and scripts; Claude Code Notifier also notifies on the computer itself and comes in 17 languages. Sources and the full comparison are on the comparison page and in the Claude Code Notifier alternative guide.
How to choose
- You stay near the computer: the terminal’s own notification, or a
Stophook if your terminal stays silent. - You want a phone alert, free, and can walk back to answer: a hook to ntfy or to Telegram, Slack or Discord.
- You have a Claude plan and Remote Control reaches you reliably: keep the Claude app’s push. If it stays silent, see why it may not arrive.
- You want to answer from the phone without a plan, or with an API key: a channel, your own approval hook, or a notifier app. Monish if you use an iPhone and want it free, or also run Codex, Cursor or your own scripts. Claude Code Notifier if you need Android, want notifications on the computer itself, or prefer an app in your language.
Questions
- What is the best way to get Claude Code notifications?
- It depends on where you are when Claude needs you. At the desk, the terminal’s own alert or a hook is enough. Away from it, you need a push to your phone, and a way to answer if you don’t want to walk back.
- Which options let me answer from my phone?
- Remote Control with the Claude app, Claude Code channels or your own approval hook, and notifier apps. ntfy and chat webhooks only tell you that Claude is waiting.
- Do I need a Claude plan?
- Only for Remote Control, which needs a Pro, Max, Ultra, Team or Enterprise plan and a claude.ai sign-in. Hooks run on your computer, so the hook-based options work with any sign-in.
- Can I use several at once?
- Yes for alerts: hooks for the same event all run. For approvals, keep one tool answering permission requests, because which answer wins between two hooks is not documented.
More guides
- Claude Code notifications with ntfyA push to your phone from one curl line, and what a one-way push leaves out.
- Claude Code alerts in Telegram, Slack or DiscordOne script, three destinations, and Claude Code channels.
- A free alternative to Claude Code NotifierWhat both apps do, where they differ, and when theirs fits better.
- Claude Code push notifications not working on iPhoneWhat Remote Control needs, and six things to check.
New to Monish? The home page shows what lands on your iPhone, and all guides are listed here.
Get Monish on your iPhone
Free, no account. Your 6-digit code is waiting in the app.