Claude Code on Android — v1.0.0
The first stable release of the only dedicated guide for running Claude Code natively on Android.
One-Command Install
curl -fsSL https://raw.githubusercontent.com/ferrumclaudepilgrim/claude-code-android/main/install.sh | bashWhat's Included
- Two installation paths: Native Termux (Path A, ~2 min) and proot-distro Ubuntu (Path B, ~15 min)
- One-command installer that handles packages, Claude Code, ripgrep fix, and shell config
- Three Android-specific skills:
/doctor(environment diagnostic),/fix-ripgrep(Grep/Glob fix),termux-safe(auto-loaded constraints) - Complete troubleshooting reference with 13+ entries covering every known failure mode
- CLAUDE.md constitution template for giving Claude Code persistent rules on Android
Verified Configuration
| Component | Version |
|---|---|
| Device | Samsung Galaxy S26 Ultra |
| Android | 16 |
| Kernel | 6.12.30 (aarch64) |
| Node.js | v25.8.1 |
| proot | 5.1.107-70 |
| Claude Code | 2.1.79 |
What This Solves
Four upstream bugs that have no official fix:
/tmpnot writable (hardcoded in Claude Code)- Node.js v24 hangs on ARM64
- TMPDIR not set causes silent npm failures
- Missing arm64-android ripgrep binary breaks Grep/Glob tools
No root. No emulator. No cloud VM. Just a phone.