[BUG] claude remote-control fails: "bad option: --sdk-url"
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 on every attempt. The session connects to Anthropic's API briefly, then crashes because --sdk-url is being passed as a Node.js CLI flag instead of being handled internally by Claude Code.
The error occurs on Node.js v24, v22, and v20 — all produce the same result. Regular claude sessions work fine; only remote-control is affected.
What Should Happen?
A Remote Control session should start successfully, displaying a session URL and QR code for connecting from a mobile device or browser.
Error Messages/Logs
emote Control v2.1.63
Max concurrent sessions: 1
Environment ID: env_01QV6hV4DxGmhj8wduTNjqJD
[01:02:03] Connection error, retrying in 2.2s (0s elapsed): Request failed with status code 500: Internal server error
[01:02:05] Reconnected after 2s
[01:02:09] Session started: "Session session_0172u6i3hQKGyfYqXq2gBJqP" (session_0172u6i3hQKGyfYqXq2gBJqP)
[01:02:09] Debug log: /var/folders/pk/98_vw1qs36sdgm19glr12mhm0000gn/T/claude/bridge-session-session_0172u6i3hQKGyfYqXq2gBJqP.log
·✔︎· Connected · arbitro · HEAD
[01:02:09] Session failed: /opt/homebrew/Cellar/node@20/20.20.0/bin/node: bad option: --sdk-url session_0172u6i3hQKGyfYqXq2gBJqP
[01:02:09] To reconnect: claude --resume session_0172u6i3hQKGyfYqXq2gBJqP
[01:02:09] Failed to archive session session_0172u6i3hQKGyfYqXq2gBJqP: Not Found
[01:02:10] Environment deregistered.
[01:02:10] Environment offline.
Steps to Reproduce
Steps to Reproduce
Install Claude Code: npm install -g @anthropic-ai/claude-code@latest
Authenticate: run claude then /login
Navigate to any project directory: cd ~/Desktop/arbitro
Run claude remote-control or claude remote-control --verbose
Session connects briefly then fails with "bad option: --sdk-url"
Claude Model
None
Is this a regression?
No, this never worked
Last Working Version
N/A
Claude Code Version
2.1.63 (Claude Code)
Platform
Anthropic API
Operating System
macOS
Terminal/Shell
Terminal.app (macOS)
Additional Information
Additional Information
Tested on three Node.js versions: v24.13.1, v22.22.0, and v20.20.0 — identical error on all
macOS on Apple Silicon (MacBook Air)
Reinstalled Claude Code from scratch (uninstall → cache clean → reinstall) with no effect
Regular claude sessions launch and work correctly
It appears Claude Code is spawning a child process like node --sdk-url <session_id> ..., but --sdk-url is not a valid Node.js flag. This should likely be passed as an application argument after the script path, not as a Node runtime flag.
This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗