Installation depuis une archive¶
Tegvia peut être remis sous forme d'archive
zip (tegvia-<nom>.zip), par exemple par votre administrateur. L'archive
contient tout ce qu'il faut pour lancer Tegvia en mode autonome, en
service en arrière-plan ou à la demande,
ainsi que cette documentation sous forme de site prêt à ouvrir.
Ce que vous recevez¶
| Fichier | Rôle |
|---|---|
tegvia-<nom>.zip |
L'archive elle-même. |
tegvia-<nom>.zip.sha256 |
Son empreinte SHA-256, pour vérifier qu'elle n'a été ni abîmée ni modifiée en route. |
Lire le nom de l'archive¶
<nom> est la version de Tegvia dont l'archive est issue :
| Nom | Signification |
|---|---|
v1.2 |
La version publiée v1.2, exactement. |
v1.2-3-gabc1234 |
Une compilation faite 3 commits après la version v1.2, depuis le commit commençant par abc1234. Ce n'est pas une version officielle. |
abc1234 |
Aucune version publiée n'est connue : seul le hash du commit est disponible. |
...-dirty |
La compilation incluait des modifications non encore commitées. Non reproductible : ne l'utilisez pas en production. |
...-unaudited |
L'audit de sécurité des dépendances a été ignoré (voir le rapport de compilation). |
Préférez les archives portant le nom d'une version simple (v1.2).
Vérifier l'archive¶
Placez le .zip et le fichier .zip.sha256 dans le même dossier, puis
comparez l'empreinte.
Linux
sha256sum -c tegvia-<nom>.zip.sha256
macOS
shasum -a 256 -c tegvia-<nom>.zip.sha256
Windows (cmd.exe ou PowerShell)
certutil -hashfile tegvia-<nom>.zip SHA256
Sous Linux et macOS, la commande doit répondre OK. Sous Windows, comparez
la valeur affichée avec celle du fichier .zip.sha256 (le texte avant le nom
du fichier) : elles doivent être identiques. Si elles diffèrent, n'utilisez
pas l'archive et demandez-en une nouvelle copie.
Extraire dans un dossier stable¶
Extrayez l'archive dans le dossier où Tegvia va rester, par exemple
~/tegvia ou C:\Tegvia. L'archive contient un seul dossier,
tegvia-<nom>/. Le service en arrière-plan pointe vers ce dossier : si vous
le déplacez ou le supprimez, le service ne fonctionne plus (relancez
install après un déplacement).
Sous macOS, n'extrayez pas dans ~/Downloads, ~/Documents, ~/Desktop
ni iCloud Drive (~/Library/Mobile Documents) : macOS restreint ce qu'un
service en arrière-plan peut lire dans ces dossiers, si bien qu'un service
installé depuis l'un d'eux peut ne jamais devenir actif. Utilisez plutôt un
dossier comme ~/tegvia.
| Dossier | Sous macOS |
|---|---|
~/Downloads/tegvia-<nom> |
Inadapté : l'installation affiche un avertissement |
~/tegvia |
Adapté |
Avant d'extraire, traitez les avertissements du système ci-dessous s'ils vous concernent.
macOS : Gatekeeper¶
Un fichier téléchargé depuis Internet est « en quarantaine ». Un
double-clic sur launch/tegvia.command peut alors être refusé (« ne peut pas
être ouvert car il provient d'un développeur non identifié »). La marche à
suivre dépend de votre version de macOS :
- macOS 15 (Sequoia) ou plus récent : le clic droit puis Ouvrir ne
contourne plus le blocage. Essayez d'ouvrir le fichier une fois, puis allez
dans Réglages Système, Confidentialité et sécurité, descendez
jusqu'au message concernant
tegvia.commandet cliquez sur Ouvrir quand même, puis confirmez. - macOS 14 (Sonoma) ou plus ancien : faites un clic droit sur le fichier, choisissez Ouvrir, puis confirmez.
-
Toutes versions : retirez la quarantaine de tout le dossier extrait dans le Terminal. C'est le moyen le plus fiable :
xattr -dr com.apple.quarantine <dossier extrait>
Lancer ./install.sh depuis le Terminal (l'installation
recommandée) n'est pas bloqué par Gatekeeper ; cette section ne
concerne que le double-clic sur launch/tegvia.command.
Windows : SmartScreen et marque « provenant d'Internet »¶
Windows marque un zip téléchargé, et ce qui en est extrait, comme provenant
d'Internet. SmartScreen peut alors avertir à l'exécution de install.cmd ou
launch\tegvia.cmd. Retirez la marque avant l'extraction : clic droit sur
le zip, Propriétés, cochez Débloquer, OK. Ou, après extraction,
dans PowerShell :
Get-ChildItem -Recurse <dossier extrait> | Unblock-File
Si SmartScreen affiche encore un avertissement, choisissez Informations complémentaires puis Exécuter quand même, à condition d'avoir vérifié l'empreinte.
Installer et lancer¶
Il faut Python 3.11 ou plus récent avec pip (voir
Installation) et, au premier lancement, un accès réseau
à PyPI : les dépendances sont téléchargées dans un dossier .deps/ à
l'intérieur du dossier de Tegvia. Rien d'autre n'est installé.
Choisissez un mode, depuis le dossier extrait. Ne lancez pas le service et le lanceur en même temps (voir Déploiement autonome).
| Mode | Linux, WSL | macOS | Windows |
|---|---|---|---|
| Service en arrière-plan (démarre à la connexion) | ./install.sh |
./install.sh |
install.cmd |
| À la demande, lié à une fenêtre | sh launch/tegvia.sh |
launch/tegvia.command |
launch\tegvia.cmd |
Le service est la méthode recommandée, voir
Service en arrière-plan. Sur un poste de bureau, il configure
aussi l'icône de la zone de notification ; utilisez
--no-tray pour l'éviter. L'archive contient l'icône et ses lanceurs
(launch/tegvia-tray.sh, launch\tegvia-tray.cmd) ; sous Linux et macOS,
l'icône a aussi besoin de requirements-tray.txt, sans lequel la construction
de l'archive est refusée. Relancez ensuite Claude Code pour
qu'il passe par le proxy.
La documentation est dans l'archive : ouvrez docs/index.html dans votre
navigateur (elle fonctionne sans réseau, recherche comprise).
Expiration de la version d'évaluation¶
Une archive peut être une version d'évaluation avec une date de fin. La date
est fixée à la compilation de l'archive (par défaut 180 jours après la date du
commit dont elle est issue) et inscrite dans le LISEZMOI.txt de l'archive et
dans build_report.txt (ligne expires ; none si l'archive n'a pas
d'expiration). La commande status du service l'affiche aussi (Evaluation:
expires <date> (in N days)).
Avertissements, pendant les 30 derniers jours.
- La console web affiche un bandeau sur chaque écran.
- L'icône de la zone de notification affiche une ligne d'information dans son menu et envoie une notification par jour.
- Le proxy écrit une ligne WARNING dans son journal (
proxy.stderr.log) à chaque démarrage.
À l'expiration. Le jour de la date est encore valide ; la version est refusée à partir du lendemain. Tegvia refuse alors de démarrer :
- le lanceur autonome, les commandes
install,startetrestartdu service etproxy.py --configureaffichent le message ci-dessous et se terminent avec le code 78 (erreur de configuration : le service n'est pas relancé en boucle).proxy.pysans--configurerefuse aussi de démarrer, mais il ne touche pas àsettings.jsonet son message n'a pas la ligne « connexion directe » ; - quand il est lancé par le lanceur, le service ou
--configure, Claude Code est remis en connexion directe à l'API Anthropic : Tegvia ne le protège plus. La redirection de~/.claude/settings.jsonest retirée, et votre valeur précédente est rétablie s'il y en avait une. Sisettings.jsonest illisible, invalide ou non modifiable, la redirection ne peut pas être retirée : le message n'a alors pas la ligne « connexion directe », et vous devez vérifier vous-même~/.claude/settings.json(voir le dépannage) ; installest refusé avant que quoi que ce soit soit installé (il retire quand même la redirection, comme ci-dessus).install --dry-runest refusé aussi, et ne modifie rien (il ne touche pas non plus àsettings.json; son message n'a pas la ligne « connexion directe ») ;uninstall,stopetstatusfonctionnent toujours : vous pouvez toujours nettoyer.
Comportement du service à l'expiration : sous Linux (systemd), le code 78 signifie que le service n'est pas relancé. Sous macOS (launchd), le service se termine avec le code 0 : pas de boucle de relance. Sous Windows (Planificateur de tâches), la tâche est relancée jusqu'à 3 fois, en affichant le même message à chaque fois, sans autre effet.
Cette version d'évaluation de Tegvia a expiré le 2026-05-01, elle ne démarre donc pas.
Claude Code a été remis en connexion directe avec l'API Anthropic. Tegvia ne le protège plus.
Pour obtenir une nouvelle version, contacte : hello@tegvia.tech
Le message est en anglais par défaut, en français si TEGVIA_LANGUAGE=fr est
défini dans l'environnement du lanceur (le proxy lui-même suit son réglage
LANGUAGE). Si la date inscrite dans l'archive n'est pas valide, la version est
considérée comme expirée et la première ligne le dit.
Obtenir une nouvelle version : contactez hello@tegvia.tech, puis suivez Mettre à jour.
Pour qui compile l'archive : build_dist.py --expires AAAA-MM-JJ fixe une
autre date de fin (pas avant la date du commit), et --no-expiry compile une
archive sans expiration (les deux sont incompatibles). Une référence antérieure à
cette fonction se compile avec un avertissement et sans expiration.
La date est comparée à l'horloge de la machine : c'est un rappel pour mettre à jour, pas une protection contre la copie.
Mettre à jour¶
- Retirez le service de l'ancienne version :
./uninstall.sh(ouuninstall.cmd) depuis l'ancien dossier. - Vérifiez et extrayez la nouvelle archive dans un dossier stable (un nouveau dossier, ou l'ancien une fois vidé).
- Lancez
install.sh(ouinstall.cmd) depuis le nouveau dossier.
Vos journaux et réglages sont dans le dossier de données ~/.tegvia, hors du
dossier de l'archive : ils sont conservés. Les dépendances sont réinstallées
au premier lancement du nouveau dossier.
Désinstaller¶
- Lancez
./uninstall.sh(ouuninstall.cmd) : il retire le service et la redirection dans~/.claude/settings.json. - Supprimez le dossier extrait.
Pour effacer aussi vos journaux, supprimez le dossier de données ~/.tegvia
(voir Désinstallation).
Le rapport de compilation¶
Le fichier build_report.txt, à la racine de l'archive, indique comment elle
a été fabriquée. Ses lignes principales :
| Ligne | Signification |
|---|---|
version |
Le nom de l'archive (voir plus haut). |
ref |
La version publiée ou le commit dont elle est issue. |
commit, commit_date |
Le commit exact. |
dirty |
yes si elle incluait des modifications non commitées. |
audit |
Résultat de l'audit de sécurité des dépendances : passed, ou skipped (archive nommée -unaudited). |
dependencies, vulnerabilities, ignored |
Nombre de dépendances vérifiées, de vulnérabilités connues trouvées, et de vulnérabilités connues volontairement acceptées (listées sous [ignored] avec leur motif et leur date d'expiration). |
Une archive n'est produite que si l'audit ne trouve aucune vulnérabilité non
acceptée : vulnerabilities vaut donc 0 dans une archive livrée.
L'audit signale toutes les vulnérabilités connues. La compilation écarte
ensuite celles que les mainteneurs ont acceptées dans audit-ignore.toml,
chacune avec un motif et une date d'expiration : une vulnérabilité est
acceptée lorsque son identifiant, ou l'un de ses alias (par exemple un numéro
CVE), correspond à une entrée valide. Une entrée expirée ne protège plus rien
et la compilation échoue.
Chaque fichier de l'archive porte la date du commit dont elle est issue, et non la date de la compilation.
Si une compilation est refusée (par exemple à cause de modifications non
commitées sans --allow-dirty), le rapport écrit à côté a une version qui
se termine par -dirty. Si la compilation ne peut pas écrire ses fichiers
(disque plein, droit manquant), elle s'arrête avec un message d'erreur
indiquant la cause et ne laisse aucune archive partielle.
Dépannage¶
- macOS refuse d'ouvrir
tegvia.command: voir Gatekeeper. - Windows affiche « Windows a protégé votre ordinateur » : voir SmartScreen.
- Les fichiers ne s'exécutent pas après extraction sous Linux/macOS :
utilisez
sh install.sh(oush launch/tegvia.sh), ou extrayez avecunzip, qui conserve les droits d'exécution. - Le service ne démarre plus après un déplacement du dossier : relancez
installdepuis le nouvel emplacement. Voir Service en arrière-plan. - « no usable system Python 3.11+ found on PATH » ou « dependency install failed » : voir Dépannage.