Skip to content

v1.0.0 — First Stable Release

Choose a tag to compare

View all tags
@ferrumclaudepilgrim ferrumclaudepilgrim released this 19 Mar 15:18
· 80 commits to main since this release
v1.0.0
1728ed5

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 | bash

What'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:

  • /tmp not 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.

Assets 2
Loading