PaPoo
cover

claude native binary not installed. が出るときに見るところ

このエラーは、少なくとも今回の 2 件の issue では、claude を起動したときに「native binary が見つからない」と言われる症状でした。ひとつは npm i @anthropic-ai/claude-code@2.1.126 の直後に claude を実行して発生し、もうひとつは自動更新が成功扱いになったあと、次の起動で同じエラーになっています。参照した issue は #57577#85974 です。

手元で確認した環境でも、claude doctor はインストール状態に少し気になる点を出しています。native で動いている一方で、npm-global の残骸も見えていました。

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

実際に which -a claude でも、claude が複数箇所にあることを確認できました。

$ /usr/bin/which -a claude
~/.local/bin/claude
/usr/local/bin/claude
/usr/local/bin/claude

この時点で言えるのは、少なくとも「claude の実体が一つではない」ことです。issue 側でも、npm-global や postinstall の失敗、あるいは更新後に stub が残ったまま、という文脈で起きています。#57577 ではエラーメッセージ自体が、原因候補として次の 2 つを挙げています。

Error: claude native binary not installed.

Either postinstall did not run (--ignore-scripts, some pnpm configs)
or the platform-native optional dependency was not downloaded
(--omit=optional).

Run the postinstall manually (adjust path for local vs global install):
  node node_modules/@anthropic-ai/claude-code/install.cjs

Or reinstall without --ignore-scripts / --omit=optional.

つまり、少なくとも issue 報告の範囲では、claude native binary not installed. は「インストール手順のどこかで native binary が入らなかった」ことを示すエラーです。postinstall が走っていない、あるいは optional dependency が入っていない、という説明以上のことは、今回の材料だけでは断定できません。

#85974 では、更新処理が success と記録されたあとに次の起動で失敗していました。報告にあるログはこうです。

// ~/.claude/.last-update-result.json
{"timestamp":"2026-08-12T01:39:53.609Z","path":"npm-global","outcome":"success",
 "status":"success","version_from":"2.1.222","version_to":"2.1.228","error_code":null}

これでも次回起動時には、

Error: claude native binary not installed.

になっています。なので、更新が「成功」と出ていても、中身が正常とは限らないケースがある、というのがこの issue から読み取れる範囲です。少なくともこの症状だけを見て「更新成功だから問題なし」とは判断できません。

切り分けとしては、まず自分の claude がどこを指しているかを見るのが早いです。claude doctor で複数インストールが出るか、which -a claudenpm-globalnative が混在していないかを確認します。今回の手元環境では、/usr/local/bin/claude が残っていると明示されました。claude doctor の警告にある通り、これが残っている状態は少なくとも望ましくありません。

一方で、ここから先の復旧手順は、今回の一次情報だけでは踏み込みすぎないほうが安全です。#57577 の本文には npm -g uninstall @anthropic-ai/claude-code という指示が出ていますが、これは「Leftover npm global installation」に対する doctor の案内です。自分の環境で同じ警告が出ているなら、その案内に従う根拠はあります。ただし、実際にそれで今回の症状が直るかどうかまでは、この記録だけでは確認できていません。

現時点で確実に言えるのは次の三つです。
claude native binary not installed. は、claude 起動時に native binary が欠けているときに出る。
claude doctor で複数インストールが見つかる場合がある。
自動更新が success でも、次回起動でこのエラーに落ちることがある。

もし同じ症状に当たったら、まず claude doctorwhich -a claude の結果を見比べるのがよさそうです。そこで npm-global の残りや native との混在が出るなら、この issue 群とかなり近いケースだと思われます。


検証環境

claude --version : 2.1.207 (Claude Code)
OS          : Darwin 25.3.0 (arm64)
Python      : 3.14.2
検証日時    : 2026-08-19T02:00:41+09:00

参照した Issue(anthropics/claude-code): #85974, #57577

同じ著者の記事