Where to start
- Start with what you can see: the words on your screen, a session that will not move, or a machine that got slow.
- If the message mentions the network or the API, open the connection guides first. They cover every form of it.
- If the message came from a tool you added to Claude Code (an MCP server), the MCP errors guide explains what it is telling you.
- Not sure which error you have? The error message index lists the common ones and says what to search for.
Every guide in this topic
- Claude Code API Error: 500 Internal Server Error
What Claude Code's 500 Internal Server Error means, why the API returns it, the retries that came first, and the steps Anthropic documents.
- Claude Code auto mode unavailable: classifier errors
Every Claude Code auto mode message: what it means, why the classifier stopped answering, and the documented way out. Checked against Anthropic's docs.
- Claude Code: a command takes file @-mentions only
Why the Claude desktop app refuses a slash command that also carries a link, a second command or formatting, and how to send it anyway.
- API Error: Can't Reach the API Server (ENOTFOUND) Fix
Which Claude Code connection error you have, ENOTFOUND, ECONNRESET, ECONNREFUSED, a proxy refusal or a timeout, and the step that clears each.
- Claude Code behind a corporate proxy and SSL inspection
What Claude Code needs on a locked-down network: the hosts to allow through the firewall, where the company root certificate goes, and proxy variables.
- Claude Code: connection refused (ECONNREFUSED)
ECONNREFUSED in Claude Code means something answered and said no. The three common causes, what to try first, and the command that finds it.
- Claude Code ECONNRESET: connection dropped
What Claude Code's Connection dropped (ECONNRESET) message means, why a proxy or gateway cuts it, and the steps Anthropic documents.
- Claude Code ENOTFOUND: can't reach the API server
What Claude Code's ENOTFOUND error means, the curl command that shows where it breaks, and the DNS, VPN and proxy fixes Anthropic documents.
- Claude Code Error Editing File: String Not Found
Why Claude Code says String to replace not found in file, or Error editing file, what makes the exact match fail, and the fix for each cause.
- Claude Code Error Messages: The Exact Fix for Each One
Auto mode unavailable, 529 overloaded, monthly spend limit, credit too low, request too large: find your message and the step that clears it.
- Claude Code Failed to Load Session: What to Check
Failed to load session comes from the Claude desktop app's Code tab. Anthropic's three causes, the log lines reports show, and what to try for each.
- Claude Code High CPU and Memory Use, and What to Measure
Claude Code using too much CPU or memory: what Anthropic documents, the settings that bound it, how to measure, and which reports stay open.
- Claude Code MCP Server Failed to Connect: Each Error, Fixed
Failed to connect, timed out, rejected your token or flooded the conversation: the exact MCP message, what it means, and the steps that clear it.
- Claude Code Not Following CLAUDE.md: What to Check
The file loaded and the rule was still ignored. Prove what Claude read, fix vague or conflicting wording, and turn the rules that must hold into hooks.
- Claude Code Overloaded and 429 Errors: What to Do
What the Claude Code 529 Overloaded and 429 Request rejected messages mean, the retries that came first, and the documented steps that clear them.
- Claude Code API Error: Rate limit reached
What the bare API Error: Rate limit reached means in Claude Code, why it can appear with quota left, and the documented fix for each kind of limit.
- Claude Code: request too large (max 32MB)
What Claude Code's Request too large (max 32MB) message means, how it differs from a full context window, and the three fixes that work in order.
- Claude Code Stream Idle Timeout: Why the Stream Went Quiet
An idle timeout is Claude Code's own watchdog, not an API error code. The four timers behind it, each default, and the documented steps that help.
- Claude Code stuck on thinking: what to check, in order
Claude Code stuck on thinking with no reply: how to tell a wedged process from a slow model call or a rate-limit wait, and the order to recover in.
Fix it, then run every agent in one window
Omniscio is the desktop app we make for people who run several Claude Code sessions at once. Any model, any harness — Claude Code, Codex, OpenCode, Devin, Pi, and Hermes all supported.