Packaging and install issues on Linux — page 2
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 101–200
Ranked by community engagement (reactions weighted over comments).
- Version parsing crash: Invalid Version with date suffix (2.1.0 (2026-01-07))
- [Feature Request] Disable auto-completion and provide version pinning to prevent unintended input loss
- [BUG] Can not install and run claude in WSL
- Illegal Instruction crash on CPUs without AVX since v2.1.113
- [BUG] v2.1.123 crashes on startup with "Module not found ''" (Linux x86-64 baseline)
- [BUG] Native binary crashes with 'trap invalid opcode' on AVX-512 capable CPU inside KVM VM (v2.1.116–2.1.119)
- [BUG] Regression: ccd-cli v2.1.78 crashes with `invalid opcode` on non-AVX CPUs (same as fixed #19907)
- [BUG] CPU without AVX → Bun crashes → SIGILL
- [BUG] Install fails on Ubuntu 22.04
- [BUG] AutoUpdater calls pacman on Ubuntu, launching Pacman game instead
- [BUG] Claude Code 2.1.17 causes system freeze on low RAM machines (<2GB)
- Bun 1.3.6 in Claude Code 2.1.15 crashes with SIGILL on CPUs without AVX support
- [BUG] Claude Code 2.1.x crashes with "Illegal instruction" on non-AVX CPUs (regression from 2.0.76)
- [BUG] Claude Code crashes with "double free or corruption" on Android/ARM64 (aarch64)
- [BUG] `claude install` segfaults on AMD64 Debian Bookworm, installation fails silently
- [BUG] Native Claude binary (built with Bun/Zig) completely breaks patchelf and dynamic loader behavior。FUCK
- [BUG] claude code does not start on big endian systems (linux on z, z/OS, AIX)
- Mismatched Version Reporting Between npm and CLI Doctor Command
- [BUG] Authentication Key Lost on Claude Code Updates
- [BUG] Auto-update failure message appears persistently with no way to suppress it
- [BUG] Claude Code Non Interactive weird version error
- `claude update` fails with generic error when stale temp directory exists from previous failed update
- [BUG] Claude Code / Bun AVX-512 Crash
- [BUG] Installation fails with `ERR_CHILD_PROCESS_STDIO_MAXBUFFER` during ripgrep step on Linux
- [BUG] Self-Update Uninstalls Claude Code / Ignores Disabled Updates
- Bug Report
- [BUG] claude: command not found
- [BUG] native install missing bash background tasks
- [BUG] Maximum call stack size exceeded on first install
- [BUG] Native binary installation hangs in linux (server without npm installed)
- Portable .bashrc Configuration: Use $HOME Instead of Hardcoded Path
- autoUpdates: false is not honoured on native installs — version pin silently reverted
- [BUG] UI shows "update available" for latest-channel versions when installed from stable apt repo
- [BUG] SIGILL issues with version 2.1.153
- v2.1.116 crashes on Linux x64 with Bun CommonJS module error (regression of #45541)
- [BUG] claude CLI tries to access nonexistent /home directories on boot
- [BUG] Illegal Instruction in 2.1.77
- [BUG] Claude Code crashes with 26006 Illegal instruction
- [BUG] `claude install` breaks on OpenBSD
- [BUG]
- [BUG] Cant update claude code when running within devcontainer
- [BUG] `claude install` removes claude binary
- Claude Code 2.1.15 crashes with SIGILL on QEMU VM without AVX support
- [BUG] `claude` exits silently (code 0) when ripgrep/fzf not installed in a docker container
- [BUG] claude update shows network error when already on latest version
- spawn ENOENT when using pathToClaudeCodeExecutable in Docker container
- [BUG] 2.0.55 on Ubuntu can't start due to TypeError
- [BUG] Sandbox Error: Failed to create bridge sockets when TMPDIR is non-existent or non-writable
- [Feature Request] Add Termux support for native client or build from sources option
- [BUG] Ran out of disk space in a session. Claude code now broken.
- Cannot install Cloude Code on different linux machines
- Proposed GitHub Issue Title: `/cost Command Reporting Unclear for Claude Max Subscribers` This title: - Directly identifies the specific feature/command - Highlights the core issue of reporting ambiguity - Uses technical terminology - Is concise and descr
- 2.1.243 SIGSEGV on startup (glibc 2.44, Arch) — self-heal to 2.1.241 worked, adding correlated repro
- claude --version segfaults (SIGSEGV) immediately on 2.1.243 — 2.1.241 works fine on same system
- Startup SIGILL in 2.1.241 (Bun v1.4.0 fdb5e06cc) — 71% of launches; 2.1.243 (Bun 19bc277a0) is clean in 17/17
- [BUG] Claude Code ≥ 2.1.205 livelocks at 100% CPU with no output (even on --version) on KVM guests with generic CPU model (kvm64) — silently breaks Code tab in Linux desktop beta
- 2.1.206 linux-x64 ships a Bun baseline build that segfaults on startup (glibc 2.41)
- [BUG] auto-updater installed it without validation and broke `claude` ; (2.1.176 SIGILLs on launch on RHEL 7 / glibc 2.17)
- [BUG] Illegal instruction (core dumped) on install.sh
- Claude Code 2.1.113+ crashes on startup (SIGILL in bundled Bun 1.3.14) on Intel Emerald Rapids / Ubuntu 24.04
- Linux x64 binary in v2.1.159 installs as invalid executable (exec format error)
- [BUG] Bus error (SIGBUS) on AlmaLinux 9 / RHEL 9 with kernel 5.14 — ARCH_SET_XCOMP_PERM syscall not supported
- [BUG] bash: Zeile 151: 1224993 Ungültiger Maschinenbefehl "$binary_path" install ${TARGET:+"$TARGET"}
- Claude Code Segmentation fault
- [Bug] Release notes missing for version 2.1.104
- Auto-update failed after restart — npm prefix mismatch (user-local install vs. system prefix)
- [BUG]
- [BUG] claude code in terminal returning a Bun exception
- [BUG] Github action with Claude fails on SDK error code 14 since Feb 6
- [BUG] CRITICAL: Claude Code Native Binary Contains Memory Safety Bugs (Uninitialized Memory)
- [BUG] 🪲@ file autocomplete broken in Cursor terminal after npm → native migration
- [BUG] Claude Code runs the game Pacman in /usr/games/pacman on PopOS
- [BUG]
- [BUG] Claude Code crashes on CPUs without AVX support since recent update
- [Feature Request] Support system package managers (Nix, Homebrew, etc.) - add CLAUDE_INSTALL_METHOD env var
- [FEATURE] Installer should be able to install in a global folder like /usr/local/
- Custom slash commands not discovered on Android/Termux due to missing arm64-android ripgrep binary
- [BUG] Regression 2.0.54: Unexpected identifier 'B'
- [FEATURE] Please support armv8l archetectures
- CLI binary not accessible in terminal - missing bin field in package.json
- [Bug] File fuzzy matcher incomplete suggestions for nested directories with @ prefix
- [BUG] Claude code does not support non github repositories for plugin marketplaces
- [BUG] Multiple installation conflicts still occurring (v2.0.26) - npm-local + native binary
- [BUG] bad command suggestion
- Anthropic API Authentication Failure in Claude Code CLI
- [BUG]
- [BUG] Claude Edits Shell RC file on startup
- Add Progress Bar for Native Installation Download
- SyntaxError: Unexpected end of input on VMware Linux VM despite successful installation
- v2.1.243 segfaults before main() — bundled allocator interposes glibc free(), crashes in __newlocale (native install, Linux x86-64)
- Background auto-updater lacks a post-install effectiveness check — five identical same-version reinstalls in 109 min when the running copy isn't the prefix install
- Out-of-bounds read past end of 1 GiB mapping on CPUs without AVX/SSE4 (SIGSEGV, not SIGILL)
- [BUG] Auto-update silently ships a non-functional install on stock npm 12
- [Bug] Auto-update error despite passing doctor checks
- 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.