Installer Tokenade

Pour installer Tokenade, installez le paquet npm en global, puis lancez une fois tokenade install avec votre utilisateur habituel. La première commande dépose le binaire sur la machine ; la seconde le branche sur les agents de code qu'elle trouve.

npm install -g @tokenade/cli
tokenade install

Reliez ensuite la machine à votre compte avec tokenade login (voir Se connecter et activer une machine).

Prérequis

Node.js 18 ou plus récent (seulement pour l'installeur npm ; Tokenade lui-même est un binaire natif).
Une des plateformes prises en charge :

Système	Architectures
Linux	x64 (glibc et musl), arm64 (musl)
macOS	Apple Silicon (arm64), Intel (x64)
Windows	x64, arm64

Un compte tokenade.net gratuit, utilisé à l'étape login. L'offre gratuite ne demande pas de carte ; le détail des offres est sur la page des tarifs.

Ce que fait le paquet npm

@tokenade/cli déclare une dépendance optionnelle par plateforme. npm installe celle qui correspond à votre machine, et l'étape postinstall l'utilise directement (tokenade provided by @tokenade/cli-... — no download needed).

Si ce paquet de plateforme manque, postinstall télécharge à la place le binaire indiqué dans le manifeste de version publié sur downloads.tokenade.net, vérifie son SHA-256 par rapport au manifeste, et contrôle qu'il s'agit bien d'un exécutable pour votre système avant de le garder.

Le téléchargement respecte vos réglages de proxy et a un délai d'expiration :

Variable	Effet
`HTTPS_PROXY`, `HTTP_PROXY`, `ALL_PROXY` (et leurs formes en minuscules)	Fait passer le téléchargement par votre proxy
`NO_PROXY` / `no_proxy`	Hôtes qui contournent le proxy
`TOKENADE_HTTP_TIMEOUT_MS`	Délai par requête en millisecondes (`30000` par défaut)

Les erreurs réseau sont retentées ; une réponse 4xx (hors 429) ou une somme de contrôle fausse ne l'est pas.

Vérifiez le binaire :

tokenade --version

tokenade 1.2.2

Ce que fait `tokenade install`

tokenade install ne demande aucune configuration. En un passage, il :

Détecte les agents de code installés (Claude Code, Codex, Cursor, Copilot CLI, OpenCode, Kilo Code et les autres listés dans compatibilité).
Branche Tokenade sur chacun par le mécanisme propre à l'agent : des hooks pour Claude Code, Codex, Cursor, Copilot CLI, Qwen Code, Grok, Droid et la CLI d'Antigravity ; un plugin ou une extension pour OpenCode, Kilo Code, Cline, Hermes, Pi et OpenClaw.
Écrit une courte section de règles Tokenade dans le fichier de règles global que charge chaque agent (par exemple ~/.claude/CLAUDE.md ou ~/.codex/AGENTS.md), et prépare les règles du projet dans le dossier courant.
Fait passer vos serveurs MCP tiers par tokenade mcp-wrap, pour replier leurs gros résultats. Voir Envelopper les serveurs MCP.
Met en place le proxy LLM local pour un agent seulement là où il apporte une fonction que les hooks de l'agent ne peuvent pas fournir (par exemple Codex tant que ses hooks ne sont pas approuvés). Il écoute sur 127.0.0.1 et indique comment l'annuler.
Active ~/.tokenade/debug.log, que lit tokenade hooks tail.

Chaque fichier de configuration modifié est fusionné, jamais remplacé : vos propres hooks, serveurs MCP et règles restent en place. La page de chaque agent liste les fichiers exacts : Claude Code, Codex, Cursor, Copilot.

N'utilisez pas sudo

Lancez tokenade install sous votre propre utilisateur. Sous sudo, la commande refuse, car elle écrirait dans /root et votre agent ne verrait jamais les hooks :

✗ running under sudo: this would install into /root, not your own HOME —
your AI agent would never see the hooks (and everything would LOOK fine).
Re-run WITHOUT sudo: tokenade install

Pour une installation volontaire en root, définissez TOKENADE_ALLOW_ROOT=1.

Prévisualiser avant d'écrire

tokenade install --dry-run

--dry-run affiche chaque fichier qui serait modifié, y compris les entrées de confiance du config.toml de Codex, et n'écrit rien.

Options d'installation

Option	Effet
`--yes`, `-y`	Répond oui aux demandes de nettoyage destructif
`--dry-run`	Affiche ce qui serait fait, ne change rien
`--only <agent>`	Limite l'installation à un seul agent
`--per-project`	Installe dans `./.<agent>/` au lieu de votre dossier personnel
`--profile <name>`	Utilise un modèle de CLAUDE.md adapté à un domaine
`--no-cleanup`	Saute la passe de correction des outils incompatibles
`--no-debug-log`	N'active pas `~/.tokenade/debug.log`
`--debug-log <path>`	Emplacement personnalisé du journal de débogage
`--autocompact-pct <N>`	Demande à l'agent de compacter automatiquement à N % de sa fenêtre de contexte (10-95, 70 par défaut)
`--no-autocompact`	Retire le seuil posé par Tokenade (une valeur réglée à la main n'est pas touchée)
`--no-hook`	Saute les hooks Claude Code PostToolUse et d'indexation Edit/Write
`--no-wrap-mcps`	Ne fait pas passer les serveurs MCP tiers par `tokenade mcp-wrap`
`--with-claude-md`	Ajoute un CLAUDE.md adapté au framework (Next.js, FastAPI, Rust…)
`--with-brevity-skill`	Ajoute une consigne de réponses brèves dans CLAUDE.md (peut dégrader le raisonnement sur les tâches complexes)
`--defaults`	Oublie les choix mémorisés lors des installations précédentes
`--ref <code>`	Enregistre un code de parrainage

Noms d'agents acceptés par --only : claude-code, codex, cursor, copilot, kilo-code, opencode, cline, hermes, pi, openclaw, qwen-code, antigravity, grok, droid, aider, t3-code, devin-desktop (windsurf est un alias obsolète de devin-desktop). --only restreint les agents détectés à un seul : si cet agent n'est pas trouvé sur la machine, l'installation s'arrête et propose le nom détecté le plus proche.

tokenade install --only claude-code # Claude Code seulement
tokenade install --per-project # ./.claude/ au lieu de ~/.claude/

Choix mémorisés

L'installation retient les exclusions et choix que vous passez (--no-hook, --only, --per-project, --no-debug-log, --debug-log, --no-autocompact, --no-wrap-mcps, --profile, --with-*). Chaque installation, mise à jour et auto-réparation ultérieure les réutilise. Pour repartir des valeurs par défaut :

tokenade install --defaults

Autres outils d'économie de tokens

L'installation cherche aussi les autres outils d'économie de tokens qui entrent en conflit avec Tokenade et propose des corrections. Lancez cette vérification seule avec tokenade incompatibilities, ou sautez la passe de correction avec --no-cleanup.

Relancer l'installation

tokenade install est idempotent. Relancez-le après avoir installé un nouvel agent, ou quand tokenade healthcheck signale un manque. Les mises à jour rafraîchissent d'elles-mêmes hooks et plugins ; voir Mettre à jour et désinstaller.