claude-code - 💡(How to fix) Fix remoteControlAtStartup: true in settings.json does not auto-enable remote control on new sessions [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#54527Fetched 2026-04-30 06:43:10
View on GitHub
Comments
1
Participants
2
Timeline
4
Reactions
0
Participants
Timeline (top)
labeled ×2commented ×1cross-referenced ×1

Setting remoteControlAtStartup: true in ~/.claude/settings.json does not automatically enable remote control when a new session starts. The session does not appear in the Claude mobile app (iPhone) until the user manually runs /remote-control inside the session.

Root Cause

Setting remoteControlAtStartup: true in ~/.claude/settings.json does not automatically enable remote control when a new session starts. The session does not appear in the Claude mobile app (iPhone) until the user manually runs /remote-control inside the session.

Fix Action

Workaround

Manually run /remote-control after each new session starts.

RAW_BUFFERClick to expand / collapse

Bug Report

Description

Setting remoteControlAtStartup: true in ~/.claude/settings.json does not automatically enable remote control when a new session starts. The session does not appear in the Claude mobile app (iPhone) until the user manually runs /remote-control inside the session.

Steps to Reproduce

  1. Add "remoteControlAtStartup": true to ~/.claude/settings.json
  2. Restart the Claude Code desktop app
  3. Open a new session
  4. Check the Claude mobile app — session does not appear in the session list

Expected Behavior

Remote control should be automatically enabled on session startup, and the session should appear in the Claude mobile app immediately without any manual intervention.

Actual Behavior

Remote control is not automatically enabled. User must manually run /remote-control inside the session each time to make it appear in the mobile app.

Environment

  • Claude Code version: 2.1.123
  • OS: Windows 11 Pro 10.0.26200
  • Platform: Desktop app
  • Mobile app: Claude for iPhone

Workaround

Manually run /remote-control after each new session starts.

extent analysis

TL;DR

Enable remote control automatically by modifying the session startup script to include the /remote-control command.

Guidance

  • Verify that the ~/.claude/settings.json file is correctly formatted and that the remoteControlAtStartup setting is properly set to true.
  • Check if there are any session-specific settings that might be overriding the global remoteControlAtStartup setting.
  • Consider adding a script or command to run automatically at session startup that executes the /remote-control command.
  • Investigate if there are any known issues or limitations with the Claude Code version 2.1.123 that might be causing this behavior.

Example

// ~/.claude/settings.json
{
  "remoteControlAtStartup": true
}

Note: This example only shows the relevant setting in the settings.json file.

Notes

The provided workaround of manually running /remote-control after each new session starts suggests that the issue is not with the mobile app or the network connection, but rather with the automatic enablement of remote control on the desktop app.

Recommendation

Apply workaround: Modify the session startup script to include the /remote-control command, as this is the most straightforward way to achieve the desired behavior until a potential fix is released.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix remoteControlAtStartup: true in settings.json does not auto-enable remote control on new sessions [1 comments, 2 participants]