remote-control fails with 'bad option: --sdk-url' on v2.1.56

Resolved 💬 3 comments Opened Feb 25, 2026 by ramyanai Closed Mar 1, 2026

Bug Description

claude remote-control connects successfully but then immediately fails with a Node.js error:

Session failed: /usr/local/bin/node: bad option: --sdk-url session_01SEpAxeLkWnKNdjaNMC4vM6
To reconnect: claude --resume session_01SEpAxeLkWnKNdjaNMC4vM6

The session URL is generated and displayed, but the underlying session process crashes because --sdk-url is passed as a Node.js flag rather than as an application argument.

Steps to Reproduce

  1. Run claude remote-control
  2. Session connects and displays URL + QR code prompt
  3. After a few seconds, session fails with the error above

Environment

  • Claude Code version: 2.1.56 (latest on npm)
  • Node.js version: v22.14.0
  • OS: macOS (Darwin 25.3.0, Apple Silicon M1)
  • Install method: npm global (@anthropic-ai/claude-code)
  • Shell: zsh

Expected Behavior

Remote control session should remain connected and accessible from the browser/mobile app URL.

Actual Behavior

Session connects briefly then crashes. The --sdk-url flag appears to be passed to the Node.js binary itself rather than to the Claude Code application, causing Node to reject it as an unknown option.

View original on GitHub ↗

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