# claude-web-terminal

Mode operatoire pour exposer une session **Claude Code persistante** dans un navigateur,
derriere un nom de domaine et un reverse proxy.

```
navigateur -> https://claude.mondomaine.fr -> Caddy (basic_auth) -> ttyd -> tmux -> claude
```

La session survit a la fermeture du navigateur, au redemarrage du poste client et au
changement d'appareil : on retombe toujours sur le meme contexte Claude Code.

## Contenu

| Fichier | Role |
|---|---|
| `MODE-OPERATOIRE.md` | Le document complet, a donner tel quel a une instance Claude Code disposant d'un acces root sur le serveur cible |
| `ttyd-custom.html` | Le frontend personnalise a injecter dans la page de ttyd (etape 6) |

## Utilisation

```bash
git clone https://gitea.8grangettes.fr/sylfrd/claude-web-terminal.git
cd claude-web-terminal
claude
```

Puis : `lis MODE-OPERATOIRE.md et deroule l'installation`.

## Points notables

Le document ne se limite pas a l'installation. Sa section 9 documente les defauts rencontres
en production et deja corriges dans `ttyd-custom.html` :

- bas du terminal tronque : le padding du parent est compte comme espace disponible par le
  FitAddon, et tout changement de taille de police exige un refit explicite
- `Ctrl+V` qui collait en double, faute de `preventDefault()`
- copie depuis le terminal distant qui ne remontait pas (OSC 52, des deux cotes, en HTTPS)
- liens cliquables qui ouvraient une page blanche

Ainsi qu'une methode de debug du frontend sans rien installer, en encodant les mesures dans
des chemins HTTP journalises par ttyd.

## Avertissement

Cette stack expose un **shell root persistant** sur internet. Lire la section 11 avant de
rediriger le moindre port.