Claude Code Common Errors and Fixes — The Complete Reference
Claude Code suddenly stops with "log in again," "rate limit," "prompt is too long," "MCP won't connect" — and googling each one gets tedious. This is a practical reference that catalogs the errors you commonly hit, with the cause and the command to run for each. It starts with the three diagnostic commands to run first (claude doctor for full diagnostics, /status for active auth, /context for the context breakdown), then focuses on the four common families (usage/rate limits, context overflow, expired auth, MCP connection failures) with symptom→cause→fix-command tables across auth & login, usage/rate limits (Claude Code burns 10-100x the tokens of chat), context & tokens (prompt too long, compaction thrashing), server & model (500/529/timeout/model not found), install/PATH/update, network & proxy (ECONNREFUSED, TLS), MCP, permissions (deny beats bypass), and misc (thinking blocks 400, image/PDF, IDE). It ends with an error→fix cheat sheet and FAQ. Based on the official Claude Code docs (as of 2026): when stuck run the three diagnostic commands, and if it is not fixed, run claude update.