How to Get Claude Code Notifications on Your iPhone

You start a Claude Code session. Ask it to refactor your auth module. It's going to take a few minutes, so you grab coffee. When you get back, Claude's been waiting on a permission prompt for eight minutes. Eight minutes of dead time because you weren't staring at your terminal.

This is the core friction of vibe-coding. You want Claude doing the heavy lifting, but you need to be available when it needs you. The moment you step away, you risk wasted time.

Here's how to fix that — push notifications for Claude Code, straight to your iPhone.

What You Need

• An iPhone running iOS 18 or later
• Claude Code installed on your Mac or dev machine
• Agentfy from the App Store (free)

Step 1: Download Agentfy

Grab Agentfy from the App Store. Open it up and sign in — it takes a few seconds. Once you're in, you'll see a unique webhook URL in your settings. This is what connects Claude Code to your phone.

Step 2: Connect Claude Code

Agentfy runs off Claude Code hooks — a built-in feature that lets Claude Code fire events when things happen. You have two options:

Option A: Paste a prompt (fastest)

The app gives you a ready-made prompt. Copy it, paste it into any Claude Code session, and Claude will configure your ~/.claude/settings.json automatically. One prompt, done.

Option B: Edit settings.json manually

If you prefer hands-on setup, add the webhook to your hooks config directly:

// ~/.claude/settings.json
{
  "hooks": {
    "Stop": [{
      "matcher": "",
      "hooks": [{
        "type": "command",
        "command": "curl -s -X POST YOUR_AGENTFY_URL..."
      }]
    }]
  }
}

Replace YOUR_AGENTFY_URL with the webhook URL from your Agentfy app settings. The app shows the full configuration — including hooks for Stop, SessionStart, Notification, and PermissionRequest.

Step 3: That's It

Your Claude Code agents now report to your phone. Here's what you'll see:

• Push notifications — the moment Claude needs permission, finishes a task, or hits an error
• Live Activities on your lock screen — see all your agent statuses without unlocking your phone
• Dynamic Island — at-a-glance status for the agent that needs you most

What Notifications Do You Get?

Agentfy sends you a push notification whenever an agent enters the "Your Move" state — meaning Claude stopped and is waiting on you. This includes:

• Permission requests — "Allow: npm test?", "Allow: rm -rf dist/"
• Task completions — Claude finished what you asked
• Errors — something went wrong and Claude needs guidance
• Custom notifications — when Claude explicitly notifies you about something

You don't get spammed with every tool call or file read. Only the moments that need your attention.

Tracking Multiple Agents

Running Claude Code in three terminals across two projects? Agentfy tracks them all. The dashboard shows which agents are cooking, which need you, and which are new — across unlimited terminals. Live Activities on your lock screen give you the consolidated view: "2 cooking, 1 needs you."

Privacy and What Gets Sent

Agentfy receives session state data from Claude Code hooks. That means:

• Session ID and project name
• Current state (working, needs input, done)
• Tool name and permission context (e.g., "Bash: npm test")

It does not receive your actual code, full prompts, or file contents. There's an optional "Prompt Preview" feature that shows the first 30 characters of your prompt — it's off by default and you can toggle it anytime.

Troubleshooting

If notifications aren't coming through:

• Make sure Claude Code hooks are configured — run cat ~/.claude/settings.json and check for the Agentfy webhook URL
• Restart Claude Code if you just added the hooks (use /resume to continue your conversation)
• Check that notifications are enabled for Agentfy in your iPhone Settings
• If all else fails, go to Settings > Having Issues in the app and tap "Regenerate Token", then re-run the setup prompt

Free vs Pro

Agentfy is free to download and use. Free users get 25 push notifications per month. If you're running agents heavily and need unlimited notifications plus Live Activity support, Pro is available as a monthly, yearly, or one-time lifetime purchase.