【2026年6月】Claude CodeがTermuxで動かない原因と対処法（2.1.185確認）

2026年6月現在、AndroidのTermux環境でClaude Codeを最新版へアップデートすると、正常に起動できなくなる場合があります。

私も実際に遭遇し、npm設定やインストール方法の問題かと思って調査したのですが、原因は別のところにありました。

この記事では、発生した事象、原因、そして現時点で最も簡単な回避方法をまとめます。

発生した事象

通常どおりインストールします。

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

インストール自体は成功します。

しかし起動すると以下のエラーになります。

claude -v

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

一見すると、

npmの設定がおかしい
postinstallが実行されていない
allow-scriptsが必要
optionalDependenciesの取得に失敗した

などの問題に見えます。

しかし実際には別の原因でした。

最初に疑ったこと

allow-scriptsを有効化する

npm install -g \
  --allow-scripts=@anthropic-ai/claude-code \
  @anthropic-ai/claude-code

改善しませんでした。

npm設定を確認する

npm config get omit
npm config get ignore-scripts
npm config get optional

私の環境では特に問題はありませんでした。

install.cjsを手動実行する

node /data/data/com.termux/files/usr/lib/node_modules/@anthropic-ai/claude-code/install.cjs

すると以下のメッセージが表示されました。

Native binaries for linux-arm64-android are not available on this release channel.

またはバージョンによって、

Unsupported platform: android arm64

と表示されます。

ここでようやく原因が見えてきます。

原因

Claude Codeはv2.1.113以降で内部実装が変更され、ネイティブバイナリ方式へ移行しました。

その結果、Termux(Android)ではAndroid向けネイティブバイナリの配布状況に依存するようになりました。

2026年6月時点の最新版（2.1.185）を確認したところ、optionalDependenciesにはAndroid向けバイナリが含まれていませんでした。

利用可能なプラットフォームは以下のようになっています。

darwin-arm64
darwin-x64
linux-x64
linux-arm64
linux-x64-musl
linux-arm64-musl
win32-x64
win32-arm64

一方でTermuxは、

android arm64

または

linux-arm64-android

として判定されます。

そのためAndroid向けバイナリが見つからず、起動できなくなります。

解決方法

現時点で私の環境で動作確認できたのは 2.1.112 です。

まず最新版を削除します。

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

次に2.1.112をインストールします。

npm install -g @anthropic-ai/claude-code@2.1.112

確認します。

claude -v

正常にバージョンが表示されれば成功です。

私の環境ではこれで復旧しました。

確認したバージョン

以下のバージョンで調査を行いました。

バージョン	結果
2.1.185	起動不可
2.1.183	起動不可
2.1.170	起動不可
2.1.120	起動不可
2.1.112	動作確認

起動不可だったバージョンでは、いずれもAndroid向けバイナリが見つからない旨のエラーが発生しました。

今後アップデートしてはいけないのか？

「絶対にアップデートしてはいけない」というわけではありません。

ただし、2026年6月時点ではTermux利用者にとって2.1.112が最も安定しています。

最新版へ更新すると再び起動できなくなる可能性があります。

そのため当面は、

npm install -g @anthropic-ai/claude-code@2.1.112

のようにバージョンを固定して利用することをおすすめします。

バックアップを取っておく

念のため、現在動作している状態をバックアップしておくと安心です。

mkdir -p ~/backup

cp -r \
/data/data/com.termux/files/usr/lib/node_modules/@anthropic-ai/claude-code \
~/backup/claude-code-2.1.112

最新版を使いたい場合

1. 公式対応を待つ

将来的にAndroid向けネイティブバイナリが提供されれば、最新版がそのまま利用できるようになる可能性があります。

2. proot-distroでUbuntuを利用する

pkg install proot-distro

proot-distro install ubuntu

proot-distro login ubuntu

Ubuntu環境内でClaude Codeを実行する方法です。

ただし、環境によっては動作が重くなる場合があります。

3. ベータ版や別リリースチャンネルを試す

将来的にベータ版や別チャンネルでAndroid向けバイナリが配布される可能性があります。

ただし、執筆時点では未確認です。

4. コミュニティ製の回避策を利用する

既にTermux向けのラッパーや回避策を試みているコミュニティプロジェクトも存在します。

ただし、公式サポートではないため、利用時は自己責任となります。

2026年6月追記

その後、最新版の2.1.185でも調査を行いました。

optionalDependenciesを確認したところ、Android向けの linux-arm64-android バイナリは含まれていませんでした。

そのため、

Unsupported platform: android arm64

または

Native binaries for linux-arm64-android are not available

というエラーが発生し、Termux上で新規起動できませんでした。

少なくとも2026年6月時点では、2.1.112を利用する方法が最も安定しています。

まとめ

2026年6月現在、Claude Codeはv2.1.113以降でネイティブバイナリ方式へ移行したため、Termux(Android)ではAndroid向けバイナリの配布状況に依存するようになっています。

最新版で以下のエラーが表示された場合、

Error: claude native binary not installed.

npm設定やallow-scriptsを疑う前に、

node /data/data/com.termux/files/usr/lib/node_modules/@anthropic-ai/claude-code/install.cjs

を実行してみてください。

もし、

Unsupported platform: android arm64

または

Native binaries for linux-arm64-android are not available

と表示されるなら、原因はnpm設定ではなくAndroid向けバイナリが配布されていないことです。

2026年6月時点では、

npm install -g @anthropic-ai/claude-code@2.1.112

へ固定するのが、TermuxでClaude Codeを利用する最も簡単で安定した方法でした。