# Claude Code (CLI et desktop)

> Ce que tokenade install écrit pour Claude Code, la confiance du dossier qui coupe les hooks, la vérification et la désinstallation, Desktop inclus.

Source: https://tokenade.net/fr/docs/claude-code · Updated: 2026-10-07

Claude Code profite de toute la couverture de Tokenade grâce aux hooks : chaque commande shell, lecture de fichier, recherche, récupération web et résultat MCP peut être replié avant d'atteindre le modèle. `tokenade install` le configure dès qu'il trouve Claude Code, y compris la copie intégrée à l'onglet Code de Claude Desktop. La seule étape qui vous revient : accepter la demande de confiance de Claude Code dans chaque dossier où vous travaillez.

## Ce que l'installation écrit

Tous les chemins sont dans votre dossier personnel : `~` sous Linux et macOS, `%USERPROFILE%` sous Windows. Si `CLAUDE_CONFIG_DIR` est défini, Tokenade utilise ce dossier à la place de `~/.claude`. Avec `--per-project`, il écrit dans `./.claude/` du dossier courant.

| Fichier | Ce que Tokenade ajoute |
|---|---|
| `~/.claude/settings.json` | Des groupes de hooks étiquetés `_tag: "tokenade…"`, l'indicateur d'économies `statusLine`, et le seuil d'auto-compaction (`autoCompactWindow` plus `env.CLAUDE_CODE_AUTO_COMPACT_WINDOW`) |
| `~/.claude/CLAUDE.md` | Une courte section de règles Tokenade, pour que l'agent connaisse les commandes `tokenade` |
| `.mcp.json`, `~/.claude.json` | Les serveurs MCP tiers, réécrits pour démarrer derrière `tokenade mcp-wrap` (à éviter avec `--no-wrap-mcps`) |
| Dossier courant | Les fichiers de règles du projet (`CLAUDE.md`, `AGENTS.md`…) préparés à l'installation |

Vos propres hooks, serveurs MCP et règles sont conservés. Une `statusLine` que vous aviez déjà est enveloppée, pas remplacée ; `tokenade statusline off` la désactive.

### Les hooks

| Événement | Rôle |
|---|---|
| PreToolUse | Réécrit une commande shell en `tokenade wrap '<cmd>'`, redirige les grosses lectures et les appels web vers des versions repliées, prend un instantané avant une modification |
| PostToolUse | Replie les sorties de commandes, les lectures de fichiers, les résultats de recherche et les pages récupérées ; garde l'index du code à jour après modification |
| SessionStart | Contexte de session (par exemple les [impasses](https://tokenade.net/fr/docs/mistakes) récentes) |
| UserPromptSubmit | Note de style avant chaque demande |
| PreCompact | S'exécute avant que Claude Code compacte la conversation |
| SubagentStop | Résultats des sous-agents |

Chaque hook est sans échec bloquant : si Tokenade plante ou est absent, le hook se termine proprement et votre agent continue comme si Tokenade n'était pas là. Le fonctionnement de chaque hook est décrit dans [Comment les hooks interceptent les appels d'outils](https://tokenade.net/fr/docs/hooks).

`--no-hook` saute les hooks PostToolUse et d'indexation Edit/Write. `--autocompact-pct <N>` change le seuil (10-95, 70 par défaut) ; `--no-autocompact` retire celui posé par Tokenade.

## Acceptez la demande de confiance du dossier

Claude Code n'exécute **aucun hook** dans une session interactive ouverte dans un dossier dont vous n'avez pas accepté la demande de confiance. Les hooks de Tokenade y sont ignorés sans bruit, comme tous les autres. Les exécutions non interactives (`claude -p`) ne sont pas concernées.

Quand Claude Code vous demande si vous faites confiance au dossier, acceptez. Depuis la 1.2.1, `tokenade healthcheck`, lancé depuis ce dossier, vous prévient :

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

Tokenade n'accorde jamais cette confiance à votre place. Il vérifie aussi `disableAllHooks` dans `~/.claude/settings.json` : s'il vaut `true`, aucun hook ne tourne.

## Claude Desktop

**Onglet Code.** Il exécute Claude Code lui-même et lit les mêmes réglages `~/.claude` : mêmes hooks, même couverture. Depuis la 1.2.1, `tokenade install` le configure même sans commande `claude` dans votre PATH, en examinant la copie de Claude Code fournie avec l'app (dans le dossier de données de l'app : `~/.config/Claude` sous Linux, `~/Library/Application Support/Claude` sous macOS, `%APPDATA%\Claude` sous Windows, ou le dossier propre à la version Microsoft Store).

**Chat.** Le chat n'exécute ni commande locale ni lecture de fichier : seule l'optimisation MCP s'applique. `tokenade install` enveloppe les serveurs déclarés dans `claude_desktop_config.json` :

| Système | Fichier |
|---|---|
| Linux | `~/.config/Claude/claude_desktop_config.json` |
| macOS | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Windows | `%APPDATA%\Claude\claude_desktop_config.json` |
| Windows (Microsoft Store) | `%LOCALAPPDATA%\Packages\Claude_…\LocalCache\Roaming\Claude\claude_desktop_config.json` |

Pour les envelopper de nouveau plus tard : `tokenade mcp-wrap install`. Redémarrez Claude Desktop après un changement. Voir [Envelopper les serveurs MCP](https://tokenade.net/fr/docs/mcp-wrap).

**Claude Cowork** tourne dans un environnement isolé que les outils locaux ne peuvent pas atteindre. Il n'est pas pris en charge.

## Vérifier

```bash
tokenade hooks status     # chaque hook Claude Code installé
tokenade hooks tail       # les 20 derniers déclenchements, lus dans ~/.tokenade/debug.log
tokenade healthcheck      # hook_installed, wrapped_mcps, confiance du dossier
```

Utilisez ensuite Claude Code quelques minutes et consultez vos économies avec `tokenade dashboard` (un rapport local dans votre navigateur). Voir [votre première session](https://tokenade.net/fr/docs/first-session).

## Désactiver ou retirer

| Objectif | Commande |
|---|---|
| Couper les hooks pour une session ou un shell | Définir `TOKENADE_HOOK_DISABLED=1` dans l'environnement d'où démarre Claude Code |
| Lancer une commande sans compaction | `tokenade raw <cmd>` |
| Restaurer seulement les entrées MCP d'origine | `tokenade unwrap-mcps` |
| Retirer l'indicateur de la barre d'état | `tokenade statusline off` |
| Tout retirer | `tokenade uninstall` |

`tokenade uninstall` restaure d'abord les serveurs MCP enveloppés, retire le bloc Tokenade de `~/.claude/CLAUDE.md` (après une sauvegarde), supprime chaque groupe de hooks `_tag: "tokenade*"` de `~/.claude/settings.json`, puis efface les données propres à Tokenade. Prévisualisez avec `tokenade uninstall --dry-run`. Voir [Mettre à jour et désinstaller](https://tokenade.net/fr/docs/upgrade-uninstall).

## Voir aussi

- [Comment les hooks interceptent les appels d'outils](https://tokenade.net/fr/docs/hooks)
- [Agents pris en charge et compatibilité](https://tokenade.net/fr/docs/compatibility)
- [style et statusline](https://tokenade.net/fr/docs/style-statusline)
- [Dépannage](https://tokenade.net/fr/docs/troubleshooting)
- Article : [Réduire la consommation de tokens de Claude Code](https://tokenade.net/fr/articles/reduce-claude-code-token-usage)
- Article : [Les hooks de Claude Code](https://tokenade.net/fr/articles/claude-code-hooks)
