[BUG] Claude Code for VS Code Extension SIGABRT on ARM64 with 64KB Page Size (Remote SSH)

[hmehrafarin]

Preflight Checklist

• I have searched existing issues and this hasn't been reported yet
• This is a single bug report (please file separate reports for different bugs)
• I am using the latest version of Claude Code

What's Wrong?

The Claude Code VS Code extension (in remote SSH) crashes with SIGABRT (exit code 134) on ARM64 systems using 64KB kernel page size.

What Should Happen?

Claude Code vscode extension should run on remote ssh or tunnels but it does not. In other words, extension should work on ARM64 systems regardless of kernel page size.

Error Messages/Logs

$ ~/.vscode-server/extensions/anthropic.claude-code-2.1.6-linux-arm64/resources/native-binary/claude --version
Aborted (core dumped)
$ echo $?
134


Exit code 134 = 128 + 6 (SIGABRT)

Steps to Reproduce

• Install Claude Code extension on VS Code Remote-SSH to an ARM64 server with 64KB page size
• Extension fails to start with "Not connected" errors

Probable Cause

The native binary was compiled for standard 4KB page size:

$ file .../native-binary/claude
ELF 64-bit LSB executable, ARM aarch64, version 1 (SYSV), dynamically linked, 
interpreter /lib/ld-linux-aarch64.so.1, for GNU/Linux 3.7.0, ...

$ getconf PAGESIZE
65536

Binaries compiled with 4KB page alignment are incompatible with 64KB page kernels on ARM64.

Claude Model

None

Is this a regression?

I don't know

Last Working Version

No response

Claude Code Version

2.1.6

Platform

Anthropic API

Operating System

Other Linux

Terminal/Shell

VS Code integrated terminal

Additional Information

No response

[wael-mika]

The same issue

[LorenzoTarricone]

I have the same issue!!

[hmehrafarin]

Any stats on this?

[wael-mika]

Is anyone working on it? Is there a way to bring attention to this issue?

[hmehrafarin]

@chrislloyd @dougbarth I am not sure if I am tagging the right people but I'd appreciate any input on this!

[Algomancer]

This is an annoying one in particular due to the npm depreciation.

[hmehrafarin]

Do you know if there Is any workaround to get it fixed?

[007]

Most likely depends on oven-sh/bun#17627 since claude is a bun-js binary.

[highker]

Workaround

Verify you're affected

# Should return 65536 (64KB) — if it returns 4096, this isn't your issue
getconf PAGESIZE

# Should abort with exit code 134
~/.cursor-server/extensions/anthropic.claude-code-*/resources/native-binary/claude --version

Prerequisites

A working Node.js-based Claude Code CLI install. Verify with:

claude --version

If you don't have it, install via:

npm install -g @anthropic-ai/claude-code

Apply the workaround

# 1. Find the extension directory (Cursor or VS Code)
CLAUDE_EXT=$(ls -d ~/.cursor-server/extensions/anthropic.claude-code-*-linux-arm64 2>/dev/null \
          || ls -d ~/.vscode-server/extensions/anthropic.claude-code-*-linux-arm64 2>/dev/null)
echo "Extension dir: $CLAUDE_EXT"

# 2. Back up the broken native binary
mv "$CLAUDE_EXT/resources/native-binary/claude" \
   "$CLAUDE_EXT/resources/native-binary/claude.bak"

# 3. Create a wrapper that delegates to the Node.js CLI
cat > "$CLAUDE_EXT/resources/native-binary/claude" << 'WRAPPER'
#!/bin/bash
exec claude "$@"
WRAPPER
chmod +x "$CLAUDE_EXT/resources/native-binary/claude"

# 4. Verify it works
"$CLAUDE_EXT/resources/native-binary/claude" --version

Caveats

• The wrapper uses whatever claude version is on your $PATH, which may differ from the extension version. You can pin it with:

  npm install -g @anthropic-ai/claude-code@<version>

• Extension auto-updates will overwrite the wrapper — you'll need to reapply after updates.