claude-code-native-termux
v0.1.2
Published
Install Claude Code natively on Termux (Android) — no proot, no containers. Official claude-code binaries bridged to Termux's native glibc.
Maintainers
Readme
Requirements
- Termux from F-Droid (Play Store builds are outdated)
- aarch64 (ARM64) device — the only architecture Claude Code ships a Linux build for
- An internet connection for the ~100 MB download
Installation
One line — zero prerequisites:
curl -fsSL https://raw.githubusercontent.com/rexroze/claude-code-termux/main/install.sh | shOr via npm (needs nodejs first):
pkg install nodejs-lts
npm i -g claude-code-native-termux[!TIP]
claudeis on your PATH immediately — the first run downloads the official binary (~100 MB), verifies its sha256 checksum, and configures your shell (bash, zsh, or fish).
Usage
claudeFirst run asks you to log in (/login inside the TUI, or claude
--login). Then just start typing.
Updating
Updates are manual by design — the built-in auto-updater is disabled
(DISABLE_AUTOUPDATER=1), because claude's updater would overwrite the
glibc-bridged binary with a bionic-incompatible build and break the install.
When a new Claude Code version ships, re-run the installer:
sh install.sh # or the curl one-liner again — always fetches latestPin a specific version with sh install.sh -v v2.1.237. claude update
and /update are intentionally unavailable.
How it works
Claude Code ships as a native glibc binary since v2.1.113; Termux runs on
bionic. This project bridges the two with Termux's native glibc package —
official upstream binaries, nothing patched, nothing emulated. The launcher
runs the binary through a loader symlink named claude, so agent runtimes
(herdr, ...) that identify agents by kernel process name see claude — not
a glibc loader. It also sets DISABLE_AUTOUPDATER=1 (claude's in-process
updater would overwrite the bridged binary with a bionic-incompatible one)
and points SHELL at Termux's bash, since Android has no /bin/bash. Full
technical deep dive: docs/HOW-IT-WORKS.md.
Links
- docs/FAQ.md — shell setup, upgrading, troubleshooting
- docs/HOW-IT-WORKS.md — technical deep dive
- claude-code — upstream project
- LICENSE
