andresgarcia0313
/
claude-code-termux
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
Claude Code CLI setup for Termux/Android - scripts, workarounds and docs
1 Commit 1 Branch 0 Tags 67 KiB
Shell 88.4%
Vim Snippet 11.6%
Go to file
Andrés Eduardo García Márquez 0d5d099dee feat: setup inicial para Claude Code en Termux 
Scripts, configuraciones y documentación para ejecutar Claude Code CLI
en Termux/Android. Incluye wrapper con termux-chroot para /tmp,
actualizador seguro con techo de versión v2.1.112, resolver mDNS
puro en Python y ProxyCommand SSH con fallback Tailscale.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 		2026-04-26 17:30:25 -05:00
bin feat: setup inicial para Claude Code en Termux 2026-04-26 17:30:25 -05:00
config feat: setup inicial para Claude Code en Termux 2026-04-26 17:30:25 -05:00
docs feat: setup inicial para Claude Code en Termux 2026-04-26 17:30:25 -05:00
.gitignore feat: setup inicial para Claude Code en Termux 2026-04-26 17:30:25 -05:00
README.md feat: setup inicial para Claude Code en Termux 2026-04-26 17:30:25 -05:00
install.sh feat: setup inicial para Claude Code en Termux 2026-04-26 17:30:25 -05:00

README.md

Claude Code for Termux

Run Claude Code CLI on Android via Termux.

Why

Claude Code v2.1.113+ switched to native binaries, breaking Termux/Android compatibility. This repo provides:

  • v2.1.112 (last pure Node.js release) with auto-update protection
  • termux-chroot wrapper that fixes the /tmp permission issue
  • mDNS resolver for SSH without hardcoded IPs
  • Safe updater that respects the version ceiling

Requirements

  • Termux (F-Droid recommended)
  • Android 10+ (ARM64)
  • ~500MB free storage
  • An Anthropic API key or Claude subscription

Quick Install

git clone <your-gitea-url>/andres/claude-code-termux.git
cd claude-code-termux
bash install.sh

Or dry-run first:

bash install.sh --dry-run

What Gets Installed

Component Location Purpose
Claude Code v2.1.112 npm global The CLI itself
clauded ~/.local/bin/ Wrapper with termux-chroot for /tmp
claude-check-env ~/.local/bin/ Environment validator
claude-update ~/.local/bin/ Safe updater (ceiling-aware)
mdns-resolve ~/.local/bin/ Pure Python mDNS resolver
ssh-mdns-proxy ~/.local/bin/ SSH ProxyCommand with mDNS+Tailscale
settings.json ~/.claude/ Disables auto-updater

Usage

# Start Claude Code (always use this, not `claude` directly)
clauded

# Check environment
claude-check-env

# Update (safe, respects version ceiling)
claude-update

SSH with Dynamic Resolution

The included ssh-mdns-proxy resolves hostnames via mDNS first, then Tailscale DNS, then cache. See config/ssh_config.example for setup.

# Set your Tailscale domain (optional, has a default)
export TAILSCALE_DOMAIN="your-tailnet.ts.net"

Version Ceiling

v2.1.112 is the last compatible version. Starting v2.1.113, Claude Code ships native binaries requiring glibc/musl linkers that don't exist on Android (Bionic libc).

claude-update enforces this automatically. See docs/TROUBLESHOOTING.md for details.

Troubleshooting

See docs/TROUBLESHOOTING.md for:

  • /tmp permission errors
  • Native binary errors
  • Auto-updater issues
  • SSH resolution problems

License

MIT