Most Claude Code friction comes from a handful of recurring issues: auth/token expiry, MCP server connection failures, permission-prompt loops, and context-window limits on large repos.
Auth errors usually resolve with a fresh login; MCP failures are typically a misconfigured server command or missing env var; permission loops ease once you allowlist the safe, repeated tool calls.
Knowing the specific error signature is half the fix — a reference of the common messages and their resolutions turns a vague failure into a two-minute correction.
Try it: ClaudHQ on common claude code errors.