# Claude Code for Termux

Run [Claude Code](https://claude.ai/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](https://f-droid.org/en/packages/com.termux/) (F-Droid recommended)
- Android 10+ (ARM64)
- ~500MB free storage
- An Anthropic API key or Claude subscription

## Quick Install

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

Or dry-run first:
```bash
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

```bash
# 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.

```bash
# 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](docs/TROUBLESHOOTING.md) for:
- `/tmp` permission errors
- Native binary errors
- Auto-updater issues
- SSH resolution problems

## License

MIT