EPIPE: broken pipe

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

57 issues · 2 open · 55 resolved (96%) · first seen Feb 24, 2025

First response · local

What to do now

Most likely: The operating system rejected a file or directory operation.

  1. Read the first path in the error and verify that it exists and belongs to the expected user.
  2. Check disk space, permissions, symlinks and whether another process holds the target.
  3. Reproduce with the smallest affected path before changing project-wide permissions.

These are conservative triage steps, not an official Anthropic fix. Use the issue and workaround evidence below before making a destructive configuration change.

Is this getting better or worse?

This class of problem is converging. 3 new reports in the last 90 days vs 8 in the 90 before — -62%. The open backlog peaked at 4 in 2025-07 and sits at 2 today.

0 1 2 3 4 2025-022025-082026-022026-08
2025-02 — First reports2025-07 — Peak backlog (4 open)

Derived by counting each matching issue from its creation date until it closed. First-party computation over the anthropics/claude-code tracker — the trend is not published anywhere upstream.

Which builds report this

10 of these reports name the Claude Code build they were running, spanning 10 releases. Heaviest reporters:

Report volume, not a defect count: an issue can mention a build without that build having caused the failure. Versions come from the version string in the bug-report template, matched against real published tags.

Do these get fixed?

Median time to close is 3 days across 55 closures. Of the 55 closures with a recorded reason, 36% were closed as completed and 35 as not-planned or duplicate. The most recent completed fix landed in 2026-08.

Workarounds reported by the community

11 of these issues post a workaround someone says worked. The highest-engagement ones:

Node.js EPIPE Error on Bash Command Execution
…ng to 1.0.54 seems fine. For other suffering the pain (temp workaround):
Found in the thread of #3881 · resolved
Unhandled EPIPE Error Causing Node.js Application Crash
…bove - crashes during operation with work in progress lost. Temporary fix applied: Following the suggestion in this thread, I've disabled PostToolUse hooks in and will test if this resolves the issue. Status: Testing the…
Found in the thread of #2834 · resolved
[BUG] Cowork on macOS 1.8555.2 — zero MCP tools bind in any install path (.mcpb + SDK bridge + Custom Connectors + project .mcp.json); spawn pipeline missing --mcp-config since 2026-05-23 auto-update
Update — workaround validated empirically, regression boundary confirmed Following up after running the same-machine, same-config A/B comparison to nail down whether 1.8555.2 is genuinely the regression point. Method - O…
Found in the thread of #62072 · still open
Error: write EPIPE
Found the a workaround: Seems caused because I'm using FISH, which the isn't supported?
Found in the thread of #47 · resolved
EPIPE Crash When Running Claude Code in Python Project Directory
…adding some logic to fix the case that is addressed by the workaround I posted. For the folks who need to run sudo, I'm adding some logging that hopefully help us track this down. On Tue, Feb 25, 2025 at 1:52 PM Darin @…
Found in the thread of #31 · resolved

Excerpts are quoted from the linked issue so you can judge relevance before opening it. Threads that only ask for a workaround, or report that there is none, are excluded. These are community suggestions, not official guidance from Anthropic — read the full thread before applying one.

Matching issues 1–57

Ranked by community engagement (reactions weighted over comments).

Related aggregations

  1. ENOENT: no such file or directory

    1,200 issues
  2. EISDIR: illegal operation on a directory

    495 issues
  3. EACCES / EPERM: permission denied

    415 issues
  4. ENOTEMPTY: directory not empty

    88 issues
  5. EEXIST: file already exists

    138 issues
  6. EBUSY: resource busy or locked

    127 issues