Packaging and install issues on macOS — page 2
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 101–200
Ranked by community engagement (reactions weighted over comments). Listing the top 300 of 419 matches; the statistics above cover all 419.
- Auto-update removes user symlinks from ~/.claude/skills/
- SIGILL crash on Intel Westmere (Xeon X5675) — native binary requires AVX2
- [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
- [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)
- 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)
- [BUG] Code mode broken after v2.1.78 update — .app bundle binary not spawnable by desktop SDK
- SIGILL crash on Intel Westmere (Xeon X5675) — native binary requires AVX2SIGILL crash on Intel Westmere (Xeon X5675) — native binary requires AVX2
- [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
- macOS: auto-update triggers repeated, unlabeled "<version> would like to access data from other apps" TCC prompt
- [BUG] macOS: opening the agents view (left arrow) fires a "Data Access Blocked" notification every time, attributed to "2.1.250" instead of Claude Code
- [BUG] Claude Code app bundle lacks NSBluetoothAlwaysUsageDescription — child processes get hard-killed instead of prompted with Routines
- [BUG] macOS 27 Golden Gate beta: Claude Code re-requests Files & Folders access on every auto-update (new TCC entry per version)
- [BUG] Desktop app 1.8089.1 crashes on launch: bundled Claude Code 2.1.142 binary is unsigned / malformed Mach-O (macOS arm64)
- Misleading 'Update available' message for Homebrew users
- [Bug] Update notification appears when no update is available
- [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 show version number instead of "Claude Code" app name
- 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] The Claude Code CLI updated more than 15 times within two hours and kept downloading updates nonstop.
- [Bug] macOS permission requests triggered on every minor update due to unstable binary signature
- macOS: Full Disk Access / TCC prompts reappear on every auto-update (per-version binary path)
- Segfault (panic at 0x0) after long session on macOS 26.5.1
- 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] Claude Desktop (macOS) still bundles darwin-x64-only node-pty, triggers Rosetta/Intel-app deprecation warning
- [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: 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?
- Claude Code helper bundle ships without an app icon — blank grey row in System Settings → Privacy & Security
- Native updater has no resume — on a metered connection, repeated failed 300 MB downloads cost tens of GB
- TCC network-volume permission re-prompts on every update (binary path includes version number)
- macOS TCC permission prompts show the app name as a bare version number (e.g. "2.1.170")
- 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
- Native build: ECONNRESET on OAuth refresh/login and API calls on macOS 27 — curl and npm build work fine
- macOS: voice dictation dies in every running session after the auto-updater replaces claude.exe ("No audio detected from microphone"; TCC denies the old PID)
- [BUG] Regression: Claude Code crashes with SIGILL on non-AVX CPU (macOS 12.7.6, 2.1.251) — see also #19907, #19904, #19967, #20611
- [BUG] File names used by Claude wreak havoc with XFence security
- macOS: versioned install paths invalidate TCC folder permissions on every auto-update (and mid-session for running sessions)
- [BUG] Bundled claude-code CLI binary is unsigned — fails Gatekeeper on managed Mac, breaks Chat/Cowork/Code with "crashed" error