【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を利用する最も簡単で安定した方法でした。