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

Resolved 💬 3 comments Opened Feb 25, 2026 by khlifizied Closed Mar 1, 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 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

View original on GitHub ↗

This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗