Packaging and install issues on Linux
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 1–100
Ranked by community engagement (reactions weighted over comments).
- [BUG] IDE Integration Not Working After `/migrate-installer` on Linux
- [BUG] npm install now ships Bun binary (v2.1.126) — npm workaround for non-AVX VPS is dead, no upgrade path
- v2.1.15 crashes on CPUs without AVX (regression from 2.1.14)
- [BUG] Read tool's PDF support requires poppler-utils but it's undocumented, usually absent, and not detected after install
- [BUG] v2.1.63 crashes on Alpine Linux (musl): posix_getdents symbol not found
- New 'native' installer: Bun/Zig hype train delivers 2010 anti-patterns: no version control, rollbacks, or professional package management
- [BUG] Claude command intermittently becomes unavailable ("command not found") with ENOTEMPTY errors preventing reinstallation on Ubuntu 24.04
- Claude Code 2.1.243 segfaults on launch (CachyOS/glibc 2.44) — 2.1.241 unaffected
- [BUG] Installation failed Failed to fetch version from stable: AxiosError: timeout of 30000ms exceeded
- [BUG] Failed to install Anthropic marketplace · Will retry on next startup
- [BUG] v2.1.242 segfaults on every launch (even `--version`) — interposed mimalloc `free` has no NULL check, glibc `newlocale` calls `free(NULL)` pre-main; v2.1.241 unaffected
- Claude Code 2.1.243 segfaults on startup — glibc 2.44 / Arch Linux (mimalloc/newlocale allocator conflict)
- [BUG] Fails to run with nodejs v25
- [Bug] Claude Code 2.1.243 crashes with SIGSEGV on startup (null pointer dereference)
- 2.1.243 native build segfaults instantly on startup: interposed free() crashes on free(NULL) from glibc 2.44 newlocale
- Bun segfault crash after extended session
- [BUG] Bun crashes with "CPU lacks AVX support. Please consider upgrading to a newer CPU."
- [BUG] Native installer fails with "another process is currently installing" on Linux even after complete cleanup
- [Bug] Native build 2.1.243 segfaults on glibc 2.44 due to malloc/free symbol interposition
- Segfault regression at 2.1.242 on glibc 2.44 (Arch) — distinct from closed #62747
- [BUG] Native binary installation ignores HTTP_PROXY for API streaming requests (Bun fetch issue ?)
- Claude Code CLI: Node.js v25 Incompatibility - TypeError "prototype" is undefined in cli.js
- [BUG] Native installer (2.1.243) segfaults in newlocale/free during startup on glibc 2.44 (CachyOS)
- claude update detects its own spawned process as 'another Claude process running'
- [BUG] cli.js is now in claude-code folder but sdk.mjs is looking for entrypoints
- [BUG] 2.1.237 tagged `latest` with its linux-x64, win32-x64 and linux-x64-musl native packages never published - installs land on a dead 500-byte stub
- [BUG] Invalid Version error on startup - changelog format breaks semver parsing
- Claude Desktop (Linux beta): support Fedora/RHEL and atomic/immutable distros (e.g. Bazzite, Silverblue, Kinoite)
- [BUG] Illegal instruction crash on CPUs without AVX after 2.1.112 (native binary regression)
- [BUG] Constant warning that "claude symlink points to invalid binary"
- [BUG] v2.1.113+ on linux-x64 behind HTTP CONNECT proxy: Bun runtime fetch race condition + 3 cascading regressions
- [BUG] Agents and commands broken on nixos
- [BUG] Standalone CLI binary missing seccomp binaries — /doctor reports "seccomp not available"
- [BUG] Bun binaries crash on ARM Neoverse-V2 (Python SDK + native installer)
- [BUG] `claude` code version >= `1.0.36` crashes with `bun` and `bunx`
- [BUG] Slow fresh install eating RAM
- [BUG] Install bash script fails with timeout
- [BUG] Problems updating 1.0.58 -> 1.0.59
- [Bug] Version 2.1.243 fails to launch on multiple machines, autoupdate causes regression
- [BUG] Pointless timeout prevents updates over slow internet connections
- [BUG] Bun 1.3.14 JSC GC segfault (SlotVisitor::drain) on AMD Ryzen 5 5500 / Linux x86_64_baseline — all platform binaries identical
- [Feature Request] Implement automatic cleanup of old Claude versions during updates
- [BUG] v2.1.243 native binary segfaults on startup — NULL deref in free() called from __newlocale
- [BUG] terminated by signal SIGSEGV (Address boundary error)
- Deterministic SIGSEGV on claude CLI startup (free/__newlocale/pthread_once)
- Startup PATH check warns even when ~/.local/bin is correctly configured in zsh
- [BUG] RISC-V unsupported?
- [BUG] Plugin installPath incorrectly includes marketplace.json filename
- [BUG] native install fails with EINVAL: invalid argument, copyfile '~/.cache/claude/staging/1.0.123/claude' -> ...
- [BUG] Illegal instruction error when reading images on AMD A6-3420M processor
- [BUG] Segment Fault
- [BUG] Unable to run new binary on systems like Nix and Guix
- Marketplace installation doesn't clone git submodules
- Diagnostics shows false PATH warning even when ~/.local/bin is properly configured
- [BUG] ripgrep fails on OpenBSD
- [BUG] False positive "Config mismatch" warning when installation method matches
- Local installation detection ignores CLAUDE_CONFIG_DIR environment variable
- Installation just hangs forever on nixos
- [FEATURE] Add `installMethod` support for system package manager installations (pacman/AUR, apt, etc.)
- [BUG] Bundled ripgrep fails on Raspberry Pi 5 due to jemalloc page size mismatch
- Bug: installed_plugins.json shows incorrect plugin version from marketplace
- [BUG] can't be reinstalled
- 2.1.242+ segfault is glibc-2.44-only: bisected 2.35→2.44, glibc 2.44's __newlocale refactor added an unconditional free(NULL); simulating a NULL guard boots 2.1.243 cleanly
- Add native binary support for linux/riscv64
- [BUG] Plugin install matches wrong marketplace when same plugin name exists in multiple marketplaces
- [BUG] Native installer reports success but fails to install binary on Raspberry Pi (ARM64)
- [Bug] explanatory-output-style plugin: session-start.sh has CRLF line endings, fails on macOS/Linux
- [BUG] The `doctor` command suggested `sudo chown -R $USER:$(id -gn) $(npm -g config get prefix)`, but this doesn't resolve anything.
- [BUG] [Linux] Bundled ripgrep binary missing execute permission — silently breaks all user commands/skills
- [BUG] Running claude version 2.1.52 on linux only runs bun
- Claude Code 2.1.15 crashes with illegal instruction on pre-AVX CPUs (Westmere Xeon)
- [BUG] API Error 404 / ECONNREFUSED
- [BUG] Native installer incorrectly detects glibc system as musl when musl cross-compilation packages are installed
- Native binary hangs silently at 100% CPU on VMs with the kvm64 CPU model (no SSE4/POPCNT) — needs a CPU feature pre-flight check
- [BUG] 2.1.243 segfaults on startup - glibc 2.44 / Bun runtime crash in newlocale()
- SIGSEGV crash on startup with kernel 7.1.x (CachyOS) — versions >= 2.1.140
- Native linux-x64 binary segfaults on Arch Linux (glibc 2.44) — free() called from libc newlocale() crashes with NULL table pointer
- [Bug] Multiple concurrent instances cause version downgrade (2.0.70 → 2.0.65)
- /doctor reports non-existent npm-local installation at ~/.claude/local
- Claude Code does not launch because of old version
- 2.1.243 native build segfaults at startup on Arch Linux (glibc 2.44) — even `--version` and `claude update`
- [BUG] Bun has crashed. Segmentation fault at address 0x35C23800000
- [BUG] npm install broken on non-AVX Linux x64 CPUs since v2.1.113 — Node.js (cli.js) fallback removed
- [BUG] Continue support for older CPUs via npm
- Support Claude Code on Linux distributions with coreutils < 8.30
- [BUG] 2.1.243 linux-x64 exports malloc/free and interposes glibc's allocator, segfaulting on startup in __newlocale; 2.1.205 does not export them and works
- [BUG] Immediate segmentation fault upon starting - claude (Bun runtime) segfaults at startup on Linux 6.17 / glibc 2.39 — all builds since Node→Bun switch
- False 'Update available' notification when installed via apt
- [BUG] Illegal instruction - CPU lacks AVX support (Linux)
- [BUG] Claude's code has been switched from npm to a native installer, but it no longer runs on NixOS.
- [FEATURE] Use relative path symlink in native installer
- [Bug] Invalid semver parsing in changelog version extraction
- Invalid Version error on startup: changelog cache contains non-semver version string
- [BUG] Installation error on linux
- [BUG] Auto-update fails for claude-code on Ubuntu 25.04
- Illegal Instruction crash on CPUs without AVX since v2.1.113
- [BUG] Claude >=147 crashes on RHEL8, <= 145 works fine
- [BUG] Claude Code v2.1.77 crashes with "Illegal instruction" on RHEL 8 (x86_64)
- [BUG] Claude Code 2.1.32 segfaults on RHEL 9.3 - crash in dynamic linker
- [BUG] Only one user can run Claude Code at a time on multi-user Linux server (native version)