claude-code - 💡(How to fix) Fix [DOCS] Remote Control docs missing mobile push notification setup and behavior [1 participants]

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/remote-control

Section/Topic

Remote Control mobile workflow and the config needed to receive mobile push notifications

Current Documentation

The Remote Control docs currently say:

Remote Control connects claude.ai/code or the Claude app for iOS and Android to a Claude Code session running on your machine. Start a task at your desk, then pick it up from your phone on the couch or a browser on another computer.

• Work from both surfaces at once: the conversation stays in sync across all connected devices, so you can send messages from your terminal, browser, and phone interchangeably

The comparison docs also say:

[Remote Control] Drive a running session from claude.ai/code or the Claude mobile app

And the settings docs only say:

Other configuration is stored in ~/.claude.json. This file contains your preferences (theme, notification settings, editor mode), OAuth session, MCP server configurations for user and local scopes, per-project state (allowed tools, trust settings), and various caches.

None of these pages document a mobile push notification feature, when it fires, or how to enable the required setting.

What's Wrong or Missing?

Changelog v2.1.110 added a new user-facing capability:

Added push notification tool - Claude can send mobile push notifications when Remote Control and "Push when Claude decides" config are enabled

The docs already position Remote Control as the way to continue work from your phone, but they do not explain that Claude can now proactively send mobile push notifications, what conditions must be true for that to work, or where users enable the Push when Claude decides setting.

That leaves the feature effectively undocumented: users reading the Remote Control and settings docs would not learn that mobile push notifications exist, that they depend on Remote Control, or that they require an explicit config toggle.

Suggested Improvement

Add a short section to the Remote Control docs describing mobile push notifications for Remote Control sessions.

Suggested content:

• Explain that Claude can send mobile push notifications for a Remote Control session when the Claude mobile app is connected and the relevant notification preference is enabled.
• Document the exact prerequisite combination from the changelog: Remote Control must be enabled and Push when Claude decides must be turned on.
• Add a cross-reference in the settings docs that names this preference explicitly and explains where users configure it.
• Clarify the intended use case, for example that Claude can notify you when it decides a mobile prompt or approval would be useful.

Impact

Medium - Makes feature difficult to understand

Additional Context

Affected Pages:

Total scope: 4 pages affected

Source: Changelog v2.1.110

Exact changelog entry: Added push notification tool - Claude can send mobile push notifications when Remote Control and "Push when Claude decides" config are enabled