Maintainer of this skill?
Automated security scan — not a certification.
Run Claude Code natively on Android via Termux or AVF (Android Virtualization Framework) -- no desktop, no SSH, no root required.
# Add to your Claude Code skills
git clone https://github.com/ferrumclaudepilgrim/claude-code-androidGuides for using ai agents skills like claude-code-android.
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
}See how claude-code-android compares with popular alternatives.
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 309 GitHub stars.
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.
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).
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.
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.
No comments yet. Be the first to share your thoughts!
From $49 · 30 days · terms & refunds
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
Automated security scan — not a certification.
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:
curl -fsSL https://raw.githubusercontent.com/ferrumclaudepilgrim/claude-code-android/main/install.sh -o install.sh
bash install.sh
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:
claude
Want to read the script before it runs? Open install.sh here, or run less install.sh after the first command.
[!IMPORTANT] Android 8, 9, or 10? Run the same two commands with
install-pinned.shin place ofinstall.sh, or use Path B.
[!TIP] Need a hand? Start with troubleshooting and recovery, or the FAQ for common install questions.
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).
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 DNS resolver at Google's 8.8.8.8 and 8.8.4.4 by default to avoid a known connection hang. Lookups using that resolver go to Google instead of your VPN's or Pi-hole's DNS server; that does not mean they bypass your VPN tunnel. The rest of your phone is unchanged. Why, and how to change it.
Path B gives you a more conventional Linux setup: Ubuntu running inside Termux, with Claude Code installed by Anthropic's own installer and no Path A launcher in between. It is significantly heavier: about 2 GB of storage, and it uses more of your phone's resources, such as memory and storage, while it runs.
Path C is for phones that show Android's Linux development environment option. It runs a real Debian Linux virtual machine built into Android, with no Termux involved. It was tested on Pixel 6 and Pixel 10 Pro running Android 17. There are a few other devices that potentially have it. Here is where you can find out if yours can run AVF.
To check your phone, turn on Developer options and look for Settings → System → Developer options → Linux development environment. No toggle? Use Path A or B.
This project helps you run the Claude Code CLI on an Android device. At its base it is very close to the standard experience. On my S26 Ultra I have run 4+ sessions at once, all doing work on the phone, several ultracode (multi-agent) workflows at the same time, and even compiled C and C++ audio code right on the device.
That last part is why this project exists. Claude Code's voice mode only recorded silence on my Android 16 phone, so I wrote a microphone module for Termux's audio system, built it on the phone, and voice mode worked. That work turned into two pull requests to Termux: microphone input and Google's Oboe audio library, which I first built in C++ on the phone.
With a little tinkering and persistence you can do so much more. Termux already connects Claude Code to a lot of Android once you give it things like file access or the microphone. If that isn't enough, and I'm sure it isn't, which is why you are here, the real integration starts with Termux:API and ADB. Remember, it is an agent, so read the safety section before you give it more access.
A few things I have experimented with:
The point: with the right, and fairly cheap, Android device, anybody can run command-line Claude Code and take it as far as they want.
Start here:
Compatibility comes from real phones, not Android version numbers.
2.1.112) that stays put. Path B works on both.Dates, saved results, and community reports: Device compatibility and evidence. Tested another phone? Send a device report.
Don't skim this, but don't let it cause panic either. Be smart when working with AI agents, especially near sensitive information.
Claude Code is an agent. It reads files, runs commands, and goes online on its own, on a device that holds your photos, messages, and accounts. Anything you let Termux reach, Claude Code can reach too.
What can actually go wrong:
Start safe:
The installer turns none of this on for you. The full picture is in the security model.
troubleshooting.md should be your first stop for any problem. It covers launch crashes, update warnings, the "Checking connectivity" hang, sign-in trouble, 32-bit phones, Ubuntu (Path B) issues, missing tools, PDFs, hooks, and AVF.
Coming back to an older install?