[BUG] claude remote-control fails: "bad option: --sdk-url"

Resolved 💬 1 comment Opened Feb 28, 2026 by anaximanrus Closed Feb 28, 2026

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.

View original on GitHub ↗

This issue has 1 comment on GitHub. Read the full discussion on GitHub ↗