Claude Code 突发 Error: write EPIPE 错误求助排查

问题现象 #

在Ubuntu系统中，通过brew安装的Node环境下，Claude Code工具此前可在目标目录正常运行，现在启动即抛出Error: write EPIPE错误，其他目录可正常使用该工具，使用npx @anthropic-ai/claude-code运行仍出现相同错误。完整报错信息如下：

➜ claude
Error: write EPIPE
    at afterWriteDispatched (node:internal/stream_base_commons:159:15)
    at writeGeneric (node:internal/stream_base_commons:150:3)
    at Socket._writeGeneric (node:net:971:11)
    at Socket._write (node:net:983:8)
    at writeOrBuffer (node:internal/streams/writable:570:12)
    at _write (node:internal/streams/writable:499:10)
    at Writable.write (node:internal/streams/writable:508:10)
    at n6.sendToShell (file:///home/linuxbrew/.linuxbrew/lib/node_modules/@anthropic-ai/claude-code/cli.mjs:343:423)
    at file:///home/linuxbrew/.linuxbrew/lib/node_modules/@anthropic-ai/claude-code/cli.mjs:340:1714
    at new Promise (<anonymous>) {
  errno: -32,
  code: 'EPIPE',
  syscall: 'write'
}
╭────────────────────────────────────────────────────────────╮
│ ✻ Welcome to Claude Code research preview!                 │
│                                                            │
│   /help for help                                           │
│                                                            │
│   cwd: /home/dimitrios/path/to/project/in/question/thanks  │
╰────────────────────────────────────────────────────────────╯

╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ > Try "fix typecheck errors"                                                                                                │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
  ! for bash mode · / for commands · esc to undo                                                               \⏎ for newline



Total cost: $0.0000
Total duration (API): 0.0s
Total duration (wall): 0.9s

解决方案 #

1. 排查当前目录的特殊文件与权限 #

EPIPE错误通常源于向已关闭的管道写入数据，可能是当前目录存在特殊文件或权限异常：

• 列出目录内的管道、socket类特殊文件：

  ls -la | grep -E "(pipe|socket)"
  

  若发现可疑文件，暂时移至其他目录后重试启动Claude Code。
• 确保当前用户对目录拥有完整读写权限：

  chmod u+rwx ./
  

2. 清理Claude Code本地缓存 #

工具在目标目录可能遗留了损坏的缓存文件，导致启动异常：

• 删除工具全局缓存目录：

  rm -rf ~/.cache/@anthropic-ai/claude-code
  

• 检查当前目录是否存在工具相关隐藏文件，若有则删除：

  ls -la | grep "\.claude"
  # 找到后执行 rm -rf .claude相关文件
  

3. 重置Node与Claude Code安装环境 #

Node的brew安装可能出现局部异常，影响工具依赖：

• 重新链接Node：

  brew unlink node && brew link node
  

• 重装Claude Code工具：

  npm uninstall -g @anthropic-ai/claude-code && npm install -g @anthropic-ai/claude-code
  

4. 测试终端与shell兼容性 #

部分终端环境在特定目录下会出现管道异常：

• 在当前目录执行简单管道命令测试：

  echo "test" | cat
  

  若该命令也报错，说明终端或shell在该目录存在配置问题，检查当前用户的shell配置文件（如.bashrc、.zshrc）是否在该目录有特殊逻辑。

内容的提问来源于stack exchange，提问作者Dimitrios Mistriotis