[BUG] claude remote-control fails with "bad option: --sdk-url"
Preflight Checklist
- [ ] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report (please file separate reports for different bugs)
- [x] I am using the latest version of Claude Code
What's Wrong?
claude remote-control fails consistently with the following error:
Session failed: /usr/local/bin/node: bad option: --sdk-url session_01UqSVbPEe2GsVmmrxPqGCni
It appears --sdk-url is being passed as a Node.js CLI flag instead of as an argument to the Claude Code script. Node.js does not recognize this flag, causing immediate failure.
Intermittently, a different error also occurs:
Error: Request failed with status code 500
Reproduction rate: 3/3 attempts failed (2x --sdk-url error, 1x 500 error).
Environment:
- Claude Code: 2.1.56
- Node.js: v22.13.1
- Node path: /usr/local/bin/node
- OS: macOS Darwin 25.3.0
What Should Happen?
claude remote-control should successfully start a remote control session and display a QR code / session URL for connecting from another device.
Error Messages/Logs
[03:50:15] Session failed: /usr/local/bin/node: bad option: --sdk-url session_01XHS1zNhbuxXSneESCK9Bsh
[03:50:15] To reconnect: claude --resume session_01XHS1zNhbuxXSneESCK9Bsh
Steps to Reproduce
Run claude remote-control in any directory
Claude Model
None
Is this a regression?
Yes, this worked in a previous version
Last Working Version
_No response_
Claude Code Version
2.1.56
Platform
Anthropic API
Operating System
macOS
Terminal/Shell
Terminal.app (macOS)
Additional Information
_No response_
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗