Packaging and install issues on Linux — page 3
Issues the maintainers labelled both platform:linux and area:packaging.
242 issues · 49 open · 193 resolved (80%) · first seen May 25, 2025
Is this getting better or worse?
This class of problem is holding steady. 54 new reports in the last 90 days vs 44 in the 90 before — +23%. The open backlog peaked at 50 in 2025-12 and sits at 49 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
143 of these reports name the Claude Code build they were running, spanning 66 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.112
- Claude Code v2.1.150
- Claude Code v2.1.237
- 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 193 closures. Of the 193 closures with a recorded reason, 35% were closed as completed and 126 as not-planned or duplicate. The most recent completed fix landed in 2026-08.
Workarounds reported by the community
99 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 - 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] 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 - [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 - New 'native' installer: Bun/Zig hype train delivers 2010 anti-patterns: no version control, rollbacks, or professional package management
- …a, only accepts or , there's no or option 4. The documented workarounds ( , ) apparently don't work per issues 13213 and 14985 What I need (and I suspect many others do too): - Update on next session start , not while se…
Found in the thread of #20044 · 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–242
Ranked by community engagement (reactions weighted over comments).
- [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] 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)
- False "Update available!" notice repeats on idle, even when apt-managed install is already latest
- [BUG] Silent SIGSEGV (SI_KERNEL, addr=NULL) — CPU reports AVX2 but osxsave absent — regression 2.1.205→2.1.215
- [BUG] Linux: auto-updater prunes version binaries still executed by running sessions (/proc exe → deleted); no update notification → silent multi-version fragmentation
- [BUG] Anthropic.claude-code 2.1.193 linux-x64 platform files missing (404) on openvsx.org
- False "Update available" notification when installed via apt/deb package
- 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)
- 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.
- 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
- Claude Desktop (Linux beta): support Fedora/RHEL and atomic/immutable distros (e.g. Bazzite, Silverblue, Kinoite)
- 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