claude-code - 💡(How to fix) Fix [BUG] Remote Control mobile push notifications not delivered on iOS despite connected session [1 comments, 2 participants]

Preflight Checklist

• I have searched existing issues and this hasn't been reported yet
• This is a single bug report (please file separate reports for different bugs)
• I am using the latest version of Claude Code

What's Wrong?

Push notifications from Claude Code are not being delivered to the iPhone even though the Remote Control session shows as "Connected" in the app. The system confirms "Mobile push requested" on the terminal side, but no notification arrives on the device.

Related issue: https://github.com/anthropics/claude-code/issues/50949

Environment

• Device: iPhone 11 (MHDH3BR/A)
• iOS Version: 18.6.2
• Claude app: background (not force-closed)
• Remote Control status: Connected (green indicator visible in app)

iOS Notification Settings

• Permitir Notificações: ✔️ enabled
• Lock Screen, Notification Center, Banners: ✔️ all enabled
• Sounds: ✔️ enabled
• Badges: ✔️ enabled

What Should Happen?

A push notification should appear on the iPhone when "Mobile push requested" is returned.

Error Messages/Logs

Steps to Reproduce

Configure settings.local.json with:

{
  "hooks": {
    "Notification": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.message // \"Claude Code\"' | xargs -I {} notify-send \"Claude Code\" \"{}\" 2>/dev/null || true",
            "statusMessage": "Enviando notificação..."
          }
        ]
      }
    ]
  },
  "agentPushNotifEnabled": true,
  "inputNeededNotifEnabled": true,
  "preferredNotifChannel": "auto"
}

Then:

1. Open Claude Code CLI and start a Remote Control session (/remote-control)
2. Open Claude app on iPhone and confirm session shows "Connected"
3. Send app to background (do not force-close)
4. Trigger a PushNotification from the CLI session
5. Terminal shows: Terminal notification sent. Mobile push requested.
6. No notification appears on iPhone (lock screen, banner, or notification center)

Claude Model

Sonnet (default)

Is this a regression?

I don't know

Last Working Version

No response

Claude Code Version

2.1.140 (Claude Code)

Platform

Anthropic API

Operating System

Other Linux

Terminal/Shell

Other

Additional Information

No response