Variables d'environnement
Mis à jour le
Tokenade n'a besoin d'aucune variable d'environnement pour fonctionner. Celles de cette page servent à couper une fonction, déplacer un dossier de données ou régler la quantité de sortie repliée. Vous trouverez ici celles qui sont faites pour vous, avec leur valeur par défaut et leur effet, telles qu’en version 2.0.1.
Où les poser
L'essentiel de Tokenade tourne dans les hooks de votre agent, comme processus enfants de celui-ci. Une variable exportée dans votre shell interactif n'atteint ces hooks que si l'agent a été lancé depuis ce shell. Pour qu'un réglage tienne :
- Claude Code : ajoutez-la au bloc
envde~/.claude/settings.json. - Autres agents : posez-la dans l'environnement d'où l'agent est lancé (profil du shell, lanceur de bureau, fichier de service).
- Variables lues à l'installation (
TOKENADE_ALLOW_ROOT,TOKENADE_NO_HOOK,TOKENADE_NO_STATUSLINE,TOKENADE_AUTOCOMPACT_PCT) : posez-les dans le shell où vous lanceztokenade install.
Sauf mention contraire, les interrupteurs acceptent 1, true, yes ou on. Les TOKENADE_NO_* qui ne testent que la présence de la variable sont signalés « n'importe quelle valeur ».
Couper une fonction
| Variable | Effet | Défaut |
|---|---|---|
TOKENADE_HOOK_DISABLED | Chaque hook laisse passer l'appel d'outil de l'agent sans y toucher. Fonctionne aussi en préfixe d'une seule commande : TOKENADE_HOOK_DISABLED=1 git log. Valeurs 1 ou true. | non définie (hooks actifs) |
TOKENADE_NO_HOOK | tokenade install et l'auto-réparation (ensure-hooks) n'écrivent pas de hooks. Pour garder une installation sans hooks. Valeurs 1 ou true. | non définie |
TOKENADE_NO_WEBSEARCH | Tokenade laisse la recherche web de l'agent tranquille, tokenade search refuse de s'exécuter et les règles écrites pour l'agent ne la mentionnent plus. Lancez tokenade install une fois avec la variable posée pour que les règles soient réécrites. | non définie |
TOKENADE_NO_WEBFETCH | Le WebFetch de l'agent n'est plus intercepté ni compacté. Indépendant de TOKENADE_NO_WEBSEARCH. | non définie |
TOKENADE_NO_GREP | La sortie de Grep/Glob n'est plus compactée. | non définie |
TOKENADE_NO_GLOB | Le hook de résultat Glob n'écrit rien ; les listes passent telles quelles. | non définie |
TOKENADE_NO_MCP_HOOK | Les résultats des outils MCP tiers ne sont plus compactés par le hook (n'importe quelle valeur). | non définie |
TOKENADE_NO_CODE_STRIP | Les fichiers source que Tokenade lit pour l'agent gardent leurs commentaires. | non définie |
TOKENADE_FORCE_BYPASS | 1 autorise tokenade raw à relancer une commande qu'il refuse sinon de relancer parce que sa sortie est déjà en réserve. | non définie |
TOKENADE_NO_SESSION_COMPACT | Au démarrage de session, Tokenade ne raccourcit plus les transcriptions dont le cache de prompt a expiré. | non définie |
TOKENADE_NO_PRECOMPACT_MASK | 1 : juste avant que Claude Code compacte une session, Tokenade ne replie plus les gros résultats d'outils que le résumé lirait. | non définie |
TOKENADE_MAX_CACHE_TTL_SECS | La durée de vie du cache de prompt, en secondes, que Tokenade suppose avant de raccourcir une transcription inactive (au démarrage de session, à la reprise et dans tokenade compact-sessions). Prise telle quelle, plus 5 minutes de marge : une valeur sous 3600 peut raccourcir une session dont le cache d'une heure est encore chaud. Non définie, Tokenade lit cette durée dans chaque transcription. | non définie |
TOKENADE_NO_AUTO_UPDATE | Saute la vérification de mise à jour en arrière-plan (toutes les 24 h). tokenade upgrade --off rend ce choix permanent par un fichier marqueur. | non définie |
TOKENADE_NO_STAR_INVITE | Masque la ligne affichée une seule fois, après tokenade install ou dans tokenade dashboard, qui invite à mettre une étoile au dépôt GitHub. Elle n'apparaît de toute façon jamais hors d'un terminal ni en CI. | non définie |
TOKENADE_NO_STATUSLINE | L'installation et l'auto-réparation ne branchent pas le ticker dans le statusLine de Claude Code (n'importe quelle valeur). TOKENADE_STATUSLINE=0 (ou false, off, no) fait de même. | non définie |
TOKENADE_AUTOCOMPACT | 0, false ou off empêche tokenade install de régler le seuil d'auto-compaction de l'agent. | activé |
TOKENADE_NO_COLOR | Pas de couleur dans les bannières du tableau de bord (n'importe quelle valeur). La variable standard NO_COLOR est aussi respectée. | couleur sur un terminal |
Installation
| Variable | Effet | Défaut |
|---|---|---|
TOKENADE_ALLOW_ROOT | Autorise tokenade install sous sudo. Sans elle, l'installation refuse : des hooks écrits dans /root ne sont jamais vus par votre propre agent. | non définie (refus) |
TOKENADE_AUTOCOMPACT_PCT | Pourcentage de la fenêtre de contexte auquel l'agent est invité à s'auto-compacter. Plage acceptée 10–95 ; une valeur hors plage est ignorée. Le drapeau --autocompact-pct de tokenade install passe devant. | 70 |
TOKENADE_CONFIG_DIR | Dossier de l'état de la vérification de mise à jour (update-check.json, auto-update-off). Une valeur vide ou une coquille booléenne comme 1 est ignorée. | ~/.tokenade |
TOKENADE_DEBUG_LOG | Chemin du journal de débogage (JSON, une ligne par événement). tokenade install le règle sur ~/.tokenade/debug.log dans les commandes de hook, sauf avec --no-debug-log. Le fichier tourne à 16 Mio en gardant les 8 derniers Mio ; l'ancien devient debug.log.1. | posée par l'installation |
TOKENADE_HTTP_TIMEOUT_MS | Délai par requête de l'installeur npm lorsqu'il télécharge le binaire. | 30000 |
TOKENADE_UPDATE_ENDPOINT | URL de base où la vérification de mise à jour et tokenade upgrade vont chercher le manifeste signé et les binaires, pour passer par un miroir. | dernière GitHub Release |
Quantité de sortie repliée
| Variable | Effet | Défaut |
|---|---|---|
TOKENADE_READ_MODE | Part des longues listes et lectures gardée en clair : aggressive (moins), task (défaut), reference (davantage), entropy (garde les lignes les plus informatives, dans l'ordre). Vérifiez la valeur active avec tokenade read-mode. | task |
TOKENADE_DISCLOSE_THRESHOLD | Taille en tokens au-delà de laquelle une sortie incidente (commande, page web) est mise en réserve et remplacée par un résumé. | 5000 |
TOKENADE_READ_DISCLOSE_THRESHOLD | Même chose pour les fichiers que l'agent lit délibérément. | 25000 |
TOKENADE_RAW_BUDGET | Plafond en tokens d'une réponse tokenade expand-ref --raw avant qu'elle propose de reprendre. --budget 0 sur la commande rend toujours tout. | 60000 |
TOKENADE_IMAGE_MAX_EDGE | Grand côté, en pixels, auquel les images sont réduites avant lecture par l'agent. 0 désactive la réduction ; les valeurs de 1 à 63 sont ignorées. | 1024 |
TOKENADE_CACHE_HINTS | Option : préfixe la sortie des compacteurs d'un marqueur pour le cache de prompt, retiré dès qu'il rendrait la sortie plus grosse que l'entrée brute. | désactivé |
TOKENADE_MCP_LEAN_SCHEMA | Option, valeur 1 : mcp-wrap retire aussi les champs description des schémas d'entrée des outils MCP. | désactivé |
Emplacements de stockage
| Variable | Effet | Défaut |
|---|---|---|
TOKENADE_STASH_DIR | Où les sorties complètes sont mises en réserve pour expand-ref. | ~/.cache/tokenade/stash (voir Fichiers et chemins pour Windows) |
TOKENADE_STASH_MAX_DIR_BYTES | Taille maximale de la réserve ; au-delà, les entrées les plus anciennes sont évincées. Les entrées expirent aussi après 7 jours. | 2147483648 (2 Gio) |
TOKENADE_MODEL_DIR | Dossier qui contient déjà le modèle d'embeddings de semantic et --prompt. Si la variable est posée et que les fichiers manquent, Tokenade renvoie une erreur au lieu de télécharger. | non définie (téléchargement dans le cache) |
TOKENADE_MODEL_NO_HF | Ignore Hugging Face et télécharge le modèle uniquement depuis les GitHub Releases du projet (archive signée). | non définie (Hugging Face d'abord) |
TOKENADE_MODEL_HF_BASE | Hôte d'où télécharger le modèle à la place de Hugging Face (un miroir). Les fichiers restent vérifiés contre les empreintes intégrées au binaire. | https://huggingface.co |
Documents, médias et execute
| Variable | Effet | Défaut |
|---|---|---|
TOKENADE_OCR_LANG | Pack(s) de langue Tesseract pour l'OCR, par exemple eng+fra. | eng |
TOKENADE_WHISPER_MODEL | Modèle Whisper utilisé pour transcrire l'audio et la vidéo (tiny, base, small, medium…). | base |
TOKENADE_WHISPER_TIMEOUT_SECS | Durée maximale d'une transcription. | 900 |
TOKENADE_MAX_INPUT_BYTES | Limite de lecture des entrées qui ne sont pas des fichiers ordinaires (tubes, périphériques). | 1073741824 (1 Gio) |
TOKENADE_EXEC_SANDBOX | 1 exécute chaque script tokenade execute sous bubblewrap (système de fichiers en lecture seule, /tmp inscriptible), comme --sandbox. Refuse de s'exécuter si bwrap est absent. | désactivé |
TOKENADE_EXEC_SANDBOX_NET | 1 garde l'accès réseau dans ce bac à sable, comme --sandbox-net. | désactivé |
Masquage des secrets
Tokenade masque les secrets dans tout ce qu'il rend à l'agent. Ces interrupteurs règlent les passes optionnelles :
| Variable | Effet | Défaut |
|---|---|---|
TOKENADE_REDACT_PII | Masque aussi adresses e-mail, numéros de téléphone, adresses IP et MAC. Désactivé par défaut parce qu'elles apparaissent sans cesse dans des sorties ordinaires (git log, docker inspect). | désactivé |
TOKENADE_NO_REDACT_PAN | Désactive le masquage des numéros de carte et CVV. | activé |
TOKENADE_NO_REDACT_ENTROPY | Désactive la passe à forte entropie qui attrape les formats de jetons inconnus. | activé |
Pour ces trois variables, toute valeur non vide autre que 0 compte comme posée.
Montants en dollars
TOKENADE_PRICE_INPUT_PER_MTOK, TOKENADE_PRICE_CACHE_PER_MTOK et TOKENADE_PRICE_OUTPUT_PER_MTOK fixent le prix par million de tokens appliqué aux lignes sans modèle connu et à la valeur en dollars des économies estimées (3 $, 0,30 $ et 15 $ par défaut). Elles ne changent que les estimations en dollars de tokenade gain et du tableau de bord, jamais ce qui est compacté. Voir Comment les économies sont mesurées.