Claude Code Pitfalls: Claude Code Won’t Do What You Told It: A Troubleshooting Catalog (opens in new tab)

Last Updated on June 3, 2026 by Editorial Team Author(s): Rick Hightower Originally published on Towards AI. Part 17: Why your config looks right but Claude ignores it, and the exact commands that diagnose it in seconds In this article: Most Claude Code failures are not mysteries. They are a small set of recurring patterns: files that load on demand instead of at startup, permission rules that quietly override your mode, descriptions that fail to trigger a subagent. This is a Claude Code trou...