Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [BUG] SIGILL on ARM64 AVF (Android Virtualization Framework) VM — regression introduced in v2.1.113 [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#55519•Fetched 2026-05-03 04:51:16
View on GitHub
Comments
1
Participants
2
Timeline
7
Reactions
0
Author
matgianesinimatgianesini
Participants
github-actions[bot]github-actions[bot]matgianesinimatgianesini
Timeline (top)
labeled ×5closed ×1commented ×1

Error Message

Error Messages/Logs

Root Cause

The host hardware (Snapdragon 8 Gen 1) fully supports ARMv9 including SVE2, LSE2, etc. However, the AVF hypervisor exposes a filtered subset of instructions to the guest VM. Something introduced in the Bun binary between v2.1.112 and v2.1.113 uses an instruction that falls outside what AVF permits.

Diffing the Bun version or compiler flags between these two Claude Code releases should identify the specific instruction.

Fix Action

Workaround

npm install -g @anthropic-ai/[email protected]
echo 'export DISABLE_AUTOUPDATER=1' >> ~/.bashrc

Code Example

============================================================
Bun v1.3.14 (0a466a11) Linux arm64
Linux Kernel v6.1.0 | glibc v2.36
CPU: neon fp aes crc32 atomics
Args: /usr/bin/bash: line 3: 1310 Illegal instruction    ( claude --version )

---

npm install -g @anthropic-ai/claude-code@2.1.113
claude --version  # → SIGILL crash

npm install -g @anthropic-ai/claude-code@2.1.112
claude --version  # → works correctly

---

fp asimd evtstrm aes pmull sha1 sha2 crc32 atomics fphp asimdhp cpuid
asimdrdm jscvt fcma lrcpc dcpop sha3 sm3 sm4 asimddp sha512 asimdfhm
dit uscat ilrcpc flagm sb paca pacg dcpodp sve2 sveaes svepmull
svebitperm svesha3 svesm4 flagm2 frint svei8mm svebf16 i8mm bf16 dgh
bti ecv afp wfxt

---

npm install -g @anthropic-ai/claude-code@2.1.112
echo 'export DISABLE_AUTOUPDATER=1' >> ~/.bashrc
RAW_BUFFERClick to expand / collapse

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?

Claude Code crashes with Illegal instruction (SIGILL) on ARM64 Linux running inside an Android Virtualization Framework (AVF) virtual machine. The AVF hypervisor filters certain CPU instructions from guests even when the host hardware supports them fully. A binary search confirmed this is a clean regression introduced between v2.1.112 (working) and v2.1.113 (broken). This is not the 64K page size issue from #25713 — page size is confirmed 4K.

What Should Happen?

claude --version should print a version number.

Error Messages/Logs

============================================================
Bun v1.3.14 (0a466a11) Linux arm64
Linux Kernel v6.1.0 | glibc v2.36
CPU: neon fp aes crc32 atomics
Args: /usr/bin/bash: line 3: 1310 Illegal instruction    ( claude --version )

Steps to Reproduce

npm install -g @anthropic-ai/[email protected]
claude --version  # → SIGILL crash

npm install -g @anthropic-ai/[email protected]
claude --version  # → works correctly

Claude Model

None

Is this a regression?

Yes, this worked in a previous version

Last Working Version

2.1.112

Claude Code Version

2.1.113

Platform

Anthropic API

Operating System

Ubuntu/Debian Linux

Terminal/Shell

Other

Additional Information

Environment

FieldValue
Last working versionv2.1.112
First broken versionv2.1.113
OSDebian 12 (Bookworm)
Kernel6.1.0-34-avf-arm64
ArchitectureARM64 (aarch64)
HypervisorAndroid Virtualization Framework (AVF / pKVM)
Host deviceSamsung Galaxy Tab S11 Ultra (Snapdragon 8 Gen 1)
glibc2.36
Page size4096 (4K — not the #25713 issue)
Node.jsv24.15.0 (via NVM)
Installation methodnpm

CPU Info

CPU parts present: 0xd81 (Cortex-A510) × 3, 0xd82 (Cortex-A710) × 3, 0xd85 (Cortex-X2) × 1 — a fully modern ARMv9 big.LITTLE configuration.

Full CPU features exposed by AVF guest kernel:

fp asimd evtstrm aes pmull sha1 sha2 crc32 atomics fphp asimdhp cpuid
asimdrdm jscvt fcma lrcpc dcpop sha3 sm3 sm4 asimddp sha512 asimdfhm
dit uscat ilrcpc flagm sb paca pacg dcpodp sve2 sveaes svepmull
svebitperm svesha3 svesm4 flagm2 frint svei8mm svebf16 i8mm bf16 dgh
bti ecv afp wfxt

Analysis

The host hardware (Snapdragon 8 Gen 1) fully supports ARMv9 including SVE2, LSE2, etc. However, the AVF hypervisor exposes a filtered subset of instructions to the guest VM. Something introduced in the Bun binary between v2.1.112 and v2.1.113 uses an instruction that falls outside what AVF permits.

Diffing the Bun version or compiler flags between these two Claude Code releases should identify the specific instruction.

Workaround

npm install -g @anthropic-ai/[email protected]
echo 'export DISABLE_AUTOUPDATER=1' >> ~/.bashrc

extent analysis

TL;DR

The most likely fix is to downgrade to Claude Code version 2.1.112, as a specific instruction introduced in version 2.1.113 is not supported by the Android Virtualization Framework (AVF) hypervisor.

Guidance

  • Identify the specific instruction causing the issue by diffing the Bun binary between versions 2.1.112 and 2.1.113.
  • Consider using a different hypervisor that supports the required instructions or updating the AVF hypervisor to expose the necessary instructions to the guest VM.
  • Apply the provided workaround by downgrading to version 2.1.112 and disabling auto-updater to prevent accidental updates.

Example

No code snippet is provided as the issue is related to a specific binary instruction.

Notes

The issue is specific to the ARM64 Linux environment running inside an Android Virtualization Framework (AVF) virtual machine, and the solution may not apply to other environments.

Recommendation

Apply the workaround by downgrading to version 2.1.112, as it is a known working version, and disabling auto-updater to prevent accidental updates. This will allow the user to continue using Claude Code until a permanent fix is available.

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…
#api#installation#retriever error#indexing error#inference speed

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 [BUG] SIGILL on ARM64 AVF (Android Virtualization Framework) VM — regression introduced in v2.1.113 [1 comments, 2 participants]