# Utiliser Crush : guide pas à pas de l’agent de code de Charm

URL: https://agentvera.dev/fr/blog/how-to-use-crush/ · Publié: 2026-11-17

Utiliser Crush, l’agent de code de Charm pour le terminal : installation, fournisseur ou modèle local, approbation des outils, crush run, sessions et crushrc.

**En bref:**

- Installez avec brew install charmbracelet/tap/crush, npm install -g @charmland/crush ou winget install charmbracelet.crush, lancez crush dans un projet, choisissez un modèle (Ctrl+L) et collez une clé ou connectez-vous.
- Crush demande avant chaque appel d’outil et permet d’autoriser un outil pour toute la session. crush run gère les tâches ponctuelles et l’entrée via pipe ; crush -C ou crush -s <id> reprend une session.
- Depuis la v0.88, la configuration tient dans un fichier crushrc (du Bash avec des commandes Crush) ; crush.json marche encore mais est déprécié. Crush lit AGENTS.md, CRUSH.md et CLAUDE.md tout seul.

Pour utiliser Crush, l’agent de code de Charm, installez-le avec `brew install charmbracelet/tap/crush` (ou via npm, winget et d’autres), lancez `crush` dans un projet, appuyez sur `Ctrl+L` pour choisir un modèle, collez une clé API ou connectez-vous, puis décrivez la tâche. **Crush demande avant d’exécuter des outils, et depuis la version 0.88 ses réglages se trouvent dans un fichier `crushrc` plutôt que dans `crush.json`.**

Ce guide couvre Crush en novembre 2026 (version 0.101) : installation, fournisseurs et modèles locaux, interface, approbations, `crush run`, sessions, configuration, fichiers de contexte, MCP et coût.

## Ce qu’est Crush

Crush est un agent de code pour le terminal signé [Charm](https://github.com/charmbracelet "Charm sur GitHub"), l’équipe derrière Bubble Tea et d’autres outils de terminal, et cela se voit : c’est l’une des interfaces les plus soignées de la catégorie. Il fonctionne avec presque n’importe quel modèle : Anthropic, OpenAI, Gemini, OpenRouter, Groq, xAI, Bedrock, Vertex, Azure, des modèles locaux et Hyper, le service maison de Charm. Vous pouvez changer de modèle en pleine session sans perdre le contexte.

Crush n’a pas encore atteint la version 1.0 et publie une version mineure environ chaque semaine, avec des builds nightly entre deux. Sa licence est FSL-1.1-MIT : le code source est public et chaque version passe sous licence MIT plus tard, mais ce n’est pas aujourd’hui une licence open source au sens de l’OSI.

## Étape 1 : installer

```bash
brew install charmbracelet/tap/crush      # macOS and Linux
npm install -g @charmland/crush           # any platform with Node
winget install charmbracelet.crush        # Windows
go install github.com/charmbracelet/crush@latest
```

Il existe aussi des paquets pour Arch (`yay -S crush`), Nix, FreeBSD et Scoop, ainsi que des dépôts apt et yum sur repo.charm.sh. Crush tourne sur macOS, Linux, Windows (PowerShell et WSL) et les BSD.

## Étape 2 : choisir un modèle

```bash
cd my-project
crush
```

Appuyez sur `Ctrl+L` pour ouvrir le sélecteur de modèles, choisissez un fournisseur et collez sa clé. Crush lit aussi les clés dans l’environnement, par exemple `ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GEMINI_API_KEY` ou `OPENROUTER_API_KEY`. Pour utiliser un abonnement plutôt qu’une clé, lancez `crush login` avec `copilot`, `openai` (un forfait ChatGPT), `grok` ou `hyper`.

Pour un modèle local, ajoutez un fournisseur dans votre configuration (étape 6) :

```bash
provider add ollama --type ollama --base-url "http://localhost:11434/v1/"
```

Crush récupère sa liste de modèles depuis Catwalk, un catalogue communautaire qui se met à jour tout seul ; `crush models` montre ce qui est disponible et `crush update-providers` le rafraîchit.

## Étape 3 : travailler dans une session

Décrivez la tâche avec vos mots. Les touches à apprendre en premier :

- `Ctrl+P` (ou `/`) ouvre la palette de commandes : résumer la session, initialiser le projet, activer ou désactiver serveurs MCP et skills, changer de thème.
- `Ctrl+L` change de modèle ; `Ctrl+N` démarre une nouvelle session et `Ctrl+S` liste les sessions.
- `@` mentionne un fichier ; `Ctrl+F` ajoute un fichier ou une image ; `Ctrl+V` colle une image.
- `Shift+Tab` fait défiler les modes, dont le mode Plan, où Crush établit les étapes avant de modifier quoi que ce soit.
- `Ctrl+O` ouvre votre éditeur pour un long message ; `Ctrl+G` affiche l’aide ; `Ctrl+C` quitte.

## Étape 4 : approbations et mode yolo

Crush demande avant chaque appel d’outil. Dans la boîte de dialogue, `a` l’autorise une fois, `s` autorise cet outil pour le reste de la session, `d` le refuse et `t` affiche le diff. Les commandes en lecture seule comme `ls` ou `git status` s’exécutent sans demander.

Pour ne plus être sollicité au sujet des outils de confiance, autorisez-les dans votre configuration ; pour masquer complètement un outil, refusez-le :

```bash
permissions allow view ls grep edit
permissions deny bash
```

`crush --yolo` (ou `-y`, ou `Ctrl+Y` dans une session) saute les demandes mais bloque toujours les commandes que Crush juge dangereuses. `-yy` active le mode sysadmin, qui les autorise aussi. Réservez les deux aux conteneurs et aux machines jetables.

## Étape 5 : crush run pour les tâches ponctuelles

```bash
crush run "add a unit test for the price formatter"
git diff | crush run "review this diff for bugs"
cat README.md | crush run "tighten the wording" > README.new.md
```

`-m` choisit le modèle (`provider/model`), `-q` masque l’indicateur de progression, et `-s <id>` ou `-C` poursuit une session. `crush run` n’a pas d’option de sortie JSON : pour des résultats structurés, demandez le format dans le prompt et vérifiez-le.

## Étape 6 : crushrc et configuration

Depuis la version 0.88, Crush lit ses réglages dans un fichier `crushrc` : un script Bash contenant des commandes Crush, exécuté par l’interpréteur propre à Crush pour se comporter de la même façon sous Windows. Il cherche `.crushrc` ou `crushrc` dans le projet et `~/.config/crush/crushrc` au niveau global, puis fusionne ce qu’il trouve, le projet ayant le dernier mot. Un petit exemple :

```bash
model large anthropic/claude-sonnet-5-5
model small anthropic/claude-haiku-5-5
permissions allow view ls grep
mcp add docs --type http --url https://example.com/mcp
lsp add go --command gopls
```

`crush.json` et `.crush.json` fonctionnent encore, mais ils sont dépréciés et ne reçoivent plus de nouvelles fonctionnalités. `crush dirs` indique où Crush range sa configuration et ses données.

Un avertissement : un `crushrc`, c’est du code. Tout ce qui se trouve dans `$(...)` s’exécute au démarrage de Crush ; lisez donc le fichier avant de lancer Crush dans un dépôt que vous ne connaissez pas.

## Étape 7 : AGENTS.md, MCP et LSP

**Fichiers de contexte.** Crush lit `AGENTS.md`, `CRUSH.md`, `CLAUDE.md`, `GEMINI.md`, `.cursorrules` et `.github/copilot-instructions.md` sans aucune configuration, ainsi que `~/.config/crush/CRUSH.md` pour tous les projets. **Initialize Project**, dans la palette de commandes, examine le dépôt et rédige un `AGENTS.md`. Notre guide sur [CLAUDE.md et AGENTS.md](/fr/blog/claude-md-agents-md/ "CLAUDE.md et AGENTS.md") explique quoi y mettre.

**MCP.** Crush prend en charge les serveurs stdio, HTTP et SSE, y compris la connexion OAuth. Ajoutez-les avec `mcp add` dans `crushrc` et activez-les ou désactivez-les depuis la palette.

**LSP.** Les serveurs de langage donnent à Crush les mêmes diagnostics que ceux de votre éditeur. Ajoutez-en un avec `lsp add`, ou laissez `option auto-lsp` s’en charger.

## Combien coûte Crush (en novembre 2026)

| Option | Prix | Remarques |
|---|---|---|
| Crush | Gratuit | Avec vos propres clés ou des modèles locaux |
| Hyper à l’usage | Dès 5 $ prépayés | Modèles à poids ouverts hébergés par Charm |
| Forfaits mensuels Hyper | De 10 $ à 200 $ par mois | Crédits hebdomadaires avec une fenêtre glissante de 5 heures |
| Votre propre clé | Le prix de votre fournisseur | Anthropic, OpenAI, Gemini, OpenRouter et d’autres |

Crush envoie par défaut des métriques d’usage pseudonymes ; définissez `CRUSH_DISABLE_METRICS=1` ou `DO_NOT_TRACK=1` pour les désactiver.

## Pièges courants

- **Suivre des guides crush.json.** La plupart des tutoriels antérieurs à août 2026 ne montrent que du JSON. Cela marche encore, mais les nouvelles options arrivent dans `crushrc`.
- **Yolo a changé en v0.100.** `--yolo` bloque désormais les commandes dangereuses au lieu de demander ; les scripts qui comptaient sur l’ancien comportement peuvent avoir besoin de `-yy`.
- **Trailers de commit.** Crush ajoute par défaut un trailer `Assisted-by` aux commits. Modifiez-le avec `option attribution-trailer-style`.
- **Presse-papiers sous Linux.** Le copier-coller nécessite `wl-copy` ou `xclip`/`xsel`.
- **Où sont les logs.** `crush logs --tail 50` montre ce qui a échoué ; les logs se trouvent dans le dossier `.crush` du projet.

## Faire tourner Crush à côté d’autres CLI dans AgentVera

Si Crush est votre seul agent, son interface peut vous suffire. Les choses se compliquent quand Crush tourne à côté de Claude Code, Codex ou Gemini CLI sur le même projet. [AgentVera](/fr/ "AgentVera") est une application de bureau qui exécute ces CLI côte à côte dans de vrais terminaux, avec vos propres installations et clés. La [prise en charge de Crush](/fr/agents/crush/ "Crush dans AgentVera") fonctionne ainsi :

- **Une session par agent.** AgentVera retrouve la session créée par Crush via `crush session list --json` et la rouvre avec `--session <id>` aux lancements suivants, si bien que la conversation survit à un redémarrage de l’application.
- **Un compte par agent.** Chaque compte Crush dans Réglages → Comptes a son propre dossier de données et son propre `crush login`, et vous pouvez ajouter des clés Anthropic, OpenAI, OpenRouter ou Gemini.
- **MCP et conflits.** Les serveurs du [gestionnaire MCP](/fr/features/mcp-manager/ "Gestionnaire MCP") d’AgentVera atteignent Crush via sa configuration, et AgentVera ajoute son propre hook pour voir quels fichiers chaque agent touche.
- **Volets et revue.** Faites tourner Crush dans la grille du [workspace](/fr/features/workspace/ "Workspace") à côté d’autres agents et vérifiez leurs modifications avec la [revue de code](/fr/features/code-review/ "Revue de code").

L’offre gratuite exécute 2 agents à la fois et comprend MCP, Git, Docker, SSH, la revue de code et les économies de tokens. Pro coûte 9,99 $ par mois, sans limite d’agents ; si vous n’avez jamais eu d’essai, votre première connexion à l’application active Pro pendant 7 jours, sans carte. Pour essayer, [téléchargez AgentVera](/fr/download/ "Télécharger AgentVera").

## En résumé

Démarrer avec Crush se fait en deux étapes : l’installer et lancer `crush`, puis choisir un modèle avec `Ctrl+L`. Ensuite, les réglages qui comptent sont dans `crushrc` : quels outils peuvent s’exécuter sans demander, quels modèles utiliser pour les grosses et les petites tâches, et quels serveurs MCP et de langage charger. Gardez un `AGENTS.md` dans le projet, et Crush, comme la plupart des autres agents, le suivra.

Sources : [Crush sur GitHub](https://github.com/charmbracelet/crush "README de Crush"), [documentation de configuration](https://github.com/charmbracelet/crush/tree/main/docs/config "Configuration de Crush"), [versions](https://github.com/charmbracelet/crush/releases "Versions de Crush"), [licence](https://github.com/charmbracelet/crush/blob/main/LICENSE.md "Licence de Crush"), [Hyper](https://hyper.charm.land "Hyper par Charm").

## Questions fréquentes

**Crush est-il gratuit ?** Crush ne coûte rien à l’usage : vous apportez vos propres clés API ou un modèle local. Charm vend aussi Hyper, un fournisseur hébergé de modèles à poids ouverts, avec des forfaits mensuels de 10 $ à 200 $ ou du crédit prépayé dès 5 $ en novembre 2026. Crush est sous FSL-1.1-MIT, une licence source-available dont les versions passent sous MIT plus tard.

**Crush fonctionne-t-il avec des modèles locaux ?** Oui. Ajoutez un fournisseur Ollama, LM Studio, llama.cpp ou LiteLLM dans crushrc, par exemple provider add ollama --type ollama --base-url "http://localhost:11434/v1/", et Crush détecte ses modèles.

**Comment reprendre une session Crush ?** crush -C (ou --continue) rouvre la session la plus récente du projet, et crush -s <id> en rouvre une précise. crush session list les affiche, et Crush indique la commande de reprise quand vous quittez.

**Crush lit-il CLAUDE.md ou AGENTS.md ?** Les deux. Crush lit AGENTS.md, CRUSH.md, CLAUDE.md, GEMINI.md, .cursorrules et .github/copilot-instructions.md s’ils existent. Initialize Project, dans la palette de commandes, rédige un AGENTS.md pour vous.

**Que fait crush --yolo ?** Il saute les demandes d’approbation mais bloque toujours les commandes que Crush juge dangereuses. -yy (mode sysadmin) les autorise aussi. Réservez les deux aux environnements jetables.

---

**À propos d’AgentVera.** AgentVera est une app de bureau pour macOS, Windows et Linux, développée par Solviera Teknoloji. Elle exécute 18 agents de code IA (Claude Code, Codex, Gemini CLI, Copilot, Cursor, Antigravity, opencode, Hermes, Qwen Code, Kimi Code, Kiro, Amp, Droid, Goose, Vibe, Crush, Aider, Cline) côte à côte, par projet, dans de vrais terminaux avec les installations et connexions CLI de l’utilisateur. L’offre gratuite exécute 2 agents en même temps. Télécharger: https://agentvera.dev/fr/download/ · Tarifs: https://agentvera.dev/fr/pricing/
