Packaging and install issues on macOS
Issues the maintainers labelled both platform:macos and area:packaging.
419 issues · 70 open · 349 resolved (83%) · first seen May 7, 2025
Is this getting better or worse?
This class of problem is converging. 66 new reports in the last 90 days vs 98 in the 90 before — -33%. The open backlog peaked at 70 in 2026-10 and sits at 70 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
248 of these reports name the Claude Code build they were running, spanning 124 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.284
- Claude Code v2.1.246
- Claude Code v2.1.112
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 31 days across 349 closures. Of the 349 closures with a recorded reason, 39% were closed as completed and 214 as not-planned or duplicate. The most recent completed fix landed in 2026-10.
Workarounds reported by the community
105 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 1–100
Ranked by community engagement (reactions weighted over comments). Listing the top 300 of 419 matches; the statistics above cover all 419.
- Anthropic API Overloaded Error with Repeated 529 Status Codes
- [BUG] Claude TUI says update available via brew. Brew update shows already up to date.
- [BUG] Claude Code 2.1.0 crashes on startup - Invalid Version semver parsing error
- [FEATURE] Cowork Support for Intel Mac
- [BUG] Error: Cannot find module './yoga.wasm'
- [Bug] macOS Activity Monitor shows version number (e.g. '2.0.53') instead of 'claude' as process name
- [BUG] JSON schema specified in the marketplace.json doesn't exist
- [BUG] The CLI reports that the Claude command is not found but still works
- Bug: claude command not found after npm install -g on macOS with Homebrew due to incorrect symlink
- [BUG] Native Claude Code not using system certs on MacOS
- [BUG] Claude code CLI binary installer silently deletes itself after installation
- macOS TCC popup still recurring on v2.1.153 — "2.1.153" would like to access data from other apps
- Permissions Error During Claude Code Global Package Update with NVM
- Homebrew: claude update advertises version not available in stable cask
- Automatic Update Mechanism Failure
- [BUG] Auto-update Fails for claude-code
- [BUG] : fresh native installation raise warning about npm
- Bug Report :: When Update keeps giving me please wait and try again later
- Bundled Bun binary lacks AVX baseline support — crashes on non-AVX CPUs
- False positive warning about PATH installation when using shell alias
- macOS Gatekeeper warning for extracted .node native addon
- [Bug] Auto-update fails with npm ENOTEMPTY rename error
- [BUG] Installer getting stuck at cleaning old NPM installations
- VS Code Extension Automatically Creates Local Installation Without User Consent
- [BUG] LSP plugins not working with native/standalone binary installation
- Intermittent Claude CLI Uninstallation on macOS M1
- [BUG] Can't install a plugin that's already installed on a different project
- [BUG] Fails to run with nodejs v25
- Claude for Chrome extension triggers repeated macOS Gatekeeper warnings for .node files
- [BUG] 2.1.113 crashes with SIGILL "illegal hardware instruction" on Ivy Bridge (AVX2-less) Intel Macs — regression from 2.1.112
- [BUG] Recurring auto-update failures with ENOTEMPTY error
- Bun segfault crash after extended session
- [BUG] All the extensions are displayed under the 'Explorer' in Antigravity.
- [BUG] claude outputs a bun warning
- [Bug] macOS brew upgrade requires bypassing security to launch Claude Code
- [Bug] npm Install Fails: ENOTEMPTY Error During Global Package Update
- [BUG] `Update available` banner suggests brew upgrade when `brew cask` is already at latest
- [BUG] Homebrew version rollback
- [BUG] illegal hardware instruction, please compile without the AVX2 requirement
- [BUG] brew upgrade claude-code downgrades from 2.1.87 to 2.1.81
- Xcode MCP tools requiring Automation permission hang indefinitely for CLI clients without bundle identifiers
- Auto-upgrade Breaks Cursor IDE Integration
- [BUG] "illegal hardware instruction" on CPU without AVX2 (Xeon E5 v2)
- [BUG] Claude Code 2.1.15 wont start: error: Invalid DNS result order.
- [BUG] MCP servers from marketplace no longer available
- [BUG] OTEL_METRICS_EXPORTER=otlp silently no-ops in 2.1.113 — OTLP exporter packages not bundled
- Auto-update fails repeatedly with ENOTEMPTY error on macOS with nvm
- [BUG] Claude Code SDK unable to find executable
- [Bug] Update process leaves stale lock file, blocking subsequent updates
- [BUG] With VS Code extension enabled, claude update in external terminal fails with 'Another process is currently updating Claude' error
- [BUG] macOS 12: Desktop app stuck on bundled Claude Code 2.1.260, Opus 5.5 greyed out — yet 2.1.280 lists this app's SDK wrapper (0.3.260) as tested while `stable` (2.1.267) does not
- [BUG] Native installation / binary return API errors
- [BUG] fnm global install will not trigger auto updates
- False positive 'Update available' banner when already on latest version
- [Bug] ZlibError decompression spam with litellm integration in native build
- [Bug] Claude drops keystrokes when editing prompts in external editor
- [BUG] Incorrect Installation Diagnostics for npm-global Installation
- [BUG] "illegal hardware instruction" on Intel Core i7-3615QM @ 2.30GHz
- [BUG]
- [BUG] macOS App Management accumulates one permission row per release; stable signing identity defeated by version-named binary paths (follow-up to #38722)
- [BUG] claude-code on brew is stuck on 2.1.81
- [Bug] Incorrect version number in release: 2.1.81 should be 2.1.88
- [BUG] Opus 5.5 requires unstable release of Claude Code
- macOS TCC dialogs recur on every update and request unrelated permissions (Apple Music)
- claude update downloads full binary even when already up-to-date (~27s vs ~0.5s)
- [BUG] macOS permission prompts identify Claude Code as a version number ("2.1.232") instead of "Claude Code" — root cause + fix
- [BUG] `claude update` downloads full binary even when already up to date
- [Bug] Auto-update fails with ENOTEMPTY on macOS 15+ due to stale temp directories and extended attributes
- [BUG] Error: Cannot find module './yoga.wasm'
- [BUG] macOS: Local Network permission is lost on every auto-update (versioned claude.app bundle path); 20+ stale permission rows accumulate
- [BUG] claude update always downloads latest binary
- macOS TCC permission prompts show "2.1.201" as the app name, and grants reset on every version update
- macOS TCC prompt shows version number ("2.1.143") instead of "Claude Code" and re-prompts on every update
- "Update available! Run: brew upgrade claude-code" shown even when already on latest version (Homebrew cask install)
- [BUG] macOS arm64: 2.1.37 hangs on startup; install.sh hangs at setup
- Allow suppressing native installer notification for npx/npm users
- [BUG] Will not run on Node version 24
- [BUG] BUN_BE_BUN=1 does not work
- [PROPOSAL] Golang Rewrite to Address Critical Memory Usage (1.5-2GB per session)
- [Bug] Claude Code is not working since Sept 30 | Anthropic API Error: Unexpected Usage Policy Violation Blocking Existing Session
- [BUG] misleading warning about ~/.local/bin
- [Bug] macOS TCC permissions lost on auto-update due to versioned binary paths
- [BUG] macOS: npm/Homebrew install places native binary at bin/claude.exe, causing recurring "claude.exe would like to access data from other apps" TCC prompts
- [BUG] Auto-updater silently broke Claude Code on macOS 11 Big Sur
- Claude Code v2.0.27 fails with SIGILL on Intel Mac without AVX2 support
- [BUG] claude-code.vsix is missing in @anthropic-ai/claude-code@1.0.110
- [BUG] MacOS kills Claude and says "Malicious Script Blocked"
- SIGILL on AVX2-less Intel Macs still present in 2.1.181 (regression from #50466 persists)
- Native Claude Code 2.1.143 crashes on startup with Bun segfault on macOS Silicon
- macOS TCC Automation grants not preserved across CC versions — Settings panel accumulates one row per release
- False 'Update available' message despite being on latest version
- [BUG] In-app update notifications default to latest channel even when installed via stable Homebrew cask
- [Bug] explanatory-output-style plugin: session-start.sh has CRLF line endings, fails on macOS/Linux
- [DOCS] MacOS 11.1 is not supported despite the documented requirement of macOS 10.15+
- Native auto-updater leaves 0-byte version files when blocked by running process
- [BUG] Agents not detected by Native binary installation (MacOS)
- Installation script provides incorrect PATH export command on fresh macOS
- Self-Update Mechanism Fails, Requiring Manual Global Reinstall
- [BUG] macOS: Claude Code shows up as three identities (Desktop "Claude", "claude", and per-version "2.1.x") with four separate copies on disk
- [BUG] Homebrew not Detecting new Claude Code Release