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
- Run
claude remote-control - Session connects and displays URL + QR code prompt
- 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.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗