Aller au contenu

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.