[BUG] claude remote-control fails with "bad option: --sdk-url" on macOS
Preflight Checklist
- [x] 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 immediately fails after accepting the "Enable Remote Control?" prompt. The spawned child process passes --sdk-url as a Node.js flag instead of an application argument, causing Node.js to reject it with:
[10:34:09] Session failed: /opt/homebrew/Cellar/node@22/22.22.0_1/bin/node: bad option: --sdk-url session_01HGKCUBVV9Xk9UZnERtzykM
Tested with both Node.js v25.6.1 and v22.22.0 — same error on both. Claude Code v2.1.56, macOS Apple Silicon, Claude Max 5x account. Login is successful and shows Opus 4.6 · Claude Max.
What Should Happen?
Running claude remote-control should successfully start a Remote Control session, display a QR code or session URL, and allow connecting from the Claude mobile app or claude.ai/code. The --sdk-url argument should be passed to the Claude Code application process, not interpreted as a Node.js runtime flag.
Error Messages/Logs
$ claude remote-control
[10:34:09] Session failed: /opt/homebrew/Cellar/node@22/22.22.0_1/bin/node: bad option: --sdk-url session_01HGKCUBVV9Xk9UZnERtzykM
[10:34:09] To reconnect: claude --resume session_01HGKCUBVV9Xk9UZnERtzykM
Steps to Reproduce
Steps to Reproduce
Install Claude Code v2.1.56 globally via npm
Run claude and authenticate with /login (Claude Max 5x account)
Exit and run claude remote-control
Session starts but immediately fails with the above error
Claude Model
Opus
Is this a regression?
No, this never worked
Last Working Version
_No response_
Claude Code Version
v2.1.56,
Platform
Anthropic API
Operating System
macOS
Terminal/Shell
VS Code integrated terminal
Additional Information
i Have Claude Max 5X
and Here :
Bug Description
claude remote-control immediately fails with a Node.js error. The spawned child process receives --sdk-url as a Node.js flag instead of an application argument, causing Node to reject it.
Error Output
$ claude remote-control
[10:34:09] Session failed: /opt/homebrew/Cellar/node@22/22.22.0_1/bin/node: bad option: --sdk-url session_01HGKCUBVV9Xk9UZnERtzykM
[10:34:09] To reconnect: claude --resume session_01HGKCUBVV9Xk9UZnERtzykM
Steps to Reproduce
Install Claude Code v2.1.56 globally via npm
Run claude and authenticate with /login (Claude Max 5x account)
Exit and run claude remote-control
Session starts but immediately fails with the above error
Environment
Claude Code version: 2.1.56
OS: macOS 15.x (Apple Silicon / arm64)
Node.js versions tested: v25.6.1, v22.22.0 (both fail)
Installation method: npm install -g @anthropic-ai/claude-code
Account type: Personal, Claude Max 5x
Shell: zsh
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗