🚀 v1.0.0 — Native Claude Code on Termux

[AbdulRahmanMMuhammad]

🚀 Termux Claude Code Installer v1.0.0

🔥 Run Claude Code natively on Termux — 100% WORKING, 0% PROOT, one command and you're in! 🚀

---

🎉 First stable release!

This is the initial public release of the Termux Claude Code Installer — a permanent, system-level installer that makes claude work natively on Android's Termux without proot, chroot, or patchelf.

---

⚡ Install in 10 seconds

curl -fsSL https://raw.githubusercontent.com/Ryovx/Termux-Claude-Code/main/install.sh | bash

Then run:

claude

That's it. 🎯

---

✨ What's included

🚀 Core

• Native execution — Runs the official linux-arm64-musl binary published by Anthropic
• No proot, no chroot — No containers, no VMs, no emulation
• No patchelf — Deliberately avoids the SIGSEGV that happens when you patch musl binaries on Android kernels
• One-command install — Copy, paste, done
• Zero rc-file changes — Never touches ~/.bashrc or ~/.zshrc

🔧 Tools

Command	Description
claude	Run Claude Code (interactive session)
claude-update	Smart updater — skips download if already latest
claude-fix	Self-healing launcher restoration
claude-uninstall	Clean removal of every artifact

📦 What gets installed

Path	Purpose
$PREFIX/bin/claude	Launcher (6 lines of bash)
$PREFIX/bin/claude-fix	Restores launcher from template
$PREFIX/bin/claude-update	Updates to latest npm release
$PREFIX/bin/claude-uninstall	Removes everything
$PREFIX/lib/claude-musl/	Alpine's musl loader + libraries
$PREFIX/lib/node_modules/@anthropic-ai/claude-code-linux-arm64-musl/claude	The official 280 MB binary

Nothing is written outside $PREFIX.

---

📋 Requirements

Requirement	Details
Termux	From F-Droid or GitHub Releases — NOT Play Store
Architecture	aarch64 (ARM64) only
Free space	~700 MB
Internet	Required during install and update
Root	❌ Not required

---

📖 Documentation

Full documentation in three languages:

Language	README	Contributing	Security	Support	Code of Conduct
🇬🇧 English	README.md	CONTRIBUTING.md	SECURITY.md	SUPPORT.md	CODE_OF_CONDUCT.md
🇸🇦 العربية	README.ar.md	CONTRIBUTING.ar.md	SECURITY.ar.md	SUPPORT.ar.md	CODE_OF_CONDUCT.ar.md
🇨🇳 中文	README.zh.md	CONTRIBUTING.zh.md	SECURITY.zh.md	SUPPORT.zh.md	CODE_OF_CONDUCT.zh.md

---

🔧 How it works (short version)

Claude Code ships a linux-arm64-musl ELF binary. Termux runs on Android's Bionic libc, not musl. Direct execution fails with cannot execute: required file not found because the binary requests /lib/ld-musl-aarch64.so.1.

What doesn't work:

• ❌ patchelf → SIGSEGV on Android kernels
• ❌ proot / chroot → slow, breaks claude's bash tool
• ❌ npm wrapper claude-code-termux → broken with Claude Code ≥ 2.1.x

What does work (this project):

1. Download Alpine's musl loader + .so files into $PREFIX/lib/claude-musl/
2. Download the official linux-arm64-musl binary from npm
3. Create a 6-line launcher that unsets LD_PRELOAD, invokes the musl loader with --library-path, and execs the real binary

No patchelf, no proot, no chroot, no magic.

---

🐛 Known limitations

• ❌ x86_64 and armv7 not supported (only aarch64)
• ❌ Play Store Termux not supported (use F-Droid or GitHub Releases)
• ⚠️ OAuth login may be unreliable on some Termux setups — use API key instead:

export ANTHROPIC_API_KEY=sk-ant-...
claude

---

📜 License

Licensed under the GNU General Public License v3.0 or later (SPDX: GPL-3.0-or-later). See LICENSE for full text.

🤝 Open Innovation Network (OIN)

Ryovx is a proud member of the Open Innovation Network (OIN). In line with OIN's mission and our commitment to the Termux community, most of Ryovx's service products are released under GNU GPLv3.

💚 Ethical Request — Not a Legal Restriction

Just as we provide this tool completely free of charge, we kindly ask that you do the same: please keep it free.

This is a friendly request, not a legal prohibition. Under GPLv3, you retain the full right to redistribute this software, including commercially. We simply hope you'll choose to honor the spirit in which it was shared.

---

🙏 Full Changelog

Initial release — no previous version to compare against.

See CHANGELOG.md for the complete changelog.

---

Built with ❤️ for the Termux community

⭐ If this project saved you hours of head-scratching, consider starring the repo ⭐

Not affiliated with Anthropic. Claude Code is a trademark of Anthropic, PBC.

---

This discussion was created from the release 🚀 v1.0.0 — Native Claude Code on Termux.