Documentation / Configuration
Variables d'environnement
Mis à jour le
TL;DR — Tokenade fonctionne sans aucune configuration. Les variables ci-dessous coupent une fonction précise (TOKENADE_HOOK_DISABLED=1, TOKENADE_NO_WEBSEARCH=1…) ou ajustent seuils et chemins. Posez-les là où l'agent démarre, pas seulement dans votre shell.
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 1.2.2.
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_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_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_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_STATUSLINE_PROMOS | 0, false, off ou no masque le message tournant du ticker et garde les chiffres. Équivaut à tokenade statusline promos off. | messages affichés |
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 et compte
| 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 des fichiers de licence et de compte (license.key, machine-id, quota.json, l'état de l'envoi d'usage, l'état de la vérification de mise à jour). 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 |
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é |
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 downloads.tokenade.net (archive signée). | non définie (Hugging Face d'abord) |
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é à un modèle dont Tokenade ne connaît pas le tarif. 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.