Claude Code Troubleshooting
Start by checking the installed version, then use the fix that matches how Claude Code was installed on this machine.
Check your current version
claude --version
Compare it with the current release on the Claude Code update guide.
Auto-update failed
Native installs auto-update in the background. If Claude Code still reports an older version, restart the terminal and check the version again. If it is still stale, rerun the native installer from the update guide.
Update Claude CodeHomebrew or WinGet is behind
Package manager installs update through the package manager rather than the native background updater.
brew upgrade claude-code
winget upgrade Anthropic.ClaudeCode
Marketplace or plugin install failed
Update Claude Code first, restart the terminal, then retry the marketplace or plugin install. If the plugin comes from a private source, confirm the machine still has network access and credentials for that source.
claude --version
FAQ
How do I check whether Claude Code is on the latest version?
Run claude --version, then compare the installed version with the latest release listed on the update guide.
Why did Claude Code auto update fail?
Native installs usually auto-update in the background. If the version looks stale, restart your terminal, run claude --version again, and use the update guide for the install method on that machine.
What should I do when Homebrew or WinGet is behind?
Homebrew and WinGet installs update through their package managers. Run brew upgrade claude-code or winget upgrade Anthropic.ClaudeCode, then verify with claude --version.
How do I fix a marketplace or plugin install failure?
Update Claude Code first, restart the terminal, confirm your network or proxy can reach the plugin source, then retry the marketplace or plugin install.
What should I try for Windows install issues?
Confirm Git for Windows is installed, restart PowerShell, then rerun the Windows install command from the update guide.