[BUG] SSH remote connection broken after Desktop app update to 1.8555.0 (worked in 1.8089.0)

Status Fixed / completed
Maintainer reply None cached
Activity 5 comments · opened May 22, 2026 · closed Jun 3, 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?

After updating the Claude Code Desktop app to 1.8555.0 (released May 21, 2026), my previously-working SSH remote session no longer connects. The same configuration worked correctly on 1.8089.0 (May 19, 2026). No changes were made to the remote server, SSH config, or network between the two versions.
The 1.8555.0 release notes explicitly mention changes to remote-session reconnection behavior:

Fixed: Remote sessions reconnect on their own after sleep or network changes

This suggests the regression was introduced by changes to the remote-session/reconnection path in this release.

What Should Happen?

Claude Code should be able to connect to the remote machine via SSH.

Error Messages/Logs

Steps to Reproduce

Have a working SSH remote session configured on Desktop app 1.8089.0
Update Desktop app to 1.8555.0
Attempt to open the previously-working SSH remote session
Connection fails

Claude Model

Opus

Is this a regression?

Yes, this worked in a previous version

Last Working Version

1.8089.0

Claude Code Version

1.8555.0

Platform

Anthropic API

Operating System

macOS

Terminal/Shell

Terminal.app (macOS)

Additional Information

_No response_

View original on GitHub ↗

5 Comments

github-actions[bot] · 4 months ago

Found 3 possible duplicate issues:

  1. https://github.com/anthropics/claude-code/issues/48523
  2. https://github.com/anthropics/claude-code/issues/39433
  3. https://github.com/anthropics/claude-code/issues/52734

This issue will be automatically closed as a duplicate in 3 days.

  • If your issue is a duplicate, please close it and 👍 the existing issue instead
  • To prevent auto-closure, add a comment or 👎 this comment

🤖 Generated with Claude Code

erik-middesk · 4 months ago

This issue is not a duplicate of the above.

jshaofa-ui · 4 months ago

Solution: claude-code #61498 — SSH Remote Connection Broken After Desktop Update

🔍 Root Cause

SSH remote connections worked in Desktop 1.8089.0 but broke in 1.8555.0 — a clear regression. Likely causes:

  1. SSH connection handling refactoring between versions
  2. Electron/Node.js version upgrade affecting SSH library behavior
  3. Network/security policy change blocking SSH by default
  4. SSH key/path resolution change in the remote context

🔧 Fix

1. Compare SSH connection code between versions

Identify the specific change that broke SSH. Focus on:

  • SSH tunnel creation
  • Port forwarding setup
  • SSH key loading
  • Connection timeout handling

2. Add SSH connection diagnostics

async function connectSSH(config: SSHConfig): Promise<SSHConnection> {
    try {
        logger.debug('SSH connecting', { host: config.host, port: config.port });
        const conn = await ssh2.connect(config);
        logger.debug('SSH connected successfully');
        return conn;
    } catch (err) {
        logger.error('SSH connection failed', { host: config.host, error: err.message, code: err.code });
        throw err;
    }
}

3. Add fallback connection methods

If primary SSH fails, try system ssh command as fallback.

🧪 Testing

  • Verify SSH works with same config that worked in 1.8089.0
  • Test on macOS, Linux, Windows
  • Test with RSA, Ed25519, ECDSA keys
  • Test with and without ~/.ssh/config

⚠️ Edge Cases

  • Respect ~/.ssh/config (ProxyJump, ProxyCommand, custom ports)
  • Support ssh-agent for key management
erik-middesk · 4 months ago

The above did not solve the issue.

github-actions[bot] · 2 months ago

This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.