PaPoo
cover

exit code 3 が出るときにまず見る場所

Claude Code process exited with code 3 が出ても、すべてが同じ原因とは限りません。少なくとも今回集めた issue では、Windows 側で常駐している Windhawk が関わるケースと、Hyper-V の仮想マシン内で Claude Code のバイナリが落ちるケースが別々に報告されています。

自分の症状がどちらに近いか、先に分けるのがよさそうです。
ターミナルでは動くのにデスクトップアプリ側だけで落ちるなら、#52386 の報告とかなり似ています。報告者は「昨日までは動いていたが、今日は毎回 Claude Code process exited with code 3 になる」「terminal では引き続き動く」と書いています。さらに Windhawk を終了すると直るとも述べています。

一方で、Windows の Cowork 経由で、VM の起動自体は成功するのに Claude Code の binary が始まった瞬間に落ちる、という報告が #87060 にあります。こちらは Illegal instructionexit code 3 が並んでいて、少なくとも報告本文では「Claude Code binary starts inside the guest」でクラッシュするとされています。

手元で確認できた範囲では、Mac 上の claude doctor は次の状態でした。exit code 3 そのものの再現ではなく、インストール構成の確認です。

$ 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.

この出力から言えるのは、少なくとも筆者の環境では native 版 2.1.207 が動いていて、複数インストールが見つかっていることです。exit code 3 の原因がこれだとまでは分かりません。分かるのは、インストールの重複は別途整理したほうがよさそう、ということだけです。

Windhawk が絡むケースでは、代表 issue のコメントに「Windhawk 側の exclusion に claude.exe を追加したら動いた」とあります。ただし同じコメントで「Windhawk と claude の両方を再起動するとよいかもしれない」とも書かれていて、再現条件は限定的です。issue 本文では、すでに Claude.exe を Windhawk の process exclusion list に入れても効かなかったと報告されています。つまり、少なくともその人の環境では、単純に 1 回除外リストへ入れるだけでは足りなかったことになります。

この2件を並べると、今のところは次の切り分けが実用的です。
ターミナルでは動くが、Windows のデスクトップアプリや周辺常駐ツールを介した起動だけ失敗するなら、Windhawk の影響を疑う。
Windows の VM 内で、起動直後に Illegal instruction とともに落ちるなら、#87060 のように、実行環境側の CPU 命令セット露出の問題が絡んでいる可能性がある。
ただし後者は issue が open のままで、ここから先の確定的な対処は本文だけでは言えません。

現時点で、報告と実測から無理なく書ける範囲の対応はこれだけです。Windhawk を使っているなら、Windhawk 側の除外設定を見直し、必要なら Windhawk と Claude Code の両方を再起動する。複数インストールが出ているなら、claude doctor の warning に従って残っている古い npm global を整理する。これで直るとは断言できませんが、少なくとも「どの層で落ちているか」を狭める材料にはなります。


検証環境

claude --version : 2.1.207 (Claude Code)
OS          : Darwin 25.3.0 (arm64)
Python      : 3.14.2
検証日時    : 2026-08-16T14:06:43+09:00

参照した Issue(anthropics/claude-code): #87060, #52386

同じ著者の記事