Troubleshooting
Fixing common Claude Code problems — install and runtime errors, performance issues, and interpreting error messages.
4 articles
Claude Code Install & Login Errors: Step-by-Step Fix Guide
Hitting 'command not found', a 403 login error, or a broken PATH after installing Claude Code? This guide walks you through every common fix.
How to Read Claude Code Error Messages — A Beginner's Guide
So a red error in Claude Code doesn't faze you: how to read, classify, and handle error messages at a beginner's level. Covers automatic retries, the 5 kinds (server, usage, login, network, request), a calm 3-step approach, and /status and /doctor helpers.
Claude Code Running Slow or Freezing: Performance & /doctor Diagnostics
Installed and logged in, but Claude Code is slow, freezing, or not finding files? From /doctor diagnostics to /compact, --safe-mode, /heapdump, and ripgrep — step-by-step fixes based on the official Claude Code docs.
Claude Code Not Working? Fix Install, Auth & Connection Errors
How to fix Claude Code when it won't install or log in: command not found (PATH), sudo permission errors, the Node.js requirement (none for native, 22+ for npm), proxy and corporate certificates, OAuth browser and localhost callback, API key recognition, and re-authentication — based on official docs.