claude-code - 💡(How to fix) Fix VS Code extension: native-UI sessions don't auto-engage Remote Control (remoteControlAtStartup: true ignored)

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…

The VS Code extension's native-UI Claude sessions don't appear on Remote Control even with "remoteControlAtStartup": true set in ~/.claude/settings.json. Engaging Remote Control requires a manual UI toggle per session, which is impractical when working many per-issue worktrees in separate VS Code windows.

Error Message

  • ~/.claude/settings.json has "remoteControlAtStartup": true.
  • CLI sessions launched outside VS Code (claude in a terminal) DO appear on the Remote Control list — works as documented.
  • VS Code native-UI Claude sessions (Ctrl+Esc / sidebar) DO NOT appear on the list.
  • Setting claudeCode.useTerminal: true (terminal mode) makes the extension spawn the regular claude CLI in an integrated terminal, and Remote Control auto-engages as expected. So terminal mode honors the setting; native UI does not.

Root Cause

The VS Code extension's native-UI Claude sessions don't appear on Remote Control even with "remoteControlAtStartup": true set in ~/.claude/settings.json. Engaging Remote Control requires a manual UI toggle per session, which is impractical when working many per-issue worktrees in separate VS Code windows.

Fix Action

Fix / Workaround

I attempted a workaround using claudeCode.claudeProcessWrapper to inject --remote-control 'Name' --name 'Name' flags via a tiny C# shim that wraps claude.exe. The shim is invoked correctly (Claude launches with no errors, the spawn log shows the wrapper path), but Remote Control still doesn't engage. The flags appear to be ignored when Claude is spawned via the SDK query() function (which native UI uses).

RAW_BUFFERClick to expand / collapse

Summary

The VS Code extension's native-UI Claude sessions don't appear on Remote Control even with "remoteControlAtStartup": true set in ~/.claude/settings.json. Engaging Remote Control requires a manual UI toggle per session, which is impractical when working many per-issue worktrees in separate VS Code windows.

Environment

  • VS Code extension anthropic.claude-code v2.1.143
  • Claude Code 2.1.143 (native install, ~/.local/bin/claude.exe)
  • Windows 11
  • claudeCode.useTerminal: false (default — native webview UI)

Observed behavior

  • ~/.claude/settings.json has "remoteControlAtStartup": true.
  • CLI sessions launched outside VS Code (claude in a terminal) DO appear on the Remote Control list — works as documented.
  • VS Code native-UI Claude sessions (Ctrl+Esc / sidebar) DO NOT appear on the list.
  • Setting claudeCode.useTerminal: true (terminal mode) makes the extension spawn the regular claude CLI in an integrated terminal, and Remote Control auto-engages as expected. So terminal mode honors the setting; native UI does not.

What I tried

I attempted a workaround using claudeCode.claudeProcessWrapper to inject --remote-control 'Name' --name 'Name' flags via a tiny C# shim that wraps claude.exe. The shim is invoked correctly (Claude launches with no errors, the spawn log shows the wrapper path), but Remote Control still doesn't engage. The flags appear to be ignored when Claude is spawned via the SDK query() function (which native UI uses).

This suggests Remote Control auto-start is gated on Claude running as an interactive shell session, not on the --remote-control flag being present in argv.

Use case

Per-issue git worktrees, each launched as a separate VS Code window. I'd like to monitor and steer those sessions from my phone via Remote Control without remembering to click the toggle in every fresh window.

Proposed solutions (any of these would unblock)

  1. Honor ~/.claude/settings.json's remoteControlAtStartup: true in native-UI mode the same way terminal mode does.
  2. Add a claudeCode.remoteControlAtStartup workspace setting that the extension fires toggle_remote_control for at session launch.
  3. Expose a VS Code command (e.g., claude-vscode.toggleRemoteControl) so users can trigger it via tasks.json, a keybinding, or an onStartup hook.

Notes for triage

The IPC plumbing already exists in the extension — toggle_remote_control, list_remote_sessions, remoteControlState are all referenced in extension.js. So this likely a small wiring change (extension reads the setting at session-launch time and fires the existing IPC message) rather than a new feature.

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