# Variables d'environnement

> Toutes les variables TOKENADE_* destinées aux utilisateurs : leur effet, leur valeur par défaut, et où les poser pour que les hooks de l'agent les voient.

Source: https://tokenade.net/fr/docs/environment-variables · Updated: 2026-11-19

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 `env` de `~/.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 lancez `tokenade 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`](https://tokenade.net/fr/docs/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](https://tokenade.net/fr/docs/files-and-paths) 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](https://tokenade.net/fr/docs/savings-measurement).

## Voir aussi

- [Fichiers et chemins](https://tokenade.net/fr/docs/files-and-paths)
- [Compacteurs et filtres personnalisés](https://tokenade.net/fr/docs/custom-compactors)
- [Comment les hooks interceptent les appels d'outils](https://tokenade.net/fr/docs/hooks)
- [Dépannage](https://tokenade.net/fr/docs/troubleshooting)
