VS Code extension does not work with Remote-SSH (always uses local Windows paths)
Resolved 💬 3 comments Opened Jan 23, 2026 by augustovrocha Closed Jan 26, 2026
Description
The Claude Code VS Code extension does not work properly when connected to a remote Linux server via Remote-SSH. The extension always tries to use local Windows paths instead of the remote server paths.
Environment
- Local OS: Windows 11
- Remote OS: Linux (Ubuntu)
- VS Code: Latest version with Remote-SSH extension
- Claude Code Extension: 2.1.17
- Claude Code CLI on remote server: 2.1.17 (installed at
~/.local/bin/claude)
Problem
When connected to a Linux server via Remote-SSH, the extension:
- Tries to spawn the Windows binary (
claude.exe) instead of the Linux binary - Uses Windows paths like
\rootandC:\Users\<user>\.claude\projects\-root - Fails with error:
Claude Code native binary not found at claude
Error Logs
[info] Spawning Claude with SDK query function - cwd: \root, permission mode: default, version: 2.1.17, claude, resume: undefined
[error] Failed to load config cache: ReferenceError: Claude Code native binary not found at claude. Please ensure Claude Code is installed via native installer or specify a valid path with options.pathToClaudeCodeExecutable.
[warning] Failed to load sessions from \root: Error: ENOENT: no such file or directory, scandir 'C:\Users\conta\.claude\projects\-root'
Steps to Reproduce
- Install VS Code with Remote-SSH extension on Windows
- Install Claude Code extension
- Connect to a Linux server via SSH
- Install Claude Code CLI on the Linux server (
curl -fsSL https://claude.ai/install.sh | sh) - Open Claude Code panel in VS Code
- Extension fails to connect - uses Windows paths instead of Linux paths
Attempted Workarounds
- Installed extension on both LOCAL and SSH remote
- Tried setting
claudeCode.claudeProcessWrapperto/root/.local/bin/claude - Tried setting
claudeCode.pathToClaudeCodeExecutableto/root/.local/bin/claude - Created directory
C:\Users\<user>\.claude\projects\-rooton Windows
None of these workarounds resolved the issue.
Expected Behavior
When connected via Remote-SSH, the extension should:
- Detect that it's in a remote environment
- Use the Claude CLI installed on the remote server
- Use Linux paths for the remote server (e.g.,
/root/.claude/projects/root)
Current Workaround
Using Claude Code CLI directly in the terminal on the remote server works perfectly. Only the VS Code extension integration is broken.
This issue has 3 comments on GitHub. Read the full discussion on GitHub ↗