Packaging and install issues on Linux — page 3
Issues the maintainers labelled both platform:linux and area:packaging.
262 issues · 55 open · 207 resolved (79%) · first seen May 25, 2025
Is this getting better or worse?
This class of problem is still growing. 64 new reports in the last 90 days vs 43 in the 90 before — +49%. The open backlog peaked at 55 in 2026-10 and sits at 55 today.
Derived by counting each matching issue from its creation date until it closed. First-party
computation over the anthropics/claude-code tracker — the trend is not published
anywhere upstream.
Which builds report this
161 of these reports name the Claude Code build they were running, spanning 80 releases. Heaviest reporters:
- Claude Code v2.1.241
- Claude Code v2.1.15
- Claude Code v2.1.113
- Claude Code v2.1.139
- Claude Code v2.1.150
- Claude Code v2.1.237
- Claude Code v2.1.112
- Claude Code v2.1.29
Report volume, not a defect count: an issue can mention a build without that build having caused the failure. Versions come from the version string in the bug-report template, matched against real published tags.
Do these get fixed?
Median time to close is 35 days across 207 closures. Of the 207 closures with a recorded reason, 34% were closed as completed and 136 as not-planned or duplicate. The most recent completed fix landed in 2026-09.
Workarounds reported by the community
106 of these issues post a workaround someone says worked. The highest-engagement ones:
- [BUG] IDE Integration Not Working After `/migrate-installer` on Linux
- …uts, and opening diffs in VS Code viewer Additional Context Workaround Found: Adding the local Claude CLI path to PATH resolves the issue: Technical Details: - Local Claude executable location: - The executable is proper…
Found in the description of #2253 · resolved - [BUG] npm install now ships Bun binary (v2.1.126) — npm workaround for non-AVX VPS is dead, no upgrade path
- …oint. This means the npm installation path — the documented workaround for non-AVX environments — no longer works. I am a paying subscriber using Claude Code professionally for server administration and development acros…
Found in the description of #55520 · still open - v2.1.15 crashes on CPUs without AVX (regression from 2.1.14)
- …- Bun version (from crash output): Bun v1.3.6 Error Output Workaround Rolling back to v2.1.14 resolves the issue: Notes - The physical CPU (Xeon Gold 6142) supports AVX, but the VM hypervisor does not expose AVX instruc…
Found in the description of #19907 · resolved - [BUG] Read tool's PDF support requires poppler-utils but it's undocumented, usually absent, and not detected after install
- …elated: 23699 (Read tool errors are not shown in TUI) - The workaround is + + on the resulting text file — 3 tool calls for what should be a single ✍️ Author : Claude Code with @carrotRakko (AI-written, human-approved)
Found in the description of #23704 · still open - [BUG] v2.1.63 crashes on Alpine Linux (musl): posix_getdents symbol not found
- …getdents is a glibc-specific symbol absent from musl libc. Workaround: roll back the symlink: ln -sf ~/.local/share/claude/versions/2.1.62 ~/.local/bin/claude
Found in the description of #29559 · resolved
Excerpts are quoted from the linked issue so you can judge relevance before opening it. Threads that only ask for a workaround, or report that there is none, are excluded. These are community suggestions, not official guidance from Anthropic — read the full thread before applying one.
Matching issues 201–262
Ranked by community engagement (reactions weighted over comments).
- False "Update available" notification when installed via apt/deb package
- [Bug] Auto-update error despite passing doctor checks
- Claude Code 2.1.159 crashes with General Protection Fault on VirtualBox (Xubuntu 24.04)
- Bug: Segmentation Fault in native binary on Ubuntu 26.04 (exit code 139)
- Bun segfaulting in claude-code, thought you should know
- [BUG] bundled avx is not running and installing avx2 on newer CPU's
- [FEATURE] Add support for linux-loong64 (LoongArch64) platform!!
- [BUG] Linux: Bun runtime segfault on Linux (claude-code 2.1.143, Bun 1.3.14, Ubuntu 24.04 / kernel 6.18.x)
- [BUG] SIGILL on ARM64 AVF (Android Virtualization Framework) VM — regression introduced in v2.1.113
- [BUG] Claude Code no longer works since version 2.1.113 on my machine.
- [BUG] Can't run Claude - Illegal instruction (core dumped) after after to anything after 2.1.112
- Bun 1.3.13 SIGSEGV at 0x8 in WebKit GC (PolymorphicAccessJITStubRoutine) during long session
- v2.1.97 crashes on Linux x64 with Bun CommonJS module error
- [BUG] SSH remote: ccd-cli v2.1.78 crashes with `invalid opcode` on QEMU virtual CPUs (regression from v2.1.72)
- False PATH warning on Synology NAS due to symlinked home directory
- [Feature Request] Architecture-optimized native builds (PGO/BOLT/CPU-specific)
- [BUG] Claude Code launches Pacman game on Ubuntu when checking installation method
- [BUG] Marketplace plugin updates accumulate git history instead of staying shallow
- Homebrew cask not available on Linux - consider adding a formula
- [BUG] Plugin installation does not preserve executable permissions on shell script hooks
- [BUG] Claude Code 2.1.15 crashes with "Illegal instruction" on virtualized environments lacking AVX CPU support (Bun runtime requirement)
- [FEATURE] Add support for riscv64 architecture
- [DOCS] Inconsistent installation instructions: Troubleshooting guide recommends deprecated NPM method instead of native installer
- False installation mismatch warning for pnpm global installations
- [Bug] `claude update` fails with "Another Claude process is currently running" due to stale lock files
- npm Global Install Permissions Failure with Sudo Chown Command
- Native Installer Incorrectly Rejects aarch64 as "Unsupported architecture: arm"
- Title: Persistent Update Notification Blocking Claude 4 Access This issue title captures the core problem of: - Continuous update notifications - Inability to access Claude 4 despite paying for service - Potential update system malfunction The title is t
- [BUG] SIGILL on main thread inside JSC JIT code during "Compacting conversation…", 2.1.296 / Bun 1.4.3, Linux x64
- VS Code extension native binary crashes (SIGSEGV) on CPU with AVX but no AVX2
- [BUG] Claude Code 2.1.277 crashes on startup
- [BUG] Bun segfault/SIGABRT on startup — Ubuntu 26.04.1 LTS (glibc 2.43)
- [BUG] Recurring idle SIGSEGV/SIGABRT in JSC (GC marking, microtask queue, JIT) on Linux x64 — Bun v1.4.1; fixed-looking bug in Bun 1.4.2
- [BUG] Native Linux build crashes (SIGILL/SIGSEGV) in JSC GC HeapHelper thread, 8x/day on 2.1.258, same Bun 1.4.1 in 2.1.259
- Bun v1.4.1 (392624bed) still segfaults intermittently on Linux x64
- [BUG] SIGSEGV on launch (glibc build) on CachyOS — glibc 2.44 / kernel 7.2 / Bun incompatibility; musl build works
- [BUG] Segfault on startup persists in 2.1.246 (Bun runtime, SIGSEGV at si_addr=NULL) — regression of #62747
- Segfault at startup on Linux since 2.1.242 — bundled allocator's free null-derefs when called from glibc __newlocale
- Claude Code 2.1.243 segfaults on startup in __newlocale on glibc 2.44 (Bun/mimalloc build)
- Illegal instruction crash on ARM64 Linux in Apple Virtualization Framework (AVF) — embedded Bun runtime incompatible
- [BUG] Bundled Bun 1.4.0 (Rust) panics `index out of bounds: the len is 1 but the index is 1` on Linux x64 — repeated crashes in `--resume` picker and long-running sessions
- [BUG] Claude Code 2.1.210 crashes with segmentation fault on Linux ARM64
- [BUG] Claude Code 2.5.0 fails to open in Home Assistant Terminal
- BUG: Claude Code v2.1.63+ crashes on musl (posix_getdents symbol not found)
- [BUG] Claude Code Installation Failure Report - Replit Environment
- Installation lock bug: --force flag doesn't work when Claude is running
- ● Update(.claude/settings.json) Unable to activate custom output styles : created two following the process. None have been added to the selection list.
- [BUG] SIGILL (`cntb`, SVE) on linux-arm64 in Android AVF guest
- [FEATURE] [Linux] Please add fedora and arch repos
- npm auto-update during network outage replaces working install with 500-byte stub
- [Feature Request] Add RPM package support for Claude Desktop on Fedora/RHEL
- [BUG] Bun 1.4.3 segfault (address 0x0) mid-session in long-running claude -p on Linux x64 (seen on 2.1.284 and 2.1.286)
- [BUG] 2.1.284 regression: Bun 1.4.3 panics on startup on Linux x64 (`index out of bounds: the len is 0 but the index is 3`); 2.1.283 works
- [BUG] https://github.com/anthropics/claude-code/issues/87974#issuecomment-5774787317
- [Bug] Auto-update repeatedly fails when network connection is lost
- False "Update available! Run: mise upgrade claude" when mise is already on latest
- [BUG] Segfault at startup on Linux from 2.1.251 onward (bundled Bun 1.4.1); 2.1.243 with Bun 1.4.0 works
- [Bug] Silent npm global install failure with stale staging directory leaves corrupted binary
- Native binary 2.1.242 segfaults deterministically on startup (linux-surface kernel, x86_64) — 2.1.239-2.1.241 work fine
- [BUG]
- [BUG] claude segfaults on startup (glibc 2.44, EndeavourOS/Arch) — Bun runtime crash in newlocale/free during pthread_once init
- Claude Code v2.1.241 native binary crashes with SIGILL on CPUs without SSE4.1