Packaging and install issues on macOS — page 2
Issues the maintainers labelled both platform:macos and area:packaging.
381 issues · 59 open · 322 resolved (85%) · first seen May 7, 2025
Is this getting better or worse?
This class of problem is converging. 74 new reports in the last 90 days vs 109 in the 90 before — -32%. The open backlog peaked at 64 in 2025-12 and sits at 59 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
213 of these reports name the Claude Code build they were running, spanning 106 releases. Heaviest reporters:
- Claude Code v2.0.76
- Claude Code v2.1.87
- Claude Code v2.1.92
- Claude Code v2.1.17
- Claude Code v2.1.15
- Claude Code v2.1.112
- Claude Code v2.1.113
- Claude Code v2.1.143
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 30 days across 322 closures. Of the 322 closures with a recorded reason, 41% were closed as completed and 189 as not-planned or duplicate. The most recent completed fix landed in 2026-08.
Workarounds reported by the community
90 of these issues post a workaround someone says worked. The highest-engagement ones:
- Anthropic API Overloaded Error with Repeated 529 Status Codes
- try switching to Haiku with as a workaround.
Found in the thread of #3572 · resolved - [BUG] Claude TUI says update available via brew. Brew update shows already up to date.
- …plays at startup: \ \ \ Running \ confirms: \ \ \ Attempted Workarounds: - \ - No effect - \ - No effect - Verified versions match exactly (both show 2.0.37), but notification persists on every startup Analysis: This sug…
Found in the thread of #11405 · resolved - [BUG] Claude Code 2.1.0 crashes on startup - Invalid Version semver parsing error
- …al/node modules/@anthropic-ai/claude-code/cli.js:743:49661) Workaround: bashrm -rf ~/.claude/cache ~/.claude/statsig Then downgrade to 2.0.76: bashpnpm add -g @anthropic-ai/claude-code@2.0.76 Root Cause: The version stri…
Found in the thread of #16682 · resolved - [Bug] macOS Activity Monitor shows version number (e.g. '2.0.53') instead of 'claude' as process name
- tmux users may be interested in the [workaround][1] shared by @brian-deane-gusto. [1]:
Found in the thread of #12433 · still open - Bug: claude command not found after npm install -g on macOS with Homebrew due to incorrect symlink
- …JavaScript file instead of the executable launcher script. Workaround The issue can be resolved by manually replacing the incorrect symbolic link with the correct one. 1. Remove the incorrect link: 1 rm /opt/homebrew/bi…
Found in the description of #3172 · still open
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). Listing the top 300 of 381 matches; the statistics above cover all 381.
- SIGILL crash on Intel Westmere (Xeon X5675) — native binary requires AVX2
- [BUG] Code mode broken after v2.1.78 update — .app bundle binary not spawnable by desktop SDK
- [BUG] I ran claude update command and it downgraded from 2.1.62 to 2.1.58. I'm a Max 20x subscriber, now without the latest features and no way to upgrade because nothing works !
- Symlink Required for VS Code Extension After Local Installation Migration
- [BUG] `claude install` installs v1.0.15 and not 1.0.31
- [Bug] macOS TCC permission ghost entries accumulate on every update — affects Desktop App AND Claude Code, root issue never fixed
- Re-attaching to existing session ENOENTs after Homebrew Cask upgrade (stale versioned worker path)
- Misleading 'Update available' message for Homebrew users
- [Bug] Update notification appears when no update is available
- SIGILL crash on Intel Westmere (Xeon X5675) — native binary requires AVX2SIGILL crash on Intel Westmere (Xeon X5675) — native binary requires AVX2
- [BUG] Native installation causes system freeze with Python joblib/multiprocessing on Apple Silicon
- [BUG] Regarding Claude Code for VS Code, while the VS Code extension marketplace is correctly updated to the latest version, in Cursor, it seems stuck at version 2.0.1.
- PATH Configuration Not Detecting Local Claude Installation
- [BUG] Set Claude Code working, returned to find no terminal window (closed itself), and claude is no longer installed
- [BUG] Interrupt (CTRL+C) claude process can break the install during auto-update
- [BUG] macOS permission prompts identify Claude Code as a version number ("2.1.232") instead of "Claude Code" — root cause + fix
- [BUG] Desktop app 1.8089.1 crashes on launch: bundled Claude Code 2.1.142 binary is unsigned / malformed Mach-O (macOS arm64)
- macOS: "'2.x.xxx' would like to access data from other apps" prompt on every launch
- [Bug] Update notification persists after successful brew upgrade on stable channel
- Computer use in CLI fails: @ant/computer-use-swift native module missing from npm package
- [FEATURE] Detect that an installation cannot be updated automatically, or allow indicating claude is managed by a package manager
- [Bug] Anthropic API Error: Unexpected 500 Server Response
- [BUG] Claude code CLI no longer works, crashes on startup
- [Bug] macOS permission prompts show version number instead of "Claude Code" app name
- macOS: Full Disk Access / TCC prompts reappear on every auto-update (per-version binary path)
- SIGILL on AVX2-less Intel Macs still present in 2.1.181 (regression from #50466 persists)
- Claude Code CLI unusable on pre-Haswell Intel Macs (no AVX2) — need Node.js fallback or non-AVX binary
- [BUG] Claude Agent in Xcode downloads ARM64 binary on Intel Macs, x64 binary rejected due to code signing
- [BUG] @ file picker returns no results in native binary — works in npm package of same version (2.1.81)
- [BUG] Startup crashes on "illegal hardware instruction"
- claude install doesn't persist ~/.local/bin to PATH in shell config
- [BUG] v2.0.76 on Apple Silicon: AVX warning + spawns 40+ zombie node processes causing OOM
- Installation fails with 'another process is currently installing' even when no other process exists
- [BUG] ripgrep filling up disk space with every update
- Unhandled CLI Crash on Startup
- [Bug] macOS permission requests triggered on every minor update due to unstable binary signature
- Segfault (panic at 0x0) after long session on macOS 26.5.1
- macOS: Hardened Runtime blocks Apple Events from child processes (missing com.apple.security.automation.apple-events)
- [BUG] Claude Code binary rejected by macOS 26 Gatekeeper — SIGKILL on 2nd concurrent instance
- claude update shows false PATH warning on macOS when $HOME/.local/bin is in PATH
- Claude Code shows as version number in macOS Privacy & Security settings
- Plugin installation creates symlinks in skills/ causing duplicate slash commands
- [Bug] Bun runtime crash with illegal instruction on macOS 14.6.1
- [BUG] install.sh suggests bash-style PATH export for fish shell
- [Bug] Claude in Chrome: CRX_FILE_NOT_READABLE - Cannot install from Chrome Web Store since Dec 18 update
- [Bug] Claude Code process hangs or processes extremely slowly
- [BUG] Getting 403 trying to update VS Code Extension to 2.073
- [BUG] Upgrade command communicated fails
- [BUG] Specific project directory stuck on deprecated model claude-3-sonnet-20240229 after reinstalling via Homebrew
- [BUG] npm install may conflict with native install
- Bug Report: Potential Unintended Behavior Causing Project Loss
- [BUG] NPM auto-update deletes user-created symlinks in ~/.local/bin
- Does something changed in the vendored ripgrep build?
- [BUG] WORK AROUND for Claude Agent OAuth sign-in fails in Xcode 26.5
- [Bug] Multiple Claude Code versions running simultaneously with version locks
- [BUG] Releases not gated behind changelog update. Doctor reports stale "Latest version".
- macOS: background agent binary lacks bundle ID, causing TCC permission churn on upgrades
- macOS: auto-update creates new TCC identity each version, breaking Desktop/FDA grants daily
- MCP servers crash on macOS when accessing Bluetooth — missing NSBluetoothAlwaysUsageDescription in claude-code bundle
- macOS Big Sur (11.x): Last compatible version is 2.1.112
- [BUG] ~/.claude/skills/ directory deleted on first run after 2.1.113→2.1.114 update (native binary migration)[BUG]
- Agent Teams: teammate spawn fails after brew upgrade due to hardcoded Caskroom version path
- [BUG] Hardcoded "brew upgrade claude-code" notification is wrong for claude-code@latest cask
- /voice crashes with 'CPU lacks AVX support' on Apple M1 (v2.1.83)
- [DOCS] Claude cli on mac prompts to update via brew but is checking current version via npm
- tree-sitter-bash stubbed out in Bun single-file binary — all Bash permission checks use legacy fallback
- [Bug] PATH validation fails when $HOME contains special characters (@)
- [BUG] Native installation registers HTTP proxy, but doesn't use it
- [BUG] macOS native installer serves outdated 2.1.2 when 2.1.3/2.1.4 available
- [BUG] Plugin Redundancies/Conflicts
- [BUG] Ignores disabling auto updates
- [Bug] Homebrew installation creates incorrect symlinks
- [Bug] Downgrade from 2.0.2 to 2.0.1 during update
- [Feature Request] Improve User Feedback for Successful Interactions
- [BUG] TypeScript SDK fails when using pathToClaudeCodeExecutable with native binary installation
- Bug: Auto-update failed to upgrade from v1.0.58 to v1.0.59
- Portable .bashrc Configuration: Use $HOME Instead of Hardcoded Path
- [BUG] `claude update` doesn't work
- TCC network-volume permission re-prompts on every update (binary path includes version number)
- [BUG] The Claude Code CLI updated more than 15 times within two hours and kept downloading updates nonstop.
- [BUG] Bundled claude-code CLI binary is unsigned — fails Gatekeeper on managed Mac, breaks Chat/Cowork/Code with "crashed" error
- [BUG] Claude Code app bundle lacks NSBluetoothAlwaysUsageDescription — child processes get hard-killed instead of prompted with Routines
- macOS TCC permission prompts show the app name as a bare version number (e.g. "2.1.170")
- Stale background daemons from prior version cause ENOENT posix_spawn when launching agents after upgrade
- [BUG] FleetView dispatched agents doesn't properly use the correct version when dispatching an agent with an up to date version while an existing previous version is running on the background
- postinstall strips Mach-O code signature on darwin-arm64 → macOS SIGKILLs claude on launch
- [BUG] Claude Code 2.1.114 broken on macOS 11 (Big Sur) — native binary requires macOS 13.0+
- [BUG] Auto-updater ignores autoUpdatesChannel: "latest", actively downgrades to stable
- [BUG] - I can't use claude code anyway on my VSCode extension or CLI
- [BUG] High memory consumption when CC is auto-downloading a new version of itself
- [BUG] False AVX Warning & Architecture Mismatch on Apple Silicon (M1)
- install.sh appears stuck during download and fails silently when installMethod=native exists
- [BUG] 2.1.16 not on Homebrew
- [BUG] Auto-update leaves installation in broken state with incomplete package files
- [BUG] Plugin marketplace schema validation error when launching CLI from Claude Desktop Code tab (regression from #14477)
- [BUG] vendor/ripgrep/arm64-darwin/rg linked against absent /opt/homebrew/opt/pcre2/lib/libpcre2-8.0.dylib
- Bug: Hookify plugin Python import error in cache directory structure
- [BUG] claude code fails to upgrade automatically when installed with pnpm
- [Bug] Node.js version mismatch in package.json causing engine conflict would not FOLLOW commands 50 times to fix
- [BUG] /doctor recommends adding ~/.local/bin to PATH even though actual binary is managed by Homebrew