claude-code-android

Name: claude-code-android
Author: ferrumclaudepilgrim

Verified

Run Claude Code natively on Android via Termux or AVF (Android Virtualization Framework) -- no desktop, no SSH, no root required.

143stars

22forks

Shell

Installation

# Add to your Claude Code skills
git clone https://github.com/ferrumclaudepilgrim/claude-code-android

Getting Started

Guides for using ai agents skills like claude-code-android.

Caveman: Cut Claude Token Use by 65%
How agent-side prompt compression works, when to use it, and when not to.
What is an AI Skills Marketplace?
Definitions, how marketplaces work, and how to choose between them in 2026.
Getting Started with AI Skills

Security ReportVerified

Last scanned: 6/19/2026

{
  "issues": [
    {
      "file": "README.md",
      "line": 122,
      "type": "remote-install",
      "message": "Install command (remote install script piped to a shell — review the source before running): \"curl -fsSL https://claude.ai/install.sh | bash\"",
      "severity": "low"
    }
  ],
  "status": "PASSED",
  "scannedAt": "2026-06-19T09:05:55.403Z",
  "npmAuditRan": true,
  "pipAuditRan": true,
  "promptInjectionRan": true
}

README.md

Frequently Asked Questions

What is claude-code-android?

claude-code-android is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by ferrumclaudepilgrim. Run Claude Code natively on Android via Termux or AVF (Android Virtualization Framework) -- no desktop, no SSH, no root required. It has 143 GitHub stars.

Is claude-code-android safe to use?

Yes. claude-code-android passed SkillsLLM's automated security scan — a dependency vulnerability audit plus prompt-injection heuristics — with no high-severity issues. You can read the full report in the Security Report section on this page.

How do I install claude-code-android?

Clone the repository with "git clone https://github.com/ferrumclaudepilgrim/claude-code-android" and add it to your Claude Code skills directory (see the Installation section above).

What programming language is claude-code-android written in?

claude-code-android is primarily written in Shell. It is open-source under ferrumclaudepilgrim on GitHub, so you can review or fork the full source.

Are there alternatives to claude-code-android?

Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh claude-code-android against similar tools.

Agentic AI for Beginners

Build your first AI agent from scratch - tool use, ReAct pattern, memory, deployment

41 minBeginner

Comments (0)

to leave a comment.

No comments yet. Be the first to share your thoughts!

Related Skills

superpowers

by obra

An agentic skills framework & software development methodology that works.

234,966

bridgic free-crypto-news

Claude Code on Android

[!WARNING] Claude Code worked before and now crashes on launch? (Bad system call, Segmentation fault, or oh no: Bun has crashed.) Re-run install.sh to get the self-healing launcher; it rolls back to the last version that worked. Full fix: Claude crashes immediately on launch.

[!NOTE] Already on an older pinned install? If you set Path A up with a previous version of this repo (Claude Code 2.1.112, pinned with the auto-updater off), you can move to the current auto-updating architecture without losing your sessions, login, or settings.

See Upgrading from a pinned install for the steps.

Installing fresh instead? Skip ahead to Quick Install.

Before You Start

What you need in place before any command in this guide can succeed:

An aarch64 (64-bit ARM) Android phone, Android 8 or later. Most Android phones from 2018 onward qualify. A few budget Samsung A-series models ship a 32-bit OS on 64-bit hardware and will not work; see the Troubleshooting entry on armv7l / armv8l if uname -m returns those once you have a terminal open.
A Claude account (Pro, Max, Team, Enterprise, or a Console / API account). Claude Code uses your existing Anthropic login.
Termux installed from F-Droid or GitHub. Termux is the terminal-emulator app the install commands below run in. The upstream Termux maintainers recommend F-Droid or their GitHub releases for most users. There is a Google Play build but as of the upstream README it is an experimental branch with missing functionality and bugs, and the upstream project recommends against it for most users. See github.com/termux/termux-app for the full install source breakdown and current caveats from the Termux maintainers themselves.

If you have never used F-Droid or Termux before, the upstream maintainers already cover the install steps better than this repo can:

F-Droid (the open-source Android app store you install as an APK): f-droid.org. The front page has the install instructions and the Play Protect prompt you may see on first launch.
Termux on F-Droid: f-droid.org/en/packages/com.termux/. You can install F-Droid first and then install Termux from inside it, or download the Termux APK directly from that page.
Termux project (background, FAQ, troubleshooting): github.com/termux/termux-app, wiki.termux.com.

Once Termux is open you will see a prompt that looks like ~ $. That is where the commands in Quick Install go. (Long-press to paste, or tap the on-screen Ctrl key then press V.)

Full prerequisites including the Termux:API source-matching rule: docs/install.md#prerequisites.

Quick Install

The repo documents three install paths. Pick one before pasting commands:

Path A (native Termux). The official linux-arm64 claude binary, patched via Termux's glibc-runner (a Termux package that provides a working glibc and dynamic linker so Linux binaries can run on Android's Bionic-based system) to run on Android. A wrapper checks for new versions once per day on launch and updates transparently. About 5-10 minutes to install; the binary alone is ~233 MB, plus ~200 MB if you accept recommended packages.
Path B (proot-Ubuntu). Latest Claude Code installed via Anthropic's official installer inside a full Ubuntu environment. Heavier (~2 GB on disk) but process.platform (the runtime identifier of the host operating system, which some tools branch on) reports linux and standard Linux conventions all apply.
Path C (AVF Linux VM, experimental, Pixel 6+ on Android 16+ only). Real Linux kernel via Android's built-in virtual machine support (the hypervisor). Doesn't use Termux at all.

[!TIP] From the maintainer: Native Termux (Path A) works and is great for those who need it, especially with hardware or storage limitations. I highly recommend running it in proot-Ubuntu (Path B) though: it is the most native way I could get it running since the 2.1.112 regression. Until that changes, it is up to the community to keep Claude Code alive and updating on Termux.

For a side-by-side comparison: docs/install.md#choose-your-path.

Path A: Native Termux

curl -fsSL https://raw.githubusercontent.com/ferrumclaudepilgrim/claude-code-android/main/install.sh -o install.sh
bash install.sh

The installer asks two yes/no questions, then runs unattended. When it finishes, type:

claude

install.sh installs Termux's glibc-runner and patchelf-glibc, downloads the official linux-arm64 claude binary from Anthropic's CDN, verifies the checksum against the published manifest, patches the binary's ELF interpreter (ELF is the Executable and Linkable Format used by Linux binaries; the interpreter is the dynamic linker the kernel invokes to load the binary, and patching it points the binary at the Termux-provided one) so Android can run it, and drops a wrapper at $PREFIX/bin/claude (where $PREFIX is Termux's prefix directory, typically /data/data/com.termux/files/usr) that auto-checks for new claude releases once per day on launch. The wrapper accepts a --update-now flag to force an immediate check; this is a Path A wrapper feature, not a built-in Claude Code flag. Want to read it first? View install.sh on GitHub before running.

Full walkthrough: docs/install.md.

Prefer the smallest, simplest install and do not need current claude? install-pinned.sh pins Claude Code 2.1.112 (the last version with a JS entry point) with no binary patching and no auto-updating wrapper. It stays at that version; install.sh above is the default for current claude.

[!IMPORTANT] Path A runs on a compatibility workaround. Anthropic ships Claude Code as a glibc-linked Linux binary, with no Android build. Termux runs on Android's Bionic C library, so any version past the old pinned 2.1.112 runs here only because install.sh patches the official linux-arm64 binary to load through Termux's glibc-runner. It works and stays current, but it is a shim, not native support.

The real fix is upstream. Anthropic has said they may add Android support, which would need either a bun android-arm64 target or a static musl build. Until that ships, Path A depends on this patching step. Tracked at anthropics/claude-code#50270.

Path B: proot-Ubuntu

Latest Claude Code inside a full Ubuntu environment.

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

This may take a few minutes depending on connection speed.

Upon completion the prompt changes to something like:

root@localhost:~#

That means you are now inside Ubuntu rather than Termux. Inside Ubuntu:

apt update && apt upgrade -y
curl -fsSL https://claude.ai/install.sh | bash
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc && source ~/.bashrc
claude

Full walkthrough: docs/install.md#path-b-proot-distro-ubuntu.

Path C: AVF Linux VM (Pixel 6+ with Android 16+, experimental)

Real Linux kernel via the Android Virtualization Framework. No Termux involved.

On the phone, open Settings > System > Developer options and toggle Linux development environment on. If Developer options is not visible, enable it first: Settings > About phone > tap Build number 7 times. (You only have to do this once per phone.) If the Linux development environment toggle still does not appear after enabling Developer options, your device does not support this path.

Open the Terminal app that appears on the home screen. Accept the prompt to download the Debian image. When the prompt shows droid@debian:~$, install Claude Code inside the VM:

cur