claude-code-android

Claude Code on Android

  Native, on-device Claude Code for your Android phone. No root, no cloud VM.

  Install · Paths · What it does · Devices · Security · Fix

Quick Install

Before you start: you need Termux from F-Droid or GitHub (not Google Play), a 64-bit phone (once Termux is open, uname -m should print aarch64), and a Claude subscription or Console/API account. Full list: prerequisites.

Open Termux and run:

It asks two quick yes/no questions, then runs on its own. When it finishes, open a new Termux session (or close and reopen Termux) and run:

Want to read the script before it runs? Open install.sh here, or run less install.sh after the first command.

Android 8, 9, or 10? Run the same two commands with install-pinned.sh in place of install.sh, or use Path B.

Need a hand? Start with troubleshooting and recovery, or the FAQ for common install questions.

Choose an Install Path

Path A: Native Termux

Path A is the quickest and lightest way to run Claude Code on your phone. Install time depends on your network; expect about 5 to 10 minutes on a good connection.

"Native" means it runs on your phone, not on a remote machine. Anthropic doesn't publish an Android version, so Path A runs their official Linux version through a small Termux compatibility layer that this repo sets up and keeps updated (upstream issue).

How updates work, and the DNS tradeoff

The claude command this repo installs (the launcher) checks for a new Claude Code once a day. It checks new versions for startup crashes, keeps a previous one as a backup when available, and tries saved versions if a startup check detects a crash. It cannot recover without a usable saved version or catch every failure during use. To check right away, run claude --update-now.

Path A also points Claude Code's…