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>
This commit is contained in:
Andrés Eduardo García Márquez
commit
0d5d099dee
|
|
@ -0,0 +1,3 @@
|
|||
*.bak
|
||||
*.tmp
|
||||
.DS_Store
|
||||
|
|
@ -0,0 +1,84 @@
|
|||
# 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
|
||||
|
|
@ -0,0 +1,76 @@
|
|||
#!/usr/bin/env bash
|
||||
#
|
||||
# claude-check-env: Verify Claude Code environment on Termux
|
||||
#
|
||||
|
||||
RED="\033[0;31m"
|
||||
GREEN="\033[0;32m"
|
||||
YELLOW="\033[1;33m"
|
||||
CYAN="\033[0;36m"
|
||||
NC="\033[0m"
|
||||
|
||||
echo -e "${CYAN}=== Claude Code - Environment Check ===${NC}"
|
||||
echo ""
|
||||
|
||||
# 1. Claude version
|
||||
CLAUDE_VER=$(claude --version 2>/dev/null | grep -oE "[0-9]+\.[0-9]+\.[0-9]+" | head -1)
|
||||
if [[ -n "$CLAUDE_VER" ]]; then
|
||||
echo -e "${GREEN}[OK]${NC} Claude Code: v$CLAUDE_VER"
|
||||
else
|
||||
echo -e "${RED}[ERROR]${NC} Claude Code not installed"
|
||||
fi
|
||||
|
||||
# 2. Node.js
|
||||
NODE_VER=$(node --version 2>/dev/null)
|
||||
if [[ -n "$NODE_VER" ]]; then
|
||||
echo -e "${GREEN}[OK]${NC} Node.js: $NODE_VER"
|
||||
else
|
||||
echo -e "${RED}[ERROR]${NC} Node.js not installed"
|
||||
fi
|
||||
|
||||
# 3. proot/termux-chroot
|
||||
if command -v termux-chroot &>/dev/null; then
|
||||
echo -e "${GREEN}[OK]${NC} termux-chroot available"
|
||||
else
|
||||
echo -e "${RED}[ERROR]${NC} termux-chroot not available (pkg install proot)"
|
||||
fi
|
||||
|
||||
# 4. Sharp WASM (image support)
|
||||
SHARP_WASM=$(npm list -g @img/sharp-wasm32 2>/dev/null | grep sharp-wasm32)
|
||||
if [[ -n "$SHARP_WASM" ]]; then
|
||||
echo -e "${GREEN}[OK]${NC} Sharp WASM: installed (image support)"
|
||||
else
|
||||
echo -e "${YELLOW}[WARN]${NC} Sharp WASM not installed (no image support)"
|
||||
echo " Install: npm install -g @img/sharp-wasm32 sharp --force"
|
||||
fi
|
||||
|
||||
# 5. Credentials
|
||||
if [[ -f ~/.claude/.credentials.json ]]; then
|
||||
echo -e "${GREEN}[OK]${NC} Credentials: configured"
|
||||
else
|
||||
echo -e "${RED}[ERROR]${NC} No credentials (run: claude auth)"
|
||||
fi
|
||||
|
||||
# 6. TMPDIR
|
||||
echo -e "${GREEN}[OK]${NC} TMPDIR: ${TMPDIR:-not set}"
|
||||
|
||||
# 7. Tailscale (generic check via interface)
|
||||
if ip link show tailscale0 &>/dev/null 2>&1; then
|
||||
echo -e "${GREEN}[OK]${NC} Tailscale: connected"
|
||||
else
|
||||
echo -e "${YELLOW}[WARN]${NC} Tailscale: not connected"
|
||||
fi
|
||||
|
||||
# 8. Disk space
|
||||
SPACE=$(df -h "$PREFIX" 2>/dev/null | tail -1 | awk '{print $4}')
|
||||
echo -e "${GREEN}[OK]${NC} Free space: $SPACE"
|
||||
|
||||
echo ""
|
||||
echo -e "${CYAN}=== Available Commands ===${NC}"
|
||||
echo " clauded - Start Claude (interactive mode)"
|
||||
echo " claude-update - Update Claude Code (safe)"
|
||||
echo " claude-check-env - This check"
|
||||
echo ""
|
||||
echo -e "${CYAN}=== Known Limitations ===${NC}"
|
||||
echo " - Background tasks may fail (use termux-chroot via clauded)"
|
||||
echo " - Version ceiling: v2.1.112 (last pure Node.js release)"
|
||||
|
|
@ -0,0 +1,68 @@
|
|||
#!/usr/bin/env bash
|
||||
#
|
||||
# claude-update: Safe updater for Claude Code on Termux
|
||||
# Respects version ceiling (v2.1.112 = last pure Node.js release)
|
||||
#
|
||||
|
||||
set -e
|
||||
|
||||
RED="\033[0;31m"
|
||||
GREEN="\033[0;32m"
|
||||
YELLOW="\033[1;33m"
|
||||
NC="\033[0m"
|
||||
|
||||
MAX_VERSION="2.1.112"
|
||||
|
||||
CURRENT=$(claude --version 2>/dev/null | grep -oE "[0-9]+\.[0-9]+\.[0-9]+" | head -1)
|
||||
echo "Current: v${CURRENT:-not installed}"
|
||||
|
||||
# Check what latest available is
|
||||
LATEST=$(npm view @anthropic-ai/claude-code version 2>/dev/null)
|
||||
echo "Latest available: v${LATEST:-unknown}"
|
||||
echo "Termux ceiling: v$MAX_VERSION"
|
||||
echo ""
|
||||
|
||||
# Compare versions (is latest > ceiling?)
|
||||
version_gt() {
|
||||
test "$(printf '%s\n' "$1" "$2" | sort -V | tail -1)" != "$2"
|
||||
}
|
||||
|
||||
if [[ "$CURRENT" == "$MAX_VERSION" ]]; then
|
||||
echo -e "${GREEN}Already at ceiling version v$MAX_VERSION${NC}"
|
||||
echo "Versions above this use native binaries (incompatible with Termux/Android)"
|
||||
exit 0
|
||||
fi
|
||||
|
||||
if version_gt "$LATEST" "$MAX_VERSION"; then
|
||||
echo -e "${YELLOW}Latest (v$LATEST) exceeds ceiling.${NC}"
|
||||
echo "Installing ceiling version v$MAX_VERSION instead..."
|
||||
TARGET="$MAX_VERSION"
|
||||
else
|
||||
TARGET="$LATEST"
|
||||
fi
|
||||
|
||||
# Verify target is pure Node.js (has cli.js, not cli-wrapper.cjs)
|
||||
echo "Verifying v$TARGET is Node.js compatible..."
|
||||
FILES=$(npm pack "@anthropic-ai/claude-code@$TARGET" --dry-run 2>&1 || true)
|
||||
if echo "$FILES" | grep -q "cli-wrapper.cjs"; then
|
||||
echo -e "${RED}ERROR: v$TARGET uses native binaries (cli-wrapper.cjs)${NC}"
|
||||
echo "This version is NOT compatible with Termux/Android."
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Unprotect if previously locked
|
||||
CLAUDE_DIR="$PREFIX/lib/node_modules/@anthropic-ai/claude-code"
|
||||
if [[ -d "$CLAUDE_DIR" ]]; then
|
||||
chmod -R u+w "$CLAUDE_DIR" 2>/dev/null || true
|
||||
fi
|
||||
|
||||
echo "Installing v$TARGET..."
|
||||
npm install -g "@anthropic-ai/claude-code@$TARGET"
|
||||
|
||||
# Re-protect against auto-updater
|
||||
chmod -R a-w "$CLAUDE_DIR" 2>/dev/null || true
|
||||
|
||||
NEW=$(claude --version 2>/dev/null | grep -oE "[0-9]+\.[0-9]+\.[0-9]+" | head -1)
|
||||
echo ""
|
||||
echo -e "${GREEN}Updated: v$CURRENT -> v$NEW${NC}"
|
||||
echo "Package protected against auto-updater (chmod a-w)"
|
||||
|
|
@ -0,0 +1,43 @@
|
|||
#!/usr/bin/env bash
|
||||
#
|
||||
# clauded: Wrapper for Claude Code on Termux
|
||||
# Uses termux-chroot for working /tmp in all child processes
|
||||
#
|
||||
|
||||
set -e
|
||||
|
||||
TERMUX_TMP="$PREFIX/tmp"
|
||||
|
||||
RED="\033[0;31m"
|
||||
GREEN="\033[0;32m"
|
||||
YELLOW="\033[1;33m"
|
||||
NC="\033[0m"
|
||||
|
||||
# Verify termux-chroot
|
||||
if ! command -v termux-chroot &>/dev/null; then
|
||||
echo -e "${RED}Error: termux-chroot not available${NC}"
|
||||
echo "Install with: pkg install proot"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Verify claude
|
||||
if ! command -v claude &>/dev/null; then
|
||||
echo -e "${RED}Error: claude is not installed${NC}"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Clean orphan Claude temp files (older than 1 day)
|
||||
find "$TERMUX_TMP" -name "claude-*-cwd" -mtime +1 -delete 2>/dev/null || true
|
||||
|
||||
# Check Tailscale connectivity (generic: look for tailscale0 interface)
|
||||
if ! ip link show tailscale0 &>/dev/null 2>&1; then
|
||||
echo -e "${YELLOW}Tailscale not connected${NC} - SSH to remote hosts will fail"
|
||||
echo ""
|
||||
fi
|
||||
|
||||
CLAUDE_VER=$(claude --version 2>/dev/null | grep -oE "[0-9]+\.[0-9]+\.[0-9]+" | head -1)
|
||||
echo -e "${GREEN}Claude Code v$CLAUDE_VER (termux-chroot)${NC}"
|
||||
echo -e " /tmp -> /usr/tmp (FHS)"
|
||||
echo ""
|
||||
|
||||
exec termux-chroot claude --dangerously-skip-permissions "$@"
|
||||
|
|
@ -0,0 +1,103 @@
|
|||
#!/usr/bin/env python3
|
||||
"""
|
||||
Resolve hostname.local via mDNS multicast (pure Python, no dependencies).
|
||||
Usage: mdns-resolve <hostname.local> [timeout_seconds]
|
||||
Returns: IP address on stdout, or exit 1 on failure.
|
||||
"""
|
||||
import sys
|
||||
import socket
|
||||
import struct
|
||||
import select
|
||||
import time
|
||||
|
||||
|
||||
def build_mdns_query(hostname: str) -> bytes:
|
||||
header = struct.pack('>HHHHHH', 0, 0, 1, 0, 0, 0)
|
||||
question = b''
|
||||
for part in hostname.rstrip('.').split('.'):
|
||||
question += bytes([len(part)]) + part.encode()
|
||||
question += b'\x00'
|
||||
question += struct.pack('>HH', 1, 1) # Type A, Class IN
|
||||
return header + question
|
||||
|
||||
|
||||
def parse_mdns_response(data: bytes) -> str | None:
|
||||
if len(data) < 12:
|
||||
return None
|
||||
qdcount = struct.unpack('>H', data[4:6])[0]
|
||||
ancount = struct.unpack('>H', data[6:8])[0]
|
||||
if ancount == 0:
|
||||
return None
|
||||
|
||||
offset = 12
|
||||
for _ in range(qdcount):
|
||||
while offset < len(data) and data[offset] != 0:
|
||||
if data[offset] & 0xc0 == 0xc0:
|
||||
offset += 2
|
||||
break
|
||||
offset += data[offset] + 1
|
||||
else:
|
||||
offset += 1
|
||||
offset += 4
|
||||
|
||||
for _ in range(ancount):
|
||||
while offset < len(data):
|
||||
if data[offset] & 0xc0 == 0xc0:
|
||||
offset += 2
|
||||
break
|
||||
elif data[offset] == 0:
|
||||
offset += 1
|
||||
break
|
||||
else:
|
||||
offset += data[offset] + 1
|
||||
if offset + 10 > len(data):
|
||||
break
|
||||
rtype, rclass, ttl, rdlength = struct.unpack('>HHIH', data[offset:offset+10])
|
||||
offset += 10
|
||||
if rtype == 1 and rdlength == 4 and offset + 4 <= len(data):
|
||||
return socket.inet_ntoa(data[offset:offset+4])
|
||||
offset += rdlength
|
||||
return None
|
||||
|
||||
|
||||
def resolve_mdns(hostname: str, timeout: float = 2.0) -> str | None:
|
||||
if not hostname.endswith('.local'):
|
||||
hostname += '.local'
|
||||
try:
|
||||
sock = socket.socket(socket.AF_INET, socket.SOCK_DGRAM)
|
||||
sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
|
||||
sock.setblocking(False)
|
||||
sock.sendto(build_mdns_query(hostname), ('224.0.0.251', 5353))
|
||||
end_time = time.time() + timeout
|
||||
while time.time() < end_time:
|
||||
ready, _, _ = select.select([sock], [], [], 0.1)
|
||||
if ready:
|
||||
try:
|
||||
data, _ = sock.recvfrom(4096)
|
||||
ip = parse_mdns_response(data)
|
||||
if ip:
|
||||
sock.close()
|
||||
return ip
|
||||
except Exception:
|
||||
pass
|
||||
sock.close()
|
||||
except Exception:
|
||||
pass
|
||||
return None
|
||||
|
||||
|
||||
def main():
|
||||
if len(sys.argv) < 2:
|
||||
print("Usage: mdns-resolve <hostname.local> [timeout]", file=sys.stderr)
|
||||
sys.exit(1)
|
||||
hostname = sys.argv[1]
|
||||
timeout = float(sys.argv[2]) if len(sys.argv) > 2 else 2.0
|
||||
ip = resolve_mdns(hostname, timeout)
|
||||
if ip:
|
||||
print(ip)
|
||||
else:
|
||||
sys.exit(1)
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
main()
|
||||
|
|
@ -0,0 +1,48 @@
|
|||
#!/usr/bin/env bash
|
||||
# ssh-mdns-proxy: Resolve .local via mDNS with fallbacks, then connect
|
||||
#
|
||||
# Resolution order: mDNS → Tailscale DNS → cached IP
|
||||
# Usage: ssh-mdns-proxy <hostname> [port]
|
||||
#
|
||||
# Configure your Tailscale domain:
|
||||
TAILSCALE_DOMAIN="${TAILSCALE_DOMAIN:-tailb0bb74.ts.net}"
|
||||
|
||||
HOST="$1"
|
||||
PORT="${2:-22}"
|
||||
CACHE="$HOME/.ssh/mdns-cache"
|
||||
QUERY="${HOST%.local}"
|
||||
|
||||
# Alias mapping (short name -> mDNS hostname)
|
||||
declare -A ALIASES=(
|
||||
[dell]="dell-latitude3400"
|
||||
[lenovo]="lenovo-ideapad"
|
||||
)
|
||||
[[ -n "${ALIASES[$QUERY]}" ]] && QUERY="${ALIASES[$QUERY]}"
|
||||
|
||||
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
|
||||
|
||||
# 1. mDNS resolution
|
||||
IP=$("$SCRIPT_DIR/mdns-resolve" "${QUERY}.local" 2 2>/dev/null)
|
||||
|
||||
# 2. Fallback: Tailscale DNS
|
||||
if [[ -z "$IP" ]]; then
|
||||
IP=$(getent hosts "${QUERY}.${TAILSCALE_DOMAIN}" 2>/dev/null | awk '{print $1}')
|
||||
fi
|
||||
|
||||
# 3. Fallback: cached IP
|
||||
if [[ -z "$IP" && -f "$CACHE" ]]; then
|
||||
IP=$(grep "^${QUERY} " "$CACHE" 2>/dev/null | awk '{print $2}')
|
||||
fi
|
||||
|
||||
if [[ -z "$IP" ]]; then
|
||||
echo "Error: cannot resolve ${HOST}" >&2
|
||||
exit 1
|
||||
fi
|
||||
|
||||
# Save to cache
|
||||
mkdir -p "$(dirname "$CACHE")"
|
||||
grep -v "^${QUERY} " "$CACHE" > "${CACHE}.tmp" 2>/dev/null || true
|
||||
echo "${QUERY} ${IP}" >> "${CACHE}.tmp"
|
||||
mv "${CACHE}.tmp" "$CACHE"
|
||||
|
||||
exec nc "$IP" "$PORT"
|
||||
|
|
@ -0,0 +1,15 @@
|
|||
# === Claude Code for Termux - .bashrc additions ===
|
||||
# Append these lines to your ~/.bashrc
|
||||
|
||||
# Node-gyp / native compilation config
|
||||
export CFLAGS="-I$PREFIX/include"
|
||||
export LDFLAGS="-L$PREFIX/lib"
|
||||
export CC=clang
|
||||
export CXX=clang++
|
||||
export npm_config_nodedir=$PREFIX
|
||||
|
||||
# Add local bin to PATH (for clauded, claude-check-env, etc.)
|
||||
export PATH="$HOME/.local/bin:$PATH"
|
||||
|
||||
# Prevent Claude Code auto-updater (enforced at shell level too)
|
||||
export DISABLE_AUTOUPDATER=1
|
||||
|
|
@ -0,0 +1,6 @@
|
|||
{
|
||||
"env": {
|
||||
"DISABLE_AUTOUPDATER": "1"
|
||||
},
|
||||
"skipDangerousModePermissionPrompt": true
|
||||
}
|
||||
|
|
@ -0,0 +1,29 @@
|
|||
# SSH Config for Termux with mDNS/Tailscale resolution
|
||||
# Copy relevant sections to ~/.ssh/config
|
||||
|
||||
Host *
|
||||
IdentityFile ~/.ssh/id_ed25519
|
||||
IdentitiesOnly yes
|
||||
ServerAliveInterval 60
|
||||
ServerAliveCountMax 3
|
||||
ConnectTimeout 10
|
||||
|
||||
# === mDNS (.local) - Dynamic resolution ===
|
||||
Host *.local
|
||||
User <your-user>
|
||||
ProxyCommand ~/.local/bin/ssh-mdns-proxy %h %p
|
||||
|
||||
# === Short hostnames -> mDNS first, then Tailscale ===
|
||||
Host <host-1>
|
||||
User <your-user>
|
||||
ProxyCommand ~/.local/bin/ssh-mdns-proxy %h %p
|
||||
|
||||
Host <host-2>
|
||||
User <your-user>
|
||||
ProxyCommand ~/.local/bin/ssh-mdns-proxy %h %p
|
||||
|
||||
# === ProxyJump (hosts without Tailscale, via jump host) ===
|
||||
# Host <lan-only-host>
|
||||
# HostName <lan-only-host>.local
|
||||
# User <user>
|
||||
# ProxyJump <jump-host>
|
||||
|
|
@ -0,0 +1,106 @@
|
|||
# Troubleshooting
|
||||
|
||||
## /tmp Permission Denied
|
||||
|
||||
**Error:** `EACCES: permission denied, mkdir '/tmp/claude/...'`
|
||||
|
||||
**Cause:** Claude Code hardcodes `/tmp` for background tasks. Termux doesn't have `/tmp`.
|
||||
|
||||
**Fix:** Always start Claude via `clauded`, which uses `termux-chroot` to provide a working `/tmp`.
|
||||
|
||||
```bash
|
||||
# Wrong
|
||||
claude
|
||||
|
||||
# Right
|
||||
clauded
|
||||
```
|
||||
|
||||
**Why not proot?** `proot -b $PREFIX/tmp:/tmp` only affects the main process. Child processes (Bash tool, agents) run in separate shells without the binding. `termux-chroot` simulates a full FHS where `/tmp -> /usr/tmp` works for ALL processes.
|
||||
|
||||
---
|
||||
|
||||
## Native Binary Error (v2.1.113+)
|
||||
|
||||
**Error:** `claude native binary not installed`
|
||||
|
||||
**Cause:** Starting with v2.1.113, Anthropic migrated from `cli.js` (pure Node.js) to native binaries (SEA). Termux reports `process.platform === 'android'` which is not supported.
|
||||
|
||||
**Why no workaround:**
|
||||
- `npm install --force` of linux-arm64 downloads the binary but needs `/lib/ld-linux-aarch64.so.1` (glibc) or `/lib/ld-musl-aarch64.so.1` (musl)
|
||||
- Termux uses Bionic libc (Android), neither linker exists
|
||||
- `termux-chroot` and `proot` don't help because the linkers simply don't exist
|
||||
|
||||
**Fix:** Stay on v2.1.112 (last pure Node.js release).
|
||||
|
||||
```bash
|
||||
claude-update # Automatically respects the version ceiling
|
||||
```
|
||||
|
||||
**How to verify a version is compatible:**
|
||||
```bash
|
||||
npm pack @anthropic-ai/claude-code@VERSION --dry-run 2>&1 | grep cli.js
|
||||
# If cli.js (~13MB) appears -> compatible
|
||||
# If cli-wrapper.cjs (~4KB) appears -> native binary, NOT compatible
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Auto-updater Bypasses Settings
|
||||
|
||||
**Problem:** Claude Code may auto-update despite `DISABLE_AUTOUPDATER=1`.
|
||||
|
||||
**Fix:** Protect the installation directory:
|
||||
```bash
|
||||
chmod -R a-w $PREFIX/lib/node_modules/@anthropic-ai/claude-code/
|
||||
```
|
||||
|
||||
To update later, unprotect first:
|
||||
```bash
|
||||
chmod -R u+w $PREFIX/lib/node_modules/@anthropic-ai/claude-code/
|
||||
claude-update
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## SSH .local Resolution Fails
|
||||
|
||||
**Error:** `ssh hostname.local` fails with "Could not resolve hostname"
|
||||
|
||||
**Cause:** mDNS (.local) does NOT work natively in Termux (Android's Bionic libc doesn't support it).
|
||||
|
||||
**Fix:** Use the included `ssh-mdns-proxy` as ProxyCommand in `~/.ssh/config`:
|
||||
```
|
||||
Host *.local
|
||||
ProxyCommand ~/.local/bin/ssh-mdns-proxy %h %p
|
||||
```
|
||||
|
||||
This uses pure Python multicast UDP to resolve mDNS, with Tailscale DNS fallback.
|
||||
|
||||
---
|
||||
|
||||
## Sharp/Image Support
|
||||
|
||||
**Warning:** `Sharp WASM not installed (no image support)`
|
||||
|
||||
**Fix:**
|
||||
```bash
|
||||
npm install -g @img/sharp-wasm32 sharp --force
|
||||
```
|
||||
|
||||
This enables Claude Code to process images (screenshots, diagrams, etc.).
|
||||
|
||||
---
|
||||
|
||||
## Alternative: proot-distro
|
||||
|
||||
For running newer Claude Code versions (v2.1.113+), you can use proot-distro with Ubuntu, which provides real glibc:
|
||||
|
||||
```bash
|
||||
pkg install proot-distro
|
||||
proot-distro install ubuntu
|
||||
proot-distro login ubuntu
|
||||
# Inside Ubuntu: install node, npm, claude-code@latest
|
||||
```
|
||||
|
||||
**Trade-offs:** +2GB disk, slight performance overhead, but full Linux compatibility.
|
||||
|
|
@ -0,0 +1,109 @@
|
|||
#!/usr/bin/env bash
|
||||
#
|
||||
# install.sh: Set up Claude Code on Termux
|
||||
#
|
||||
# Usage: bash install.sh [--dry-run]
|
||||
#
|
||||
|
||||
set -e
|
||||
|
||||
RED="\033[0;31m"
|
||||
GREEN="\033[0;32m"
|
||||
YELLOW="\033[1;33m"
|
||||
CYAN="\033[0;36m"
|
||||
NC="\033[0m"
|
||||
|
||||
DRY_RUN=false
|
||||
[[ "$1" == "--dry-run" ]] && DRY_RUN=true
|
||||
|
||||
CLAUDE_VERSION="2.1.112"
|
||||
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
|
||||
BIN_DIR="$HOME/.local/bin"
|
||||
|
||||
step() { echo -e "\n${CYAN}[$1/$TOTAL] $2${NC}"; }
|
||||
run() {
|
||||
if $DRY_RUN; then
|
||||
echo -e " ${YELLOW}[dry-run]${NC} $*"
|
||||
else
|
||||
"$@"
|
||||
fi
|
||||
}
|
||||
|
||||
# Verify we're on Termux
|
||||
if [[ -z "$PREFIX" || ! -d "$PREFIX" ]]; then
|
||||
echo -e "${RED}Error: Not running on Termux${NC}"
|
||||
echo "This installer is designed for Termux on Android."
|
||||
exit 1
|
||||
fi
|
||||
|
||||
TOTAL=8
|
||||
echo -e "${GREEN}=== Claude Code for Termux - Installer ===${NC}"
|
||||
echo "Version ceiling: v$CLAUDE_VERSION"
|
||||
$DRY_RUN && echo -e "${YELLOW}(dry-run mode - no changes will be made)${NC}"
|
||||
|
||||
# 1. Install system packages
|
||||
step 1 "Installing system packages..."
|
||||
run pkg install -y nodejs python git proot
|
||||
|
||||
# 2. Install Claude Code
|
||||
step 2 "Installing Claude Code v$CLAUDE_VERSION..."
|
||||
run npm install -g "@anthropic-ai/claude-code@$CLAUDE_VERSION"
|
||||
|
||||
# 3. Protect against auto-updater
|
||||
step 3 "Protecting against auto-updater..."
|
||||
CLAUDE_DIR="$PREFIX/lib/node_modules/@anthropic-ai/claude-code"
|
||||
if [[ -d "$CLAUDE_DIR" ]]; then
|
||||
run chmod -R a-w "$CLAUDE_DIR"
|
||||
fi
|
||||
|
||||
# 4. Install scripts
|
||||
step 4 "Installing scripts to $BIN_DIR..."
|
||||
run mkdir -p "$BIN_DIR"
|
||||
for script in clauded claude-check-env claude-update mdns-resolve ssh-mdns-proxy; do
|
||||
run cp "$SCRIPT_DIR/bin/$script" "$BIN_DIR/$script"
|
||||
run chmod +x "$BIN_DIR/$script"
|
||||
done
|
||||
|
||||
# 5. Claude settings
|
||||
step 5 "Configuring Claude settings..."
|
||||
run mkdir -p "$HOME/.claude"
|
||||
if [[ ! -f "$HOME/.claude/settings.json" ]]; then
|
||||
run cp "$SCRIPT_DIR/config/settings.json" "$HOME/.claude/settings.json"
|
||||
else
|
||||
echo " ~/.claude/settings.json already exists, skipping"
|
||||
fi
|
||||
|
||||
# 6. Bashrc additions
|
||||
step 6 "Updating ~/.bashrc..."
|
||||
if ! grep -q "DISABLE_AUTOUPDATER" "$HOME/.bashrc" 2>/dev/null; then
|
||||
if ! $DRY_RUN; then
|
||||
echo "" >> "$HOME/.bashrc"
|
||||
cat "$SCRIPT_DIR/config/bashrc.snippet" >> "$HOME/.bashrc"
|
||||
fi
|
||||
echo " Added Claude-related exports to ~/.bashrc"
|
||||
else
|
||||
echo " ~/.bashrc already configured, skipping"
|
||||
fi
|
||||
|
||||
# 7. Install sharp-wasm32 (image support)
|
||||
step 7 "Installing Sharp WASM (image support)..."
|
||||
run npm install -g @img/sharp-wasm32 sharp --force 2>/dev/null || {
|
||||
echo -e " ${YELLOW}Sharp install failed (optional, images won't work)${NC}"
|
||||
}
|
||||
|
||||
# 8. Done
|
||||
step 8 "Verifying installation..."
|
||||
if ! $DRY_RUN; then
|
||||
echo ""
|
||||
"$BIN_DIR/claude-check-env"
|
||||
fi
|
||||
|
||||
echo ""
|
||||
echo -e "${GREEN}=== Installation Complete ===${NC}"
|
||||
echo ""
|
||||
echo "Next steps:"
|
||||
echo " 1. Restart your shell: source ~/.bashrc"
|
||||
echo " 2. Authenticate: claude auth"
|
||||
echo " 3. Start Claude: clauded"
|
||||
echo ""
|
||||
echo "See docs/TROUBLESHOOTING.md for common issues."
|
||||
Loading…
Reference in New Issue