>_ tool archive
Claude Code fixes & guides
4 guides · what breaks in Claude Code, why it happens, and the exact steps that fix it.
-
Claude Code says your MCP server “Failed to connect” — it might not even be trying
"Failed to connect" isn't the only status claude mcp list can show. Here's why project-scoped MCP servers sit at Pending approval in a freshly cloned repo, the missing-type gotcha that silently drops remote servers, and how to tell which one you actually have.
Read the fix → -
Your Claude Code hook isn't firing (or isn't blocking anything) — here's why
You wired up a PreToolUse or PostToolUse hook and it either never runs or runs but doesn't stop anything. Here's the exact-match-vs-regex matcher rule, the exit-code-2-not-1 gotcha, and the other silent failure points — plus how to check each one.
Read the fix → -
Why Claude Code stops following instructions you gave it earlier (it's not being stubborn)
Claude Code was doing exactly what you asked, then 20 minutes later it isn't anymore — and there is no error. Here is the actual mechanism (context compaction) and how to make instructions survive it.
Read the fix → -
Claude Code 529 errors and rate limits: how to tell which one you're hitting
Claude Code throwing a 529 or telling you you're rate limited? Here's how to diagnose which problem you actually have and what to do about each one.
Read the fix →