Created & maintained / open source
claude-code-
android
Your phone. A working development environment.
Run Claude Code’s command-line tools directly on your Android device. No rooting or SSH into another computer required. Work with files, run commands and develop projects from your phone. If you want to go further, ADB (Android’s debugging tool) and Termux:API give you more ways to work with the device, including its sensors.
For the people who
want to try it.
My phone is the computer I actually have with me. If that is true for you too, or you work away from a desk, or you just like taking Android apart, this is a documented way into the terminal workflow on the phone itself.
I maintain the setup, migration and recovery scripts, explain the tradeoffs, and test across real hardware. The goal is a useful project someone else can follow, not just proof that I got it running once.
One project / three paths
Fit the setup
to the device.
You’ll need a compatible ARM64 (64-bit ARM) Android phone and a Claude subscription that includes Claude Code or supported API access. Android 8 is the minimum. Check the path-specific requirements below.
Native Termux
The current Linux ARM64 binary, adapted with Termux’s glibc tools. A wrapper normally checks for updates once a day when you launch it.
A compatibility workaround, not an official Android build. Android 8/10 devices in the test matrix use the older pinned build instead, an earlier version kept because it still works on them.
Path A sends Claude Code’s own DNS lookups to Google’s public resolvers on each launch. Paths B and C do not use this override.
Ubuntu through proot
A fuller Ubuntu environment inside Termux, using Anthropic’s official installer. More storage and setup, with familiar Linux conventions.
Useful when you prefer this environment over the patched-binary wrapper.
Android’s Linux VM
A real Linux kernel through Android Virtualization Framework. No Termux required. Documented for supported Pixel 6-or-newer devices on Android 16 or later.
Hardware support is narrower. Check the current guide before choosing this route.
Hardware matters.
So do the caveats.
The published compatibility matrix spans Android 8 through 17. I try my best to not say “works on Android” as I know there is a legitimate difference between a Pixel 10 Pro, Samsung S7, and a Huawei phone. I have my 4 phones I use across multiple generations but can’t cover every edge case.
This is where the device matrix comes from. The community helps me and others learn which devices work, and figure out what to try when they don’t.
Device matrix and test artifacts ↗Ready to try it?
Start with the guide.
The current guide covers device requirements, optional permissions and setup for each path.
Not affiliated with or endorsed by Anthropic. Built on Anthropic’s Claude Code, Termux, glibc-runner/patchelf-glibc, and the earlier patched-binary work by claude-code-termux.