Troubleshooting Guides
Explore 6 curated troubleshooting guides for building with AI coding agents — what each one does, when to use it, and how to add it to your workflow.
Claude Code Troubleshooting: Fixes for the Most Common Problems
Fixes for the Claude Code problems people actually hit — install and auth failures, context-limit errors, MCP servers that won't connect, permission loops.
Claude Skills Not Working? Fixes for Every Failure Mode
Skill missing from the / menu, never auto-triggering, firing too often, or breaking mid-run — the symptom-by-symptom fix list for Claude skills.
Codex Troubleshooting: A Layer-by-Layer Recovery Guide
Troubleshoot OpenAI Codex when files, commands, configuration, worktrees, MCP, or app features misbehave — with a fast isolation and recovery sequence.
Why Your Agent Loops: Debugging AI Agents
The recurring agent failure modes — loops, premature victory, tool misuse, context poisoning, scope creep — diagnosed by their signatures, with fixes.
MCP Troubleshooting: Server Won't Connect & Other Fixes
Fixes for the MCP problems people actually hit — servers failing to connect, missing tools, OAuth loops, timeouts, truncated output, and Windows quirks.
Why RAG Fails: A Debugging Checklist
A diagnostic checklist for broken RAG — localize the failure to ingestion, retrieval, ranking, or generation, and apply the fix that matches, in order.