# Installer Tokenade

> Installez Tokenade avec npm sous Linux, macOS ou Windows, puis lancez tokenade install pour le brancher sur chaque agent de code détecté.

Source: https://tokenade.net/fr/docs/install · Updated: 2026-10-16

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.

```bash
npm install -g @tokenade/cli
tokenade install
```

C'est tout : rien à activer. Tokenade est gratuit et open source (MIT/Apache-2.0) ; le code est sur [GitHub](https://github.com/pi-infected/tokenade).

Vous préférez laisser faire votre agent ? Collez ceci dans votre agent de code : « Install Tokenade for me: read https://tokenade.net/install.md and follow the instructions. »

## 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 |

## 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 depuis la [GitHub Release](https://github.com/pi-infected/tokenade/releases) correspondante, vérifie la signature Ed25519 du manifeste de la release, compare le SHA-256 de l'archive à celui de ce manifeste signé, 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 :

```bash
tokenade --version
```

```text
tokenade 2.0.1
```

## Passer de la 1.x à la 2.0

Si la mise à jour automatique est active (c'est le réglage par défaut), votre installation 1.x passe d'elle-même en 2.0. Sinon, lancez :

```bash
npm i -g @tokenade/cli@latest
```

Les fichiers de licence et de compte laissés par la 1.x sont supprimés pendant la mise à jour.

## Ce que fait `tokenade install`

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

1. Détecte les agents de code installés (Claude Code, Codex, Cursor, Copilot CLI, OpenCode, Kilo Code et les autres listés dans [compatibilité](https://tokenade.net/fr/docs/compatibility)).
2. 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.
3. É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.
4. Fait passer vos serveurs MCP tiers par `tokenade mcp-wrap`, pour replier leurs gros résultats. Voir [Envelopper les serveurs MCP](https://tokenade.net/fr/docs/mcp-wrap).
5. Met en place le [proxy LLM](https://tokenade.net/fr/docs/llm-proxy) 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.
6. 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](https://tokenade.net/fr/docs/claude-code), [Codex](https://tokenade.net/fr/docs/codex), [Cursor](https://tokenade.net/fr/docs/cursor), [Copilot](https://tokenade.net/fr/docs/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 :

```text
✗ 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
  (intentional root install: TOKENADE_ALLOW_ROOT=1 tokenade install)
```

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

### Prévisualiser avant d'écrire

```bash
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 |

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.

```bash
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 :

```bash
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](https://tokenade.net/fr/docs/upgrade-uninstall).

## Voir aussi

- [Vérifier que ça marche : première session](https://tokenade.net/fr/docs/first-session)
- [Agents pris en charge et compatibilité](https://tokenade.net/fr/docs/compatibility)
- [Mettre à jour et désinstaller](https://tokenade.net/fr/docs/upgrade-uninstall)
- [Variables d'environnement](https://tokenade.net/fr/docs/environment-variables)