claude-code-notifier
how it works guides faq
◐English
English العربية Deutsch Español Français עברית Italiano 日本語 한국어 Nederlands Polski Português (Brasil) Русский Türkçe Tiếng Việt 简体中文 繁體中文
Get started

Guides

Claude Code notifications, hooks and remote approvals

Practical answers about Claude Code hooks, notifications and approving or answering Claude from your phone, on Mac, Windows and Linux.

  • How to get a notification when Claude Code finishesUse a Stop hook for "finished" and a Notification hook for "needs input". Copy-paste setups for Mac, Windows and Linux, plus phone alerts.
  • Claude Code hooks explained: every event and what it is forWhat Claude Code hooks are, where they go in settings.json, how matchers, input and exit codes work, and what each hook event is for.
  • The Claude Code Notification hook: when it fires and how to use itWhen Claude Code's Notification hook fires, what permission_prompt and idle_prompt mean, the input it gets, and why it waits before firing.
  • The Claude Code Stop hook: run something when Claude finishesHow Claude Code's Stop hook works, what input it gets, how to run a command when Claude finishes, and how to make Claude keep going safely.
  • Answering permission requests from a hook (PermissionRequest)How Claude Code's PermissionRequest hook works, how to allow or deny from a script, and why permission rules are often the better tool.
  • Approve Claude Code permission requests from your phoneClaude Code's PermissionRequest hook can return allow or deny. Here is how to answer permission prompts from your phone, by hand or with ccn.
  • Answer Claude Code's questions from your phoneWhen Claude Code asks a multiple-choice question with AskUserQuestion, a PreToolUse hook can supply the answer. Here is how to reply from your phone.
  • Connect your phone to Claude Code on Mac, Windows or LinuxPair your phone with Claude Code in a minute: install ccn, then scan a QR code or type a 6-digit code. Steps for Mac, Windows and Linux.
  • Using Claude Code from your phone: what works and what does notThe real options for using Claude Code from an iPhone or Android phone: Anthropic's Remote Control and cloud sessions, SSH, and hook-based push tools.
  • Leave Claude Code running and walk away: a workflowA practical routine for long Claude Code tasks: keep the computer awake, cut needless prompts, get pinged on your phone and reply from there.
  • Claude Code notifications on macOSGet a macOS notification when Claude Code finishes or needs permission: built-in terminal alerts, an osascript hook, terminal-notifier, or ccn.
  • Claude Code notifications on Windows (PowerShell and WSL)Get a Windows notification when Claude Code finishes or needs input, natively or in WSL: PowerShell hooks, BurntToast toasts, the terminal bell, or ccn.
  • Claude Code notifications on LinuxGet a Linux desktop notification when Claude Code finishes or needs input: notify-send hooks, sounds, terminal escape sequences, or ccn.
  • Notifications from Claude Code on a remote server over SSHRun Claude Code on a VPS or remote server over SSH and still get notified: terminal escape sequences that travel over SSH, or a phone push with ccn.
  • Claude Code in tmux or screen: getting notified from a detached sessionGet notified when Claude Code in tmux or screen finishes or needs you: allow-passthrough, bell alerts, naming the session, and phone pushes when detached.
  • Every way to get Claude Code notifications, comparedBuilt-in alerts, your own hooks, ntfy and chat webhooks, Anthropic's Remote Control and notifier apps, compared on what each can and cannot do.
  • Claude Code push notifications with ntfy (do it yourself)Send Claude Code alerts to your phone with ntfy: a hook script for Mac, Windows and Linux, the settings.json entries, and how to keep the topic private.
  • Send Claude Code notifications to Telegram, Slack or DiscordOne hook script that posts Claude Code alerts to a Telegram bot, a Slack incoming webhook or a Discord webhook, on Mac, Windows and Linux.
  • Claude Code's built-in notifications: the terminal bell and preferredNotifChannelHow Claude Code's built-in alerts work, what each preferredNotifChannel value does, and how to set up iTerm2, Apple Terminal, Kitty, Ghostty and tmux.
  • Claude Code notifications in VS Code, Cursor and JetBrains terminalsWhy IDE terminals stay silent when Claude Code finishes, and how to get alerts in VS Code, Cursor and JetBrains with a setting or a hook.
  • Claude Code notifications not working? A checklistHooks not firing or no alert when Claude Code finishes? Work through this checklist, from /hooks and the debug log to ccn doctor and ccn test.
  • Quiet hours and Do Not Disturb for Claude Code notificationsStop Claude Code notifications at night or in meetings: quiet hours in your hook, Focus and Do Not Disturb on the phone, and ccn's quiet_hours.
  • Claude Code permission modes explained (default, acceptEdits, plan, bypassPermissions)What each Claude Code permission mode does (default, acceptEdits, plan, auto, dontAsk, bypassPermissions), how to switch, and when each is safe.
  • Running several Claude Code sessions: knowing which one needs youRunning parallel Claude Code sessions or worktrees? Name them, put the project in every alert, and send each request back to the right session.
  • Is it safe to approve Claude Code actions from your phone?How remote approval for Claude Code works, what can go wrong, what data leaves your computer, and the settings that keep it safe.
claude-code-notifier

Claude Code Notifier is an independent third-party application. It is not affiliated with, endorsed by, or sponsored by Anthropic, PBC. "Claude" and "Claude Code" are trademarks of Anthropic, PBC.

apps iOS App Android App ccn for macOS, Windows & Linux All guides
legal Privacy Policy Terms of Service Other languages © 2026 touchtap. All rights reserved. TouchTap Ltd is registered in England and Wales, company number 13942589.