# Vérifier que ça marche : première session

> Vérifiez que Tokenade est branché sur votre agent : tokenade healthcheck, une session, puis les économies dans tokenade dashboard.

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

Pour vérifier que Tokenade fonctionne, lancez `tokenade healthcheck`, utilisez votre agent normalement quelques minutes, puis regardez `tokenade hooks tail` et `tokenade dashboard`. Si les hooks se déclenchent et que le registre des économies grossit, Tokenade fait son travail. Inutile de changer votre façon de rédiger vos demandes.

## 1. Lancer le bilan de santé

```bash
tokenade healthcheck
```

`healthcheck` (alias `health` et `doctor`) vérifie l'installation et affiche une ligne par contrôle. Les lignes `OK` passent, les lignes `--` sont informatives, et une ligne en échec est marquée `!!` et indique sa correction. Exemple abrégé :

```text
─── tokenade healthcheck ───

  OK  gain ledger writable at ~/.tokenade/gain.jsonl
  OK  all agent-config hook paths resolve
  OK  every hook runs the same tokenade binary
  OK  installed hook commands match the expected tokenade shape
  OK  Codex hooks trusted — compaction active (6 hook(s))
  OK  agent detected: claude-code
```

Le code de sortie `0` signifie que tous les contrôles passent (certains peuvent afficher des lignes `--` purement informatives) ; `1` signifie qu'au moins un contrôle a échoué. Pour les scripts et la CI, utilisez `tokenade healthcheck --json` : chaque contrôle porte un `id` stable (par exemple `binary`, `gain_ledger`, `agent_detect`, `hook_installed`, `mcp_entry`, `wrapped_mcps`, `semantic_model`, `stale_mcp_procs`).

Les lignes à surveiller en priorité :

- `gain ledger writable` : Tokenade peut enregistrer vos économies en local.
- Une ligne par agent branché, par exemple `opencode plugin active — tool-result compaction firing` ou `Codex hooks trusted`.

### Claude Code : acceptez la demande de confiance du dossier

Claude Code n'exécute aucun hook, ceux de Tokenade compris, dans une session interactive ouverte dans un dossier dont vous n'avez pas accepté la demande de confiance. Depuis la 1.2.1, `healthcheck` le signale :

```text
  --  Claude Code has not trusted /path/to/project — in an interactive session here, it runs none of its hooks (tokenade's included)
       accept the trust prompt when Claude Code opens this folder; `claude -p` runs are not affected
```

Ouvrez le dossier dans Claude Code et acceptez la demande. Voir [Claude Code](https://tokenade.net/fr/docs/claude-code).

## 2. Voir quel agent Tokenade détecte

```bash
tokenade detect
```

```text
claude-code
coverage: hooks (PostToolUse) — command output is compacted and the saving is measured
mcp config hint: .mcp.json (third-party servers only)
```

La ligne `coverage:` décrit le canal qu'utilise ce type d'agent, pas le fait qu'il soit installé sur votre machine. C'est `healthcheck` qui répond à cette seconde question.

## 3. Utiliser votre agent

Ouvrez une session comme d'habitude et confiez à l'agent une tâche qui produit de la sortie : lancer les tests, un build, `git log`, lire un gros fichier, chercher sur le web. Rien ne change de votre côté. Les sorties longues arrivent au modèle repliées, avec une courte bannière qui indique à l'agent comment récupérer les octets complets s'il en a besoin (voir [La compaction des sorties et le stash](https://tokenade.net/fr/docs/compaction)).

## 4. Regarder les hooks se déclencher

```bash
tokenade hooks status    # hooks Claude Code installés
tokenade hooks tail      # les 20 derniers déclenchements, lus dans ~/.tokenade/debug.log
tokenade hooks tail 50   # les 50 derniers
```

`hooks status` liste chaque hook installé avec son événement, puis l'activité récente : combien de fois les hooks se sont déclenchés, et quand pour la dernière fois.

Si la liste d'activité reste vide alors que vous avez utilisé l'agent, les hooks ne tournent pas : voir [Dépannage](https://tokenade.net/fr/docs/troubleshooting).

## 5. Consulter vos économies

```bash
tokenade dashboard
```

`dashboard` (alias `dash` et `stats`) lit le registre local des économies (`~/.tokenade/gain.jsonl`) et ouvre un rapport local dans votre navigateur : choisissez une période, puis détaillez par fonction, agent, projet et modèle. Pour un résumé rapide dans le terminal :

```bash
tokenade gain                # opérations, tokens avant et après, détail par opération
tokenade gain --history      # une ligne par entrée du registre, après le résumé
tokenade gain --by-source    # répartition par source : cli / hook / mcp / proxy
```

Tout ce qu'affichent `gain` et `dashboard` est calculé sur votre machine. La façon dont les chiffres sont comptés, et ce qui en est exclu, est expliquée dans [Comment les économies sont mesurées](https://tokenade.net/fr/docs/savings-measurement).

## Toujours rien ?

1. Relancez `tokenade install` : il est idempotent et répare les hooks manquants.
2. Vérifiez que vous n'avez pas lancé l'installation avec `sudo` (elle écrirait dans `/root`, et refuse par défaut).
3. Vérifiez que `TOKENADE_HOOK_DISABLED` n'est pas défini dans l'environnement de votre agent.
4. Vérifiez les étapes propres à votre agent : confiance du dossier pour [Claude Code](https://tokenade.net/fr/docs/claude-code), approbation des hooks pour [Codex](https://tokenade.net/fr/docs/codex).

## Voir aussi

- [Installer Tokenade](https://tokenade.net/fr/docs/install)
- [Agents pris en charge et compatibilité](https://tokenade.net/fr/docs/compatibility)
- [gain, dashboard et receipt](https://tokenade.net/fr/docs/gain-dashboard-receipt)
- [Dépannage](https://tokenade.net/fr/docs/troubleshooting)
