Running Claude Code on Android via proot-distro

Anthropic doesn't officially support Android, but it still runs through an Ubuntu layer inside Termux.

1 min read

Anthropic doesn’t support Android. But it still runs, through an Ubuntu layer in proot.

The problem

Claude Code is a linux-arm64 binary dynamically linked against glibc. Termux runs on Android’s bionic libc. Installing directly with npm gives this error:

Unsupported platform: android arm64

The workaround: build an Ubuntu rootfs inside Termux with proot-distro, which has a real glibc, then install Claude Code in there.

Requirements

  • An aarch64 device, Android 8+ - check with uname -m
  • Termux installed from F-Droid (the Play Store version is no longer updated)
  • ~2GB of free space

Install

In Termux:

pkg update -y && pkg upgrade -y
pkg install proot-distro -y
proot-distro install ubuntu
proot-distro login ubuntu

In Ubuntu:

apt update && apt install -y curl git
curl -fsSL https://deb.nodesource.com/setup_20.x | bash -
apt install -y nodejs
npm install -g @anthropic-ai/claude-code
claude

The first time you run claude, it opens a browser login flow. Use your existing Claude account, no API key needed.

A handy alias

Add this to Termux’s ~/.bashrc, not Ubuntu’s:

alias claude='proot-distro login ubuntu -- bash -lc "claude"'

From then on, just type claude.

Limitations

This is a workaround, not an officially supported solution.