Packaging and install issues on macOS
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 1–100
Ranked by community engagement (reactions weighted over comments). Listing the top 300 of 381 matches; the statistics above cover all 381.
- 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
- Permissions Error During Claude Code Global Package Update with NVM
- Homebrew: claude update advertises version not available in stable cask
- Automatic Update Mechanism Failure
- macOS TCC popup still recurring on v2.1.153 — "2.1.153" would like to access data from other apps
- [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
- 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
- Bundled Bun binary lacks AVX baseline support — crashes on non-AVX CPUs
- [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] 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] claude-code on brew is stuck on 2.1.81
- [Bug] Incorrect version number in release: 2.1.81 should be 2.1.88
- 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] `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 App Management accumulates one permission row per release; stable signing identity defeated by version-named binary paths (follow-up to #38722)
- [BUG] claude update always downloads latest binary
- 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] 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: npm/Homebrew install places native binary at bin/claude.exe, causing recurring "claude.exe would like to access data from other apps" TCC prompts
- 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
- macOS TCC permission prompts show "2.1.201" as the app name, and grants reset on every version update
- [BUG] Homebrew not Detecting new Claude Code Release
- 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
- Auto-update removes user symlinks from ~/.claude/skills/
- [Bug] claude update - multiple installations detected at same path after npmrc prefix change
- Skills not loading: ENOENT error on managed skills directory aborts user skills loading
- [BUG] UND_ERR_SOCKET API connection error in official devcontainer on Docker Desktop for Mac (Apple Silicon)
- [BUG] $HOME/.claude/local/node_modules/.bin/claude: No such file or directory when trying to run claude code
- Unable to Update Claude Code on MacBook Terminal
- v2.1.113 broken on macOS 11 (Big Sur): dyld symbol not found _ubrk_clone
- "Update available" notification shown when already on latest version (Homebrew)