Packaging and install issues on macOS — page 3
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. 73 new reports in the last 90 days vs 109 in the 90 before — -33%. 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 201–300
Ranked by community engagement (reactions weighted over comments). Listing the top 300 of 381 matches; the statistics above cover all 381.
- [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
- Native updater has no resume — on a metered connection, repeated failed 300 MB downloads cost tens of GB
- CLI updater's symlink-swap breaks TCC Automation grants on every update (repeated 'would like to access data from other apps' prompts)
- [BUG] macOS: auto-update deletes the running app bundle mid-session, revoking granted Full Disk Access until restart
- [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)
- [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)
- [BUG] `bin/claude.exe` pre-postinstall stub has no shebang — surfaces as cryptic `spawn ENOEXEC` to SDK consumers
- [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] Auto-update reports success with non-functional stub binary after postinstall link failure
- [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] 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>`
- [BUG] macOS 27 Golden Gate beta: Claude Code re-requests Files & Folders access on every auto-update (new TCC entry per version)
- [DOCS] Outdated homebrew installation script
- [BUG]
- [Bug] Crash related to Bun runtime
- illegal hardware instruction" on Intel Core i5-3470S (Ivy Bridge, no AVX2) - crashes on startup
- Versioned install path causes TCC re-prompts on every Claude Code update (breaks MDM PPPC; CoWork scheduled actions may be affected)
- [BUG] Bad application title in Mac OS when requesting access to terminal
- Title: Claude Code 2.1.152 triggered unexpected macOS TCC permission prompt for ~/Documents
- [BUG] ignore-scripts=true + auto-update interaction crashes running Claude Code session; native binary repeatedly replaced with error stub on every self-update
- [BUG] macOS: TCC permission prompt (Apple Music / media library) re-appears on every update due to versioned binary path
- [BUG] VS Code extension left behind on a severe, already-fixed bug and it cost real money
- [BUG] Claude Code tab: exit code 127 + Malformed Mach-o on Intel Mac
- Notarize the macOS claude CLI binary — un-notarized binary causes syspolicyd / XProtect YARA scanning storm on Sequoia (15+)
- [Bug] macOS TCC permission dialog displays version string instead of "Claude Code" due to missing Info.plist in binary
- Auto-updates silently break ~/Documents access on macOS (TCC denial without dialog)
- Auto-update silently installs truncated native binary on darwin-arm64 when laptop sleeps mid-download (v2.1.138)
- [BUG] Claude Code (CLI/desktop) does not clean up old versions on update..
- macOS: PhotoKit access blocked — Claude Code missing photos-library entitlement and NSPhotoLibraryUsageDescription
- "Update available" notification persists on latest Homebrew version (v2.1.109) — regression from #43251 fix
- You've hit your limit · resets 11:40am (Asia/Tokyo)
- [BUG] macOS Activity Monitor / ucomm shows "claude.exe" instead of "claude" (pnpm install)
- [Bug] Update prompt appears with latest version already installed
- [BUG] Claude Code doesn't install on Sequoia Mac Pro 2013.
- [Bug] VS Code extension crashes with "illegal hardware instruction" on Intel Mac (no AVX2)
- Update notice shown for Homebrew install that is already at latest version
- claude update fails: multiple installations detected, cannot determine installation type
- [Bug] Update notification persists despite running latest Homebrew version
- [BUG] v2.1.88 rolled back?
- CLI shows 'update available' when already on latest Homebrew cask version