Utilisation¶
Une fois installé, Tegvia fonctionne sans intervention : le service en arrière-plan le démarre à votre connexion et le maintient actif. Il n'y a rien à taper dans Claude Code ; vous pilotez Tegvia depuis la console web et depuis la commande du service.
Pour l'utiliser sans le service, voir Déploiement autonome.
Mettre en pause et reprendre¶
| Ce que vous voulez | Comment |
|---|---|
| Suspendre l'inspection en gardant Tegvia actif | Désactivez l'interrupteur de protection dans la console web (carte Protection du menu, ou page Réglages). Le proxy relaie les requêtes sans les inspecter ni les journaliser. Réactivez-le depuis la même page. |
| Arrêter complètement Tegvia | sh launch/tegvia-service.sh stop (launch\tegvia-service.cmd stop sous Windows) : arrête le proxy et restaure settings.json. Il n'est pas relancé automatiquement. |
| Le redémarrer | sh launch/tegvia-service.sh start (launch\tegvia-service.cmd start). |
| Voir l'état | sh launch/tegvia-service.sh status (launch\tegvia-service.cmd status) : service actif ou non, settings.json redirigé ou non, adresse de la console, chemins des journaux et, si le proxy est arrêté, la fin de son journal d'erreurs. |
| Ouvrir la console web | http://127.0.0.1:8736/tegvia/ui/ (affichée par install et status). |
Toutes les sous-commandes du service sont décrites sur la page Service en arrière-plan.
Redémarrer Claude Code après start / stop
Claude Code lit settings.json au démarrage. Après un stop ou un
start, la session en cours garde son ancien comportement : ouvrez une
nouvelle session (ou redémarrez Claude Code) pour que le changement
s'applique.
Quand une action est bloquée¶
Appel d'outil bloqué (par exemple une commande curl … | sh) : la
réponse continue, mais l'appel est remplacé par un encadré :
TEGVIA Protection
A tool call in this response was blocked by the `pipe_to_shell_check`
module (OWASP:LLM06) because it was judged unsafe to execute.
Reason: Bash command pipes into a shell: output is piped into a shell
interpreter ('sh')
La commande n'est pas exécutée. Claude voit ce message et peut proposer une alternative (par exemple télécharger le script, vous le montrer, puis l'exécuter en deux étapes).
Requête bloquée (par exemple un jeton canari détecté) : la requête n'est pas envoyée à l'API et Claude Code affiche une erreur contenant le même type d'encadré, avec le module, la raison et l'identifiant de session.
La langue de ces messages se règle avec TEGVIA_LANGUAGE.
Si un blocage vous semble injustifié, voir Dépannage.
Journaux de session¶
Chaque échange est enregistré dans une seule base SQLite,
~/.tegvia/tegvia.db, dans le dossier de données de Tegvia (TEGVIA_HOME
le change). Rien n'est purgé.
Vous les lisez dans la console web (écrans Vue d'ensemble, Alertes, Outils, Sessions), ou en interrogeant vous-même la base (voir ci-dessous). Les heures sont en heure locale.
Données sensibles
La base contient le contenu complet des requêtes et des réponses :
vos messages, le code et les fichiers lus par Claude, et les réponses du
modèle. Les en-têtes x-api-key et Authorization sont tronqués, mais
le reste ne l'est pas. Il en va de même pour les copies
tegvia.db.bak-v<n> et le fichier tegvia.db.pending situés à côté de
la base. Protégez ce dossier en conséquence.
Pour interroger la base depuis un script.