Claude Code Android
Run Claude Code Android natively on Android via Termux or AVF (Android Virtualization Framework) -- no desktop, no SSH, no root required.
Last verified:
What is Claude Code Android?
Claude Code Android on Android is an open-source project that enables running Claude Code Android natively on Android devices via Termux or Android Virtualization Framework (AVF). It allows users to run Anthropic's AI coding assistant directly on their Android phone without needing a desktop computer, SSH connection, or root access. The tool reads files, writes code, runs commands, and manages projects through terminal-based conversation.
Claude Code Android pricing
Pricing model: Freemium
Free and open-source under MIT license. No paid tiers or subscriptions. The only costs are your existing Claude account (Pro, Max, Team, Enterprise, or Console/API) which you use for Claude Code access, and device storage (~233 MB for Path A binary + ~200 MB recommended packages, or ~2 GB for Path B proot-Ubuntu). The install scripts and auto-updater are completely free.
Claude Code Android pros
- No root required for installation
- No desktop computer needed
- No SSH or cloud VM required
- Works on Android 8 or later (aarch64)
- Auto-updating wrapper checks for new versions daily
- Three installation paths for different needs
- Full device control via ADB wireless self-connect
- Supports MCP remote HTTP and local stdio transports
- Compatible with Google Pixel 6, Pixel 10 Pro, Samsung S26 Ultra
- MIT license - open source and free
- Preserves sessions, login, and settings during migration
- Interactive install script with user-friendly prompts
- Built-in SSRF guard blocking private/reserved IPs
- Biometric approval gate using termux-fingerprint
- Works with voice mode via SoX and PulseAudio
Claude Code Android cons
- Only works on 64-bit ARM (aarch64) devices, not 32-bit
- Path A uses compatibility shim, not native Android support
- Google Play Termux build has bugs and missing functionality
- Binary download is ~233 MB plus ~200 MB for recommended packages
- Path B uses ~2 GB disk space in proot-Ubuntu
- Path C (AVF) only works on Pixel 6+ with Android 16+
- Voice mode may break on some vendor builds at OpenSL ES backend
- OAuth-based MCP servers have varying reliability by path
- PDF reading requires a which shim workaround
- No official Android-arm64 target from Anthropic yet
Frequently asked questions about Claude Code Android
What Android devices are compatible with Claude Code on Android?
You need an aarch64 (64-bit ARM) Android phone running Android 8 or later. Most Android phones from 2018 onward qualify, but some budget Samsung A-series models ship with a 32-bit OS on 64-bit hardware and won't work. Verified devices include Google Pixel 10 Pro (Android 17), Google Pixel 6 (Android 17), Samsung Galaxy S26 Ultra (Android 16), Samsung Galaxy S23+ (Android 15), Motorola Moto G7 Power (Android 10), and Samsung Galaxy S7 (Android 8.0.0).
What are the three installation paths and which should I choose?
Path A (native Termux) uses the official linux-arm64 Claude binary patched via Termux's glibc-runner, takes 5-10 minutes, and is ~233 MB. Path B (proot-Ubuntu) installs Claude Code inside a full Ubuntu environment, is heavier at ~2 GB but reports 'linux' as the platform. Path C (AVF Linux VM) uses Android's built-in hypervisor for a real Linux kernel without Termux, but only works on Pixel 6+ with Android 16+. The maintainer recommends Path B as the most native option until Anthropic adds official Android support.
Do I need to root my Android device?
No root is required. The project explicitly works without root, without an emulator, and without a cloud VM. All three installation paths (native Termux, proot-Ubuntu, and AVF Linux VM) function on unrooted devices.
Where should I download Termux from?
Download Termux from F-Droid or GitHub releases. The F-Droid version is at f-droid.org/en/packages/com.termux/. The Google Play Store build is an experimental branch with missing functionality and bugs, and the upstream Termux project recommends against it for most users.
What Claude account types work with this tool?
You need an existing Claude account: Pro, Max, Team, Enterprise, or a Console/API account. Claude Code uses your existing Anthropic login regardless of account type.
How does auto-updating work in Path A?
The Path A wrapper checks for new Claude Code versions once per day on launch and updates transparently. You can also force an immediate check with the --update-now flag, which is a Path A wrapper feature (not a built-in Claude Code flag). The installer verifies the checksum against Anthropic's published manifest before downloading the official linux-arm64 binary from their CDN.
Can I upgrade from a pinned install to the auto-updating version?
Yes. If you have an older pinned install (Claude Code 2.1.112 with auto-updater off), you can use migrate.sh to upgrade to the current auto-updating architecture without losing your sessions, login, or settings. The script preserves all your existing configuration.
What happens if my device shows armv7l or armv8l instead of aarch64?
Your device only runs 32-bit ARM and Claude Code/Node.js require 64-bit. The device will not be compatible. Check your device with uname -m in Termux - if it returns armv7l or armv8l, you need a different phone with a 64-bit ARM processor.
Does voice mode work on all Android devices?
Voice mode works through a SoX → PulseAudio → backend chain, but some vendor builds break at the OpenSL ES backend (the Android audio API PulseAudio uses to reach the device speaker on older Android versions). You should test voice mode on your specific device before relying on it. Mic input support is still in development.
What security features are built into this project?
The project includes an SSRF guard that blocks private/reserved IP addresses for web fetch safety, a biometric approval gate using termux-fingerprint, a security model documenting Termux:API permissions and ADB escalation mitigations, and an agent-permissions matrix preventing agents from having both web and write permissions simultaneously. ADB wireless self-connect allows pairing the phone to itself for system-level capabilities with proper security controls.