PaPoo
cover

EPERM が出るのは、SMB 上のファイル操作が怪しいときだった

まず自分のケースかどうかを見るなら、今回集めた issue では「ネットワーク越しのボリューム」や「Windows のパス解決」で EPERM が出ています。ローカルディスクの単純な読み書きではなく、保存先や対象が少し特殊なときに崩れていました。

たとえば macOS では、SMB マウントされた volume 上のファイルに対して Read/Bash を走らせると Operation not permitted が返る報告があります。報告者は mount の所有者で、smbutil statshares でも SMB 3.1.1 と暗号化有効を確認していました。それでも dangerouslyDisableSandbox: true では止められず、--add-dir /Volumes/storagepermissions.additionalDirectories を追加する回避策しか見つかっていませんでした。これが #57540 です。

Windows 側では少し様子が違っていて、Write tool だけが EPERM: operation not permitted, mkdir 'C:\Users\user' で失敗します。Read、Edit、Bash は同じパスで動くのに、Write だけが壊れるという報告でした。正しいパスを教えると次の Write は通るものの、その状態は続かず、次のターンではまた同じ EPERM に戻る、とあります。こちらは #57293 です。

一方で、今回の筆者環境では claude --versionclaude doctor しか確認しておらず、EPERM 自体は再現していません。少なくともインストール状態は次のように見えました。

$ claude --version
2.1.207 (Claude Code)
$ claude doctor
Claude Code doctor

Running: native (2.1.207)
Commit: bc512d563325
Platform: darwin-arm64
Path: ~/.local/share/claude/versions/2.1.207
Config install method: native
Search: OK (bundled)
Auto-updates: enabled
Auto-update channel: latest
Last update attempt: none recorded

Multiple installations found
- npm-global at /usr/local/bin/claude
- native at ~/.local/bin/claude

Remote Control
Control this session from claude.ai/code or the Claude mobile app

1 warning found
- Leftover npm global installation at /usr/local/bin/claude
  Fix: Run: npm -g uninstall @anthropic-ai/claude-code

For a full setup checkup that can also fix issues, run /doctor in a Claude Code session.
$ /usr/bin/which -a claude
~/.local/bin/claude
/usr/local/bin/claude
/usr/local/bin/claude
$ node --version
v22.15.0

この範囲だけから言えるのは、EPERM は「Claude Code が普通のローカルパス以外に触ろうとしたとき」に目立っており、macOS の SMB マウントでは --add-dirpermissions.additionalDirectories が回避策として報告されている、ということです。Windows の Write については、パス解決が不安定そうだと報告されていますが、なぜそうなるかまでは分かりません。

もし手元で同じ症状を切り分けるなら、まず対象が SMB マウントや mapped network drive かどうか、そして Read/Bash/Edit と Write のどれだけが落ちるのかを見たほうがよさそうです。逆に、claude doctor で多重インストールの警告が出ているので、環境の混線が気になる場合はそこも確認対象にはなります。ただし、今回の issue からは多重インストールが EPERM の直接原因だとは読めません。


検証環境

claude --version : 2.1.207 (Claude Code)
OS          : Darwin 25.3.0 (arm64)
Python      : 3.14.2
検証日時    : 2026-08-10T12:37:03+09:00

参照した Issue(anthropics/claude-code): #85283, #57540, #57293, #85005

同じ著者の記事