>_ tool archive
Claude Code fixes & guides
6 guides · what breaks in Claude Code, why it happens, and the exact steps that fix it.
-
Why Claude Code missed code that's clearly in your file (it only read part of it)
Claude Code missing or duplicating code that's clearly in your file? It probably only read the first 2,000 lines. Here's how to tell, and how to point it at the right section.
Read the fix -
Why Claude Code isn't following your CLAUDE.md file (it's probably never loaded)
CLAUDE.md rule getting silently ignored? Here's why subdirectory files load lazily, CLAUDE.local.md only works at the project root, and how to check exactly what's loaded with /memory.
Read the fix -
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