claude-code-termux/docs/02-base-packages.md

67 lines
1.6 KiB
Markdown
Raw Normal View History

# 02 — Base packages
Minimum set of packages needed by Claude Code and the helper scripts in this repo. Everything here is idempotent — re-running is safe.
## Required (Claude Code itself)
```bash
pkg install -y \
nodejs \
python \
git \
proot \
ripgrep
```
| Package | Why |
|---------|-----|
| `nodejs` | Claude Code runs on Node.js |
| `python` | `mdns-resolve`, `mdns-publish.py` |
| `git` | Cloning this repo, version control inside Claude |
| `proot` | Provides `termux-chroot` used by `clauded` (fixes `/tmp`) |
| `ripgrep` | Faster search inside Claude (the bundled one may not run on aarch64) |
## Recommended (SSH + mDNS)
```bash
pkg install -y openssh termux-api
pip install zeroconf
```
| Package | Why |
|---------|-----|
| `openssh` | SSH server (`sshd`) and client |
| `termux-api` | Backs the `termux-*` Android-bridge commands |
| `zeroconf` (pip) | Required by `mdns-publish.py`; **does not survive a `tar` backup** of `$HOME`, reinstall after restore |
## Optional (file sharing)
```bash
pkg install -y samba
```
See `04-samba.md` for the rest of the setup (custom port 4450, share definitions).
## Optional (image support in Claude)
```bash
npm install -g @img/sharp-wasm32 sharp --force
```
Enables image input (screenshots, diagrams). Sometimes flaky on aarch64; safe to skip.
## Verifying
```bash
node --version # >= 22 LTS recommended
python --version # 3.11+
proot --version
ssh -V
```
If any of these fail, re-run the relevant `pkg install`.
## What's next
`03-ssh-mdns-tailscale.md` — set up dynamic hostname resolution so you never hardcode IPs.