claude-code - 💡(How to fix) Fix GUI SSH "Add connection" feature — remote ccd-cli helper crashes with exit 1 during initialize on [1 comments, 2 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#49586Fetched 2026-04-17 08:36:57
View on GitHub
Comments
1
Participants
2
Timeline
5
Reactions
0
Timeline (top)
labeled ×4commented ×1

Error Message

  • Running ccd-cli/2.1.111 directly with --print --output-format=stream-json without --verbose returns: Error: the helper supports, OR surface a clear version-mismatch error instead of "exit code 1".

Fix Action

Fix / Workaround

Workaround: SSH + run claude in Terminal works.

RAW_BUFFERClick to expand / collapse

Evidence:

  • /root/.claude/remote/remote-server.log shows Process <uuid> exited with code 1 immediately after WriteStdin of initialize request
  • Running ccd-cli/2.1.111 directly with --print --output-format=stream-json without --verbose returns: Error: When using --print, --output-format=stream-json requires --verbose — suggests the GUI may not always be passing --verbose correctly, or the helper binary is out of sync with what the GUI expects
  • Running with --verbose injected and all GUI flags still exits 1 (likely due to claude-opus-4-7[1m] model ID with the [1m] context-window suffix — unclear if helper 2.1.111 supports this syntax)
  • Reproduces on both workspace folder (/docker/.../workspace, which has a SessionStart hook) and /root (no hooks) — so not hook-related
  • Does not reproduce via direct Terminal SSH + claude CLI — only via GUI's "New SSH connection" flow

Expected: GUI should either download a helper version that matches the flags it sends, OR degrade to flags the helper supports, OR surface a clear version-mismatch error instead of "exit code 1".

Workaround: SSH + run claude in Terminal works.

Logs available on request:

  • /root/.claude/remote/remote-server.log (RPC traffic)
  • /var/log/auth.log (SSH session open/close)

extent analysis

TL;DR

The issue can be worked around by using SSH and running the claude command in the Terminal instead of through the GUI's "New SSH connection" flow.

Guidance

  • The error message suggests that the GUI may not be passing the --verbose flag correctly, or the helper binary is out of sync with what the GUI expects.
  • The fact that running with --verbose injected still exits with code 1 implies that the issue may be related to the claude-opus-4-7[1m] model ID syntax, which may not be supported by the helper version 2.1.111.
  • To mitigate the issue, the GUI should either download a helper version that matches the flags it sends, or degrade to flags the helper supports, or surface a clear version-mismatch error.
  • The workaround of using SSH and running the claude command in the Terminal works, suggesting that the issue is specific to the GUI's "New SSH connection" flow.

Example

No code snippet is provided as it is not clearly supported by the issue.

Notes

The issue may be related to a version mismatch between the GUI and the helper binary, or a syntax issue with the model ID. The workaround provides a temporary solution, but a more permanent fix would require addressing the underlying issue.

Recommendation

Apply workaround: using SSH and running the claude command in the Terminal instead of through the GUI's "New SSH connection" flow, as it provides a reliable alternative until the underlying issue is resolved.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix GUI SSH "Add connection" feature — remote ccd-cli helper crashes with exit 1 during initialize on [1 comments, 2 participants]