Installation & update problems
npm install, auto-update, and version-mismatch failures during setup or upgrade.
4121 related issues · 583 open · 3538 resolved · peaked at 583 open (2026-08)
Backlog trend over time
The line shows how many issues in this topic were open at the end of each month, derived by
counting each issue from its creation date until it was closed. First-party data from the
anthropics/claude-code tracker.
All installation & update problems issues
Ranked by community engagement (reactions and comments).
- [Bug] VS Code extension: Tool use concurrency error after Jan 23-24 update
- [FEATURE] Secure secrets injection for Claude Code on the web
- [FEATURE] Link a source control repo as the source for organization skills
- [BUG] Claude Code 2.1.0 crashes on startup - Invalid Version semver parsing error
- Max 20 plan: rate limit 100% exhausted within ~70 minutes after reset (never happened before v2.1.89)
- [BUG] [Reopening because bot closed without discussion] Native installer doesn't work on FreeBSD
- [BUG] [SOLVE!] Missing API key when SSH'ing into macOS
- v2.1.113+ broken on Termux/Android: native binary requires glibc, no JS fallback
- [FEATURE] .NET 9 or 10 SDK support in Claude Code for web runtime environment
- [BUG] Frequent IDE disconnections disrupting workflow in VS Code integration
- Bug: Project-scoped plugins incorrectly detected as installed globally
- [FEATURE] Ability to enable or configure automatic updating of a marketplace and plugin
- [BUG] /buddy returns "Unknown skill: buddy"
- Claude Code: constantly seeing 'API Error (Request timed out...)' - Retrying in .. seconds.. (attempt x/10)'
- Shell Function Inheritance Issue - Zoxide and Dynamic Functions Fail in Bash Tool
- /continue and /resume show all sessions across projects instead of current project only (regression in 2.1.101)
- SSH remote connection fails on Windows — hardcoded /usr/bin/ssh path
- [BUG] Cannot find package 'better-sqlite3'
- [BUG] Prompt cache regression in --print --resume since v2.1.69(?): cache_read never grows, ~20x cost increase
- [BUG] Plugin install fails with EXDEV when /tmp is tmpfs
- [BUG] VSCode ext - "Fork conversation from here" doesn't do anything
- [BUG] Claude Desktop cannot install on Windows - redirects to Microsoft Store during installation
- [BUG] IDE Integration Not Working After `/migrate-installer` on Linux
- [Bug] EnterWorktree creates worktree from default branch instead of HEAD
- [BUG] Native Windows(Powershell) install of Claude Code is not viable
- Claude Desktop 1.1.4173 crashes on startup — no window renders, process visible in Task Manager
- Regression in 2.1.217: "Last Activity" (activity-days) filter missing when grouping sessions by Project
- [BUG] permissions from user settings.json is NOT applied at project level
- [Windows] Desktop app 1.24012.1: fatal GPU-process crash (0x060C201E) via in-app Browser tab; crash leaves MSIX package unlaunchable (appxState=2) until Repair
- Remote Control session not visible in session list, cannot reconnect after leaving
- [Bug] Anthropic API Error: Internal Server Error (500)
- [BUG] [1M] Sonnet 1M context window disappeared after Claude Code update to v2.1.45 — regression on Max plan ($200/mo)
- Marketplace plugin cloning should default to HTTPS instead of SSH
- 2.1.120 regression: claude --resume / --continue crash with "g9H is not a function"
- [BUG] The CLI reports that the Claude command is not found but still works
- Authentication Failure After Login in v1.0.68 at ssh remote
- [BUG] Claude cowork MCP Issue continues
- macOS: PTY file descriptors leaked across a long Bash-heavy session, exhausting kern.tty.ptmx_max (forkpty / posix_openpt fail with ENXIO system-wide)
- Support IDE-level notifications for claude-code plugins (IntelliJ + VS Code)
- Bug: claude command not found after npm install -g on macOS with Homebrew due to incorrect symlink
- [BUG] Claude 2.1.0 not working at all!
- [BUG] `"awsAuthRefresh":` setting causes constant repeated auth attempts
- [BUG] Claude Code integration with VS Code not working on Windows
- Version 2.0.73: Text rendering bug - lines dropped and garbled output
- Sub-Agents Not Detected: Missing Agents in CLI List Despite Directory Creation
- [FEATURE] Add PostWorktreeCreate hook (or setup command) for environment initialization in worktrees
- Long Context Beta Not Available for Current Subscription
- [Bug] Anthropic API Error: Image does not match provided media type
- [BUG] "Don't Ask Again" Overwrites Entire Permissions Array
- [BUG] CC native on Windows: not really shell aware
- Plugin Installation Failure: Missing PyCharm Plugin Directories
- Error: InputValidationError: Write failed due to the following issue: The required parameter `content` is missing
- [BUG] Reopening of Claude Desktop Installation Fails on Windows 11 - Signature Verification & Unable to Load #25385
- [BUG] ✗ Auto-update failed · Try claude doctor or npm i -g @anthropic-ai/claude-code
- Plugin cache never refreshes - autoUpdate doesn't update what Claude reads
- [BUG] Native Claude Code not using system certs on MacOS
- [BUG] claude crashed in terminal, and i'm getting the error `zsh: command not found: claude` when i try to reopen by running `claude`
- [Feature Request] Add native Nix/NixOS support or maintain npm installation method
- [BUG] Tab completion broken for ! prefix bash commands
- BUG: MCP servers fail to connect in Claude Code despite correct configuration
- Permissions Error During Claude Code Global Package Update with NVM
- [BUG] Cowork crashes since v1.3036.0 is installed
- [BUG] v2.1.73 causes terminal freeze with yellow search bar in tmux sessions - memory leak related
- [BUG] Auto mode temporarily unavailable on macOS - persists across restarts (v2.1.80)
- Agent teams should spawn in new tmux window, not split current pane
- Shift+Enter not inserting newline in native version (iTerm2/macOS)
- [BUG] Invalid Version
- [BUG] macOS OAuth authentication succeeds but auth token not persisted - shows 'Missing API key' after successful login
- [BUG] v2.1.63 crashes on Alpine Linux (musl): posix_getdents symbol not found
- v2.1.89: scrollback history lost in terminal (Ghostty)
- [BUG] - Accidentally pressing ESC while Claude Code is actively processing a request
- [BUG] npm install now ships Bun binary (v2.1.126) — npm workaround for non-AVX VPS is dead, no upgrade path
- [BUG] Claude command intermittently becomes unavailable ("command not found") with ENOTEMPTY errors preventing reinstallation on Ubuntu 24.04
- Homebrew: claude update advertises version not available in stable cask
- [BUG] Silent billing change in v2.1.51: 1M context moved to extra-usage-only without notice — JSONL data proves identical workload billed differently
- [BUG] Cannot open or use claude after last update (0.2.119)
- [BUG] Plugins show as "(installed)" in marketplace but don't appear in Installed tab
- No uninstall documentation for the native Claud Code build (Windows)
- Automatic Update Mechanism Failure
- [Bug] Anthropic API Error: Internal server error (500)
- [BUG] ESC Key Causes Complete Terminal Freeze in Claude Code
- [BUG] Error installing VS Code extension: 1: ENOENT Please restart your IDE and try again.
- v2.1.69: Freezes on startup on Windows - mkdirSync EEXIST error loop
- [BUG] Auto-update Fails for claude-code
- [BUG] Cowork macOS - Plugin install fails with HTTP 404, plugins.claude.ai does not resolve
- typescript-lsp plugin fails on Windows: spawn ENOENT for npm global binaries
- [Regression, Windows+macOS] Cross-session messaging silently broken since CCD 2.1.224+ — messages dropped, recipient sessions wedged 15-20 min (hadFirstResponse=false); fixed in 2.1.237 for some installs, stable channel still affected
- [BUG] CLI fails on Windows with Git Bash: "No suitable shell found"
- [BUG] Claude Desktop 1.1.4173 fails to show GUI — @formatjs/intl unhandled promise rejection crashes renderer
- Hardcoded /tmp/claude paths break on Termux (Android)
- [BUG] Verbose output setting fails to persist (reverts to default after restart)
- [BUG] Claude Code MCP Server OAuth authentication doesn't work in SSH remote sessions
- [BUG] Claude Desktop 1.6608.0 (macOS): All rewind attempts rejected with "Can't rewind to this message" — regression after auto-update
- [BUG] v2.1.69: thinking summaries empty in transcript and TUI — undocumented behavior change
- [BUG] : fresh native installation raise warning about npm
- Bug Report :: When Update keeps giving me please wait and try again later
- @anthropic-ai/claude-code SDK fails with "spawn node ENOENT" in Docker containers despite working CLI
- MCP Configuration Unexpectedly Deleted From File During Auto-Update
- [BUG] Claude Code OAuth Authentication Fails - "OAuth account information not found in config"
- Windows: pyright-lsp plugin fails with ENOENT - cannot spawn .cmd files
- Invalid API key · Please run /login
- [BUG] Claude stuck at 0 tokens
- Image Processing Failure: API Rejects Unrelated Context Image
- [BUG] /context command no longer display in chat window on VS Code ext version 2.1.45
- [BUG] Installation failed Failed to fetch version from stable: AxiosError: timeout of 30000ms exceeded
- Repeated Bun v1.3.5 segfaults -- 78 crashes, root cause identified (Windows + WSL)
- [BUG] Server-side experiment (`x-cc-atis`) silently removed Opus 4.8 thinking summaries, and the CLI silently self-updated even with `autoUpdates: false`. No notice, no opt-in, settings silently overridden.
- [Bug] "Unchanged since last read" error when reading file previously accessed in reverted conversation state
- [BUG] /sandbox seccomp filter instructions don't work, paths not read from settings
- Plugin Management Issues in Claude Code Marketplace
- [Bug] Claude Code hangs unresponsively on macOS M1, requires terminal force-close
- Claude Code CLI Bug Report: Bash Tool Returns No Output on macOS 26
- [Bug] Auto-update fails with npm ENOTEMPTY rename error
- [BUG] IDE integration broken after auto-update from v1.0.27 to v1.0.28+
- Feature: add a /restart option
- VSCode Terminal Shift+Enter Keybinding Installation Failure
- [BUG] Claude Desktop Windows installer fails with AddPackage HRESULT 0x80073CF6 after an earlier "successful" install left the package in an inconsistent state
- [FEATURE] Enable marketplace auto-update through settings.json
- [BUG] Claude Desktop update fails with 0x80073CF6 when CoworkVMService is running (Windows)
- [BUG] Failed to install Anthropic marketplace · Will retry on next startup
- Feature Request: Add Hook for Tool Execution Failures (`OnToolError` / `ToolUseFailure`)
- [Solution] Resolve Windows bugs with settings.local.json, auto accept edit,... issue with v1.0.103
- API Error: 500
- [Bug] Anthropic API Error: Internal server error (500)
- [BUG] Freezing Issues at Session Resuming (with `claude --continue` and `claude --resume`) after Ctrl+C interruption on Windows
- Bundled Bun binary lacks AVX baseline support — crashes on non-AVX CPUs
- [BUG] Installer getting stuck at cleaning old NPM installations
- API Error: 401 {"type":"error","error":{"type":"authenticati...
- VS Code Extension Automatically Creates Local Installation Without User Consent
- [BUG] Cannot paste OAuth auth code in v2.1.107 (regression from v2.1.104)
- [FEATURE] PermissionRequest and PermissionResponse hook events for metrics
- [Bug] Anthropic API Error: Invalid message format with thinking blocks
- [BUG] LSP plugins not working with native/standalone binary installation
- Plugin install fails with EXDEV when ~/.claude and /tmp are on different filesystems
- [BUG] @anthropic-ai/claude-code not working
- Missing File Discovery with "@" After Migration and Update
- API Request Failure: Unexpected Usage Policy Violation Error
- [FEATURE] Plugins - Add postInstall, postUpdate and postUninstall hooks in plugin.json
- [BUG] Claude CLI 1.0.96 randomly/predictably freezes on Windows - affects all commands, persists across sessions
- [Feature] Mode-specific permissions: Separate command allowlists for read-only vs normal modes
- [BUG] Bash tool fails with zsh + zoxide configuration - "__zoxide_z not found" errors
- [BUG] Mac desktop app: 'Your previous message wasn't sent' toast fires after successful response, caused by postMessage origin mismatch to claudeusercontent.com
- Claude-in-Chrome Windows & WSL working fixes
- [BUG] Linux Terminal Freezes after launching new versions of Claude code from 2.1.34. Complete Freeze - Cannot Type, Ctrl+C Non-Responsive
- # [BUG] Slash command namespacing with subdirectories not working as documented
- Intermittent Claude CLI Uninstallation on macOS M1
- Claude update to 0.2.30 fails to install
- [BUG] Publish @anthropic-ai/claude-code-freebsd-x64 (and -arm64) native binary packages
- [BUG] Claude code 2.1.83 and above broken on WSL1
- [BUG] Windows Terminal input completely frozen starting from v2.1.30 (regression from v2.1.29)
- v2.1.45: Bash broken on Windows - bad file descriptor on stdout pipe
- [BUG] Claude Code - LSP Tool Returns Empty Results Despite Server Responding Correctly (Windows)
- [Bug] TypeScript LSP Plugin Not Registering with LSP Tool System
- Thread rename fails with ENOENT error: file path resolves to 'n/a'
- [Bug] Claude Code 2.1.243 crashes with SIGSEGV on startup (null pointer dereference)
- [BUG] Windows: Claude Code Desktop app shows sessions in sidebar but all message content missing after auto-update — content not persisted to claude-code-sessions JSONL files
- [BUG] 2.1.113 crashes with SIGILL "illegal hardware instruction" on Ivy Bridge (AVX2-less) Intel Macs — regression from 2.1.112
- Invalid Version error on startup: semver parsing fails on changelog header '2.1.0 (2026-01-07)'
- [Critical Bug] Session history lost after auto-update from 2.0.44 to 2.0.49
- [BUG] claude resume freezes terminal on Windows 11 - v1.0.96
- [BUG] ReferenceError: ReadableStream is not defined
- [BUG] Claude in Chrome + Control Chrome Failures in Cowork Mode
- [BUG] Recurring auto-update failures with ENOTEMPTY error
- VS Code extension v2.1.129: command 'claude-vscode.editor.openLast' not found on Windows
- remote-control fails: node: bad option: --sdk-url
- RangeError: Maximum call stack size exceeded crash
- [BUG] Copied multi-line commands from Claude Code output contain formatting artifacts — still unfixed after 6+ months
- [BUG] Cowork Windows - CSP blocks a-api.anthropic.com, VM starts but API unreachable (Win 11 25H2)
- [BUG] Alt+M keyboard shortcut to cycle modes broken on Windows in 2.1.x
- LSP plugins not registering servers - LSP Manager initializes before plugins load
- [BUG] v1.0.98 is not reading project .mcp.json and rewriting .claude/settings.local.json
- [Bug] Background (daemon) sessions drop assistant text blocks from transcript when response mixes text with tool_use (regression 2.1.160 → 2.1.161)
- [BUG] Voice recording requires the native audio module, which could not be loaded.
- [BUG] Native installer fails with "another process is currently installing" on Linux even after complete cleanup
- [BUG] claude-code for Windows is NOT available due to its port
- Non-Interactive Mode Fails to Authenticate Using Provided API Key
- Segfault regression at 2.1.242 on glibc 2.44 (Arch) — distinct from closed #62747
- Windows desktop app: cross-session send_message silently fails (reports success, never delivered) after runtime 2.1.222→2.1.227 auto-update
- OTEL telemetry stopped working after auto-update to v2.1.72 with OTEL_LOG_TOOL_DETAILS: 1 and elastic apm 8.*
- [BUG] 2.1.69 hangs on Windows after "Yes, I trust this folder" — EEXIST lock path error
- Bug: Claude Code 2.1.32 regression - allocates ~11GB RAM on launch, freezes terminal (2.1.30 works fine)
- [Bug] Anthropic API Error: Internal Server Error (500)
- [BUG] Native binary installation ignores HTTP_PROXY for API streaming requests (Bun fetch issue ?)
- [BUG] VS Code extension installation fails with 'End of central directory record signature not found' on /status
- Image Dimension Exceeds Max Size in Multi-Image API Request
- [BUG] Opus 1M context window suddenly returns "Rate limit reached" on both Max and Team plans (200K works fine)
- [BUG] Input freezes on Windows when launching Claude Code from certain directories (native installer)
- [BUG] input lag while typing in v2.0.72
- [Bug] npm Install Fails: ENOTEMPTY Error During Global Package Update
- Auto-update breaks @file_path functionality, displays only subagent options
- [BUG] Plugin skills not appearing in `/` menu after v2.1.110 update — only `schedule` shows
- [BUG] Tool results silently dropped with "missing due to internal error" across all tools on Windows (regression in 2.1.101)
- Update notification always shown for winget installations due to npm version check
- [BUG] `Update available` banner suggests brew upgrade when `brew cask` is already at latest
- VS Code extension v2.1.51: commands not found (claude-vscode.editor.openLast)
- Claude Code CLI: Node.js v25 Incompatibility - TypeError "prototype" is undefined in cli.js
- Scroll back + Color bleaching + Memory leak fix -- npm i -g claudefix --- Cons: Plugs myself and runs an ad, makes claude immutable so it stays locked --- Slowly adding more festures to ennhance UX, youre a bot if youre bitching about safety in the comments.. Linux only
- [Bug] Inconsistent usage percentage display between /usage page and CLI
- [BUG] claude doctor reports insufficient permissions for automatic updates when using NVM
- CLI auto-updater doesn't clean up old binaries, triggers repeated macOS TCC permission dialogs