Packaging and install issues on macOS — page 3
Issues the maintainers labelled both platform:macos and area:packaging.
419 issues · 69 open · 350 resolved (84%) · first seen May 7, 2025
Is this getting better or worse?
This class of problem is converging. 63 new reports in the last 90 days vs 95 in the 90 before — -34%. The open backlog peaked at 69 in 2026-10 and sits at 69 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 350 closures. Of the 350 closures with a recorded reason, 39% were closed as completed and 215 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 201–300
Ranked by community engagement (reactions weighted over comments). Listing the top 300 of 419 matches; the statistics above cover all 419.
- [BUG] Bundled claude-code CLI binary is unsigned — fails Gatekeeper on managed Mac, breaks Chat/Cowork/Code with "crashed" error
- CLI updater's symlink-swap breaks TCC Automation grants on every update (repeated 'would like to access data from other apps' prompts)
- [BUG] Agent Teams: tmux teammate panes spawn dead (status 127) after brew upgrade — #48889 fix does not cover long-lived interactive sessions (repro on 2.1.206 → 2.1.207)
- [BUG] macOS: auto-update deletes the running app bundle mid-session, revoking granted Full Disk Access until restart
- [BUG] Failed auto-update download leaks multiple GB per process → concurrent native sessions OOM the host (macOS arm64, 2.1.165 fetching 2.1.168)
- 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
- [BUG] Running any claude command immediately crashes after install on Node 24
- [BUG] Installer crash (Bun has crashed)
- Path Resolution Failure in Native Installer for Claude Code
- [FEAT] Add ability to pass NODE_OPTIONS to packed binary
- [BUG] Cannot Disable Claude Auto-Updater
- [BUG] I don't have Claude 4
- [Bug] Voice input fails silently after auto-update due to broken process attribution (macOS)
- [BUG] macOS permission rows accumulate one per release: version-named binary path defeats stable signing identity (refiling stale-closed #76615)
- macOS: TCC permission prompts recur on every auto-update (interactive CLI never uses ClaudeCode.app)
- Auto-updater prunes the running version's binary, silently breaking all subagent/teammate spawns mid-session
- [Bug] Auto-update reports success with non-functional stub binary after postinstall link failure
- [BUG] Auto-update swapping versions under a live session causes assistant text to silently not render (2.1.204 process, 2.1.205 on disk); text intact in JSONL
- [BUG] NPM install on MacOS fetches claude.exe windoes version
- [BUG] Bundled Bun 1.4.0 slice-index-OOB panic on macOS 26.5.1 after sleep/wake during long session (sibling of #68404)
- macOS: version-numbered binary name (e.g. `2.1.196`) is confusing in permission prompts — suggest `claude-code-<version>`
- [FEATURE] Write a feature, expecting Claude to support v24.15.0
- [BUG] darwin-x64 binary requires AVX2 since 2.1.113 — please ship bun-darwin-x64-baseline (like Linux/Windows already do)
- [DOCS] Outdated homebrew installation script
- illegal hardware instruction" on Intel Core i5-3470S (Ivy Bridge, no AVX2) - crashes on startup
- [BUG] ignore-scripts=true + auto-update interaction crashes running Claude Code session; native binary repeatedly replaced with error stub on every self-update
- [BUG] `bin/claude.exe` pre-postinstall stub has no shebang — surfaces as cryptic `spawn ENOEXEC` to SDK consumers
- [BUG] Claude Code tab: exit code 127 + Malformed Mach-o on Intel Mac
- [BUG] Claude Code version 2.1.139 indicate malware
- [BUG] CLI/extension version mismatch causes silent crash surfaced as "Interrupted · What should Claude do instead?"
- macOS TCC permission dialog shows version string "2.1.119" instead of "Claude Code"
- Auto-updater has a design flaw that causes silent...
- [BUG] Illegal instruction (SIGILL/AVX) on Intel Core i7 MacBookPro9,1 - crashes on startup
- [BUG] Mac Intel i5-3210M, erro "illegal hardware instruction", versões 1.0.88+
- Update notification ignores autoUpdatesChannel setting
- [BUG] Update notification still checks latest channel on stable Homebrew cask (regression from #41140)
- False positive 'Update available' in statusline on Homebrew install (v2.1.92)
- [Bug] Brew upgrade notification shown despite already on latest version
- [BUG] Old version binaries not cleaned up on update, pollute macOS TCC/Full Disk Access list
- macOS TCC dialogs show version number instead of app name, re-prompt on every update
- computer-use: input module missing for darwin-arm64 (click/type/scroll broken)
- Claude Code crashes with SIGKILL on macOS Mojave when processing images (sharp/libvips _aligned_alloc)
- [BUG] Intel(R) Xeon(R) CPU E5-1620 v2 @ 3.70GHz -> Error: Claude Code process terminated by signal SIGILL
- [BUG] Cleaning up after switch to native Mac install could lead user to lose data
- [BUG] Plugin npm install hangs indefinitely with no timeout or error when install path is invalid, causing silent memory exhaustion
- [FEATURE]
- Upgrade notification shown to Homebrew users who are already on latest cask version
- [BUG] notarization dropped 2.1.31 (cask download)
- Homebrew cask install: installMethod detected as native, checks wrong binary path
- [BUG] VSCODE extension v2.1.25 crashes devcontainer sandbox with "PendingMigrationError: navigator is now a global in nodejs"
- [BUG] Running `claude` does nothing. Nothing happened.
- [BUG] homebrew 2.1.14 blocked by macOS Gatekeeper (not notorized?)
- [BUG] 'claude doctor' recommends adding non-existent directory to $PATH
- [Feature Request] Support system package managers (Nix, Homebrew, etc.) - add CLAUDE_INSTALL_METHOD env var
- [BUG] Plugin Marketplace - Structured Plugin Skills result in inflation of skills into system prompt
- [BUG] Warning: Failed to load marketplace 'claude-plugins-official'
- [BUG] Claude Code CLI is deleting itsefl
- [BUG] Hookify import error: No module named 'hookify' on initial download of the plugin
- [BUG] Apple could not verify “claude” is free of malware that may harm your Mac or compromise your privacy.
- [BUG] Latest Claude Code version not available in claude-agent-sdk
- @anthropic-ai/claude-agent-sdk contains unsigned macOS binaries causing Apple notarization failures
- Auto-update fails with ENOTEMPTY when multiple CLI instances are running
- [Bug] Homebrew version check compares against latest release instead of formula version
- [Bug] `claude install` does not remove previous binary installations
- Auto-update leaves temp directories and requires manual intervention
- [BUG] Marketplace plugins missing strict: false flag
- [BUG] 5-hour limit reached
- [BUG] Auto update fish function alias error
- [DOCS] npm install is missing ~/.local bug
- [BUG] macOS repeatedly prompts for Desktop/Documents/Downloads folder access
- [Bug] Auto-update fails after configuration changes
- [Bug] Missing Required Directories During Installation - should not be the case after a reinstallation
- Workflow Failure: npm ci Requires package-lock.json
- [BUG] Cannot authenticate from CLI
- [BUG] Claude doesn't launch even with new update.
- [BUG] Can't run, uninstall or run claude
- [BUG] Can't install Claude Code CLI
- Unhandled Exception in Diff Processing Triggered in cli.js
- Local Installation Migration Inconsistency After Attempted Revert
- "Update Fails to Install: Persistent 'Restart to Apply' State"
- [Bug] Repeated privacy permission prompts for browser access on macOS with each version update
- macOS: desktop-launched Claude Code is silently denied Local Network access and never gets the permission prompt (CLI bundle is LSBackgroundOnly)
- Auto-update breaks grep/find in the Bash tool for already-running sessions (silent fallback to a stale CLI)
- Process name in Activity Monitor/ps is the version string (2.1.233), not claude