›_ Claude Code Issues
Claude Code Issues / Error strings

Claude Code Errors by Exact Message

When Claude Code fails it prints a specific string. These 40 pages index 15,562 issue reports by that string, so you can search the way you actually have it — pasted from your terminal. Each page adds the backlog trend, the builds that report it, resolution times, and workarounds pulled from the threads.

Only error strings backed by at least 25 real reports get a page. Signatures are hand-written, not auto-mined — see the note at the bottom.

Anthropic API errors

HTTP status and error-type responses returned by the API.

  1. API Error 400 (invalid_request_error)

    The request itself was malformed or violated a schema constraint.

    2,649 issues 113 open ✓ 468 workaround mentions

  2. API Error 500 (internal server error)

    A server-side failure on the API, usually transient but sometimes build-specific.

    608 issues 8 open ✓ 29 workaround mentions

  3. API Error 401 (authentication_error)

    The API rejected the credential attached to the request.

    463 issues 40 open ✓ 91 workaround mentions

  4. API Error 429 (rate_limit_error)

    The API rejected the request for exceeding a rate or usage limit.

    699 issues 21 open ✓ 23 workaround mentions

  5. API Error 529 (overloaded_error)

    Anthropic capacity saturation: the model is temporarily overloaded.

    260 issues 19 open ✓ 16 workaround mentions

  6. API Error 403 (permission_error)

    The credential is valid but not allowed to use this model, org, or endpoint.

    256 issues 32 open ✓ 54 workaround mentions

  7. API Error 413 (request_too_large)

    The payload exceeded the maximum request size the API accepts.

    39 issues 2 open ✓ 7 workaround mentions

  8. Model not found (not_found_error)

    A requested model id is unavailable to this account or was retired.

    85 issues 4 open ✓ 8 workaround mentions

Filesystem & permission errors

POSIX errno codes raised while reading, writing, or executing.

  1. ENOENT: no such file or directory

    A path Claude Code tried to open does not exist at that location.

    1,241 issues 61 open ✓ 233 workaround mentions

  2. EISDIR: illegal operation on a directory

    A directory path was handed to a call that expects a file.

    497 issues 8 open ✓ 20 workaround mentions

  3. EACCES / EPERM: permission denied

    The OS refused a read, write, or exec because of file ownership or mode.

    453 issues 69 open ✓ 156 workaround mentions

  4. ENOTEMPTY: directory not empty

    A remove or rename targeted a directory that still has contents.

    90 issues 8 open ✓ 20 workaround mentions

  5. EEXIST: file already exists

    A create or mkdir hit a path that is already taken.

    142 issues 7 open ✓ 68 workaround mentions

  6. EBUSY: resource busy or locked

    Another process holds the file or device Claude Code needs.

    141 issues 13 open ✓ 38 workaround mentions

  7. EXDEV: cross-device link not permitted

    A rename crossed a filesystem boundary, which the OS will not do atomically.

    92 issues 4 open ✓ 53 workaround mentions

  8. ENOSPC: no space left on device

    The disk or inode table filled up mid-operation.

    65 issues 5 open ✓ 24 workaround mentions

  9. EPIPE: broken pipe

    Claude Code wrote to a pipe whose reader had already gone away.

    60 issues 4 open ✓ 13 workaround mentions

Network & TLS errors

Socket, DNS, proxy, and certificate failures reaching the API.

  1. ECONNRESET: socket hang up

    The peer tore the TCP connection down mid-request.

    251 issues 46 open ✓ 58 workaround mentions

  2. ECONNREFUSED: connection refused

    Nothing was listening at the address Claude Code dialled.

    214 issues 8 open ✓ 18 workaround mentions

  3. Self-signed certificate in certificate chain

    A TLS-inspecting proxy presented a certificate Node will not trust.

    43 issues 3 open ✓ 23 workaround mentions

  4. ETIMEDOUT: request timed out

    A socket exceeded its timeout before the response arrived.

    33 issues 10 open ✓ 9 workaround mentions

  5. getaddrinfo ENOTFOUND (DNS lookup failed)

    The hostname failed to resolve, usually DNS or a proxy rewrite.

    59 issues 11 open ✓ 25 workaround mentions

  6. EADDRINUSE: address already in use

    A port Claude Code wanted to bind is already held by another process.

    31 issues 2 open ✓ 14 workaround mentions

Node runtime crashes

JavaScript exceptions, heap exhaustion, and fatal signals.

  1. AbortError: the operation was aborted

    An in-flight request was cancelled by an abort signal or timeout.

    2,116 issues 40 open ✓ 106 workaround mentions

  2. SyntaxError: Unexpected token

    A parse failed, most often on config or a truncated JSON response.

    712 issues 24 open ✓ 76 workaround mentions

  3. Killed: 9 (SIGKILL / OOM killer)

    The kernel terminated Claude Code outright, usually for memory pressure.

    368 issues 75 open ✓ 183 workaround mentions

  4. Segmentation fault (SIGSEGV / SIGABRT)

    The process died at the native layer rather than throwing a JS error.

    320 issues 60 open ✓ 113 workaround mentions

  5. TypeError: Cannot read properties of undefined

    A property access on undefined or null crashed the CLI.

    198 issues 7 open ✓ 53 workaround mentions

  6. JavaScript heap out of memory

    V8 exhausted its heap and aborted the process.

    143 issues 3 open ✓ 32 workaround mentions

  7. Unhandled promise rejection

    An async failure escaped every catch and reached the process handler.

    60 issues 2 open ✓ 17 workaround mentions

  8. RangeError: Maximum call stack size exceeded

    Unbounded recursion blew the JS stack.

    30 issues 1 open ✓ 8 workaround mentions

Session, auth & limit messages

Login, quota, and context-window messages surfaced in the CLI.

  1. Claude usage limit reached

    The plan quota was consumed and the session paused until reset.

    177 issues 14 open ✓ 27 workaround mentions

  2. Auto-compact / compaction failed

    The conversation-compaction step errored or looped instead of shrinking context.

    393 issues 22 open ✓ 104 workaround mentions

  3. OAuth token expired / refresh failed

    The stored OAuth token lapsed and the refresh did not recover it.

    399 issues 84 open ✓ 143 workaround mentions

  4. Prompt is too long (context window exceeded)

    The assembled prompt exceeded the model context window.

    337 issues 25 open ✓ 51 workaround mentions

  5. Invalid API key (invalid x-api-key)

    The key in the environment or keychain was rejected outright.

    100 issues 5 open ✓ 19 workaround mentions

  6. Your credit balance is too low

    The workspace ran out of prepaid credit for API calls.

    84 issues 13 open ✓ 6 workaround mentions

Tooling & integration errors

MCP, shell spawn, npm, and terminal-rendering failures.

  1. Garbled / flickering terminal output

    Escape-sequence handling corrupts the rendered TUI in some terminals.

    888 issues 100 open ✓ 264 workaround mentions

  2. spawn ENOENT / command not found

    A shell or tool binary was not on PATH when Claude Code tried to run it.

    525 issues 43 open ✓ 223 workaround mentions

  3. MCP server failed to start or connect

    A configured MCP server never completed its handshake or dropped out.

    241 issues 27 open ✓ 84 workaround mentions

How these pages are built

Every signature below is hand-written. We tried mining uppercase tokens automatically and the real corpus returned ENTIRE, EDITOR, EVERY and EXACTLY as if they were errno codes — which would have shipped dozens of nonsense pages. Curation is the whole point: a page exists only when a string a human would actually paste into a search box has at least 25 real reports behind it.