[BUG] `claude remote-control` fails with 'bad option: --sdk-url' on Node.js v20 and v22

Resolved 💬 3 comments Opened Feb 25, 2026 by tuxxon Closed Feb 26, 2026

Bug Description

claude remote-control immediately fails with the error:

Session failed: /Users/<user>/.nvm/versions/node/v20.18.3/bin/node: bad option: --sdk-url session_<id>

It appears that when claude remote-control spawns a child process, --sdk-url is being passed as a Node.js runtime flag instead of as a script argument.

Steps to Reproduce

  1. Install Claude Code 2.1.56 via npm install -g @anthropic-ai/claude-code
  2. Run claude remote-control from terminal

Expected Behavior

Remote Control session should start and display a session URL and QR code.

Actual Behavior

Session immediately fails with:

[21:32:59] Session failed: /Users/<user>/.nvm/versions/node/v20.18.3/bin/node: bad option: --sdk-url session_<id>
[21:32:59] To reconnect: claude --resume session_<id>

Environment

  • Claude Code version: 2.1.56
  • Node.js versions tested: v20.18.3, v22.21.1 (same error on both)
  • OS: macOS Darwin 25.3.0
  • Shell: zsh
  • Subscription: Max plan
  • Node manager: nvm
  • Installation method: npm install -g @anthropic-ai/claude-code

Notes

  • Tested with both Node.js v20 (LTS) and v22 — same error on both versions.
  • The --sdk-url flag is not a valid Node.js option, suggesting it's being passed to the node binary directly rather than as an argument to the Claude Code script.
  • Running claude normally (without remote-control) works fine.

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗