# Utiliser Cline CLI : guide pas à pas de Cline dans le terminal

URL: https://agentvera.dev/fr/blog/how-to-use-cline-cli/ · Publié: 2026-11-15

Utiliser Cline CLI : installer via npm, se connecter ou ajouter sa clé, passer de Plan à Act, lancer en headless avec --json, reprendre une session, règles et MCP.

**En bref:**

- Installez via npm install -g cline, lancez cline auth pour vous connecter à un compte Cline ou ajouter votre propre clé fournisseur, puis lancez cline dans un projet et décrivez la tâche. Tab bascule entre Plan et Act.
- Les demandes d’approbation sont désactivées par défaut : --auto-approve vaut true, et les lancements ponctuels ou via pipe passent en mode yolo. Ajoutez --auto-approve false pour que Cline demande avant chaque outil.
- La CLI est gratuite ; l’inférence se paie en crédits Cline, avec ClinePass (9,99 $ par mois en novembre 2026) ou vos clés API. Règles dans .clinerules/ ou AGENTS.md, serveurs MCP dans cline_mcp_settings.json.

Pour utiliser Cline CLI, installez-le avec `npm install -g cline`, lancez `cline auth` pour vous connecter ou ajouter une clé de fournisseur, puis lancez `cline` dans un projet et décrivez la tâche. **Contrairement à la plupart des CLI de code, Cline approuve lui-même ses appels d’outils par défaut : passez `--auto-approve false` sur tout dépôt auquel vous tenez.**

Ce guide couvre Cline CLI 3.0 en novembre 2026 (version 3.0.74) : installation, connexion, Plan et Act, approbations, lancements headless avec `--json`, sessions, modèles, règles, MCP et coût.

## Ce qu’est Cline CLI

[Cline](https://cline.bot "Cline") a débuté comme extension VS Code et compte parmi les agents de code ouverts les plus utilisés. Cline CLI amène le même agent dans le terminal. La version 3.0, sortie en mai 2026, est une réécriture sur le nouveau SDK de Cline avec une nouvelle interface de terminal : les guides écrits pour la CLI 2.x sont donc dépassés.

Cline n’est lié à aucun modèle. Vous pouvez utiliser un compte Cline avec des crédits, un abonnement ClinePass, ou votre propre clé pour Anthropic, OpenAI, Gemini, OpenRouter, Bedrock, Vertex, DeepSeek, un modèle local via Ollama ou LM Studio, et plus de trente autres fournisseurs.

## Étape 1 : installer la CLI

```bash
npm install -g cline
```

C’est la seule méthode d’installation officielle. Des binaires précompilés existent pour macOS, Linux et Windows, en arm64 comme en x64 ; utilisez Node 22 par sécurité, car la documentation et le paquet ne s’accordent pas sur la version minimale. Pour mettre à jour plus tard : `cline update`. Si vous voulez la toute dernière build, `npm install -g cline@nightly` installe le canal nightly.

## Étape 2 : se connecter ou ajouter une clé

```bash
cline auth
```

Cette commande ouvre une configuration interactive. `cline auth cline` vous connecte à un compte Cline dans le navigateur. Pour définir un fournisseur sans questions, par exemple sur un serveur :

```bash
cline auth -p anthropic -k "$ANTHROPIC_API_KEY" -m claude-sonnet-5-5
```

Cline lit aussi les clés dans l’environnement (`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `OPENROUTER_API_KEY`, `CLINE_API_KEY` et d’autres). Les identifiants enregistrés vont dans `~/.cline/data/settings/providers.json`.

## Étape 3 : travailler dans la vue interactive

```bash
cd my-project
cline
```

Décrivez la tâche avec vos mots, ou démarrez directement avec : `cline -i "add tests for the price formatter"`. Touches et commandes utiles :

- `Tab` bascule entre **Plan** et **Act**. Le mode Plan lit et discute mais ne peut pas modifier de fichiers ; le mode Act, celui par défaut, applique les changements. `cline -p` démarre en Plan.
- `Shift+Tab` active ou désactive l’approbation automatique.
- `@file` ajoute un fichier (ou une image) au message.
- `/model` et `/settings` modifient la configuration ; `/mcp` gère les serveurs ; `/compact` raccourcit une longue conversation ; `/undo` annule le dernier changement ; `/history` ouvre les anciennes sessions.
- `Ctrl+C` arrête le tour en cours ; appuyez deux fois, ou sur `Ctrl+D`, pour quitter.

Une bonne habitude pour les grosses tâches : commencer en Plan, se mettre d’accord sur les étapes, puis passer en Act.

## Étape 4 : décider de ce que Cline peut faire seul

C’est le réglage qui surprend le plus. Dans Cline CLI :

| Situation | Ce qui se passe |
|---|---|
| `cline` (interactif) | `--auto-approve` est activé sauf si vous le désactivez |
| `cline --auto-approve false` | Demande `Approve tool …? [y/N]` avant chaque outil |
| `cline "task"` (ponctuel) ou entrée via pipe | Tourne en mode yolo |
| `cline -y` | Mode yolo ; l’aide de Cline le juge elle-même dangereux hors d’un sandbox |

Il n’existe pas de liste d’autorisation ou d’interdiction pour les commandes shell. Pour bloquer une commande, ajoutez un hook `PreToolUse` (étape 7). Sur un vrai dépôt, démarrez avec `--auto-approve false` ou travaillez sur une branche propre, pour pouvoir jeter facilement chaque changement.

## Étape 5 : lancements headless et CI

Cline tourne sans la vue interactive quand vous passez `--json`, lui envoyez quelque chose via un pipe ou redirigez sa sortie :

```bash
git diff | cline "review this diff for bugs"
cline --json "summarize the changes on this branch" | jq -r 'select(.type=="run_result") | .text'
```

`--json` affiche un événement JSON par ligne et se termine par un `run_result` qui contient le texte final, la raison de fin et la consommation de tokens. Autres flags à connaître : `-c` définit le dossier de travail, `--worktree` lance dans un git worktree, `-t` fixe un délai en secondes et `--data-dir` garde l’état dans un dossier isolé.

En CI, installez via npm, lancez `cline auth` avec une clé tirée du coffre de secrets, puis lancez la tâche. N’oubliez pas que les lancements ponctuels approuvent tout : donnez au job uniquement les permissions dont il a besoin.

## Étape 6 : sessions et modèles

`cline history` liste les anciennes sessions dans un sélecteur où vous pouvez les reprendre ou les supprimer. Pour en rouvrir une directement :

```bash
cline history --json --limit 10
cline --id <session-id>
```

Les sessions sont stockées dans `~/.cline/data/sessions/`. `cline history export <session-id> -o session.html` en enregistre une sous forme de page.

Pour choisir un modèle le temps d’un lancement, utilisez `-P` pour le fournisseur et `-m` pour le modèle ; `--thinking` accepte `none`, `low`, `medium`, `high` ou `xhigh`. Dans la vue interactive, utilisez `/model`. Avec un compte Cline et sans modèle choisi, le modèle par défaut est Claude Sonnet 5.5 depuis la version 3.0.73.

## Étape 7 : règles, hooks et serveurs MCP

**Règles.** Placez les règles du projet dans `.clinerules/` ou `.cline/rules/`, et les règles globales dans `~/.cline/rules`. Cline lit aussi `AGENTS.md` à la racine du projet : un fichier que vous tenez déjà pour Codex ou d’autres agents fonctionne tel quel. Notre guide sur [CLAUDE.md et AGENTS.md](/fr/blog/claude-md-agents-md/ "CLAUDE.md et AGENTS.md") explique quoi y mettre.

**Skills et hooks.** Les skills se trouvent dans `.cline/skills/` ou `.agents/skills/` et se lancent avec `/skill-name` ; `cline skill add <owner/repo>` en installe un. Les hooks sont des scripts exécutables nommés d’après l’événement, comme `.cline/hooks/PreToolUse.sh`, et c’est avec eux qu’on bloque les commandes risquées.

**MCP.** Ajoutez des serveurs en ligne de commande :

```bash
cline mcp add memory --yes -- npx -y @modelcontextprotocol/server-memory
cline mcp add docs https://example.com/mcp --transport http --yes
```

Ils sont enregistrés sous `mcpServers` dans `~/.cline/data/settings/cline_mcp_settings.json`. `cline mcp` ouvre un menu, et `cline mcp remove <name>` en supprime un.

## Combien coûte Cline CLI (en novembre 2026)

| Option | Prix | Remarques |
|---|---|---|
| Cline CLI | Gratuit | L’outil lui-même |
| Crédits Cline | À l’usage | Achetés sur app.cline.bot ; quelques modèles gratuits avec un petit quota |
| ClinePass | 9,99 $/mois | Limites plus hautes sur une sélection de modèles ouverts |
| Votre propre clé | Le tarif de votre fournisseur | Anthropic, OpenAI, OpenRouter, modèles locaux et plus |
| Enterprise | Sur mesure | SSO, SLA, accès par rôles, facturation centralisée |

Consultez la [page de tarifs de Cline](https://cline.bot/pricing "Tarifs de Cline") avant de choisir.

## Pièges courants

- **L’approbation automatique est activée par défaut.** Désactivez-la avec `--auto-approve false` tant que vous n’avez pas confiance dans la configuration.
- **Suivre des guides 2.x.** La réécriture 3.0 a changé les commandes et les flags. En cas de doute, lancez `cline --help` pour votre version ; quelques flags, comme `-y`, manquent dans la référence en ligne.
- **OAuth en headless.** Les fournisseurs OAuth n’ouvrent jamais de navigateur lors des lancements headless. Lancez d’abord une fois `cline auth <provider>` sur cette machine.
- **Processus d’arrière-plan bloqués.** `cline doctor` vérifie la configuration, et `cline doctor fix` arrête les processus orphelins.
- **`.clineignore` est en voie de disparition.** Utilisez un hook `PreToolUse` pour tenir Cline à l’écart de certains fichiers.

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

Si Cline est le seul agent que vous utilisez, sa propre interface suffit peut-être. Les choses se compliquent quand Cline 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 Cline](/fr/agents/cline/ "Cline CLI dans AgentVera") fonctionne ainsi :

- **Une session par agent.** AgentVera repère la session créée par Cline grâce à `cline history --json` et la rouvre avec `cline --id <id>` aux lancements suivants : la conversation survit à un redémarrage de l’application.
- **Modèle et effort.** Le modèle choisi est transmis avec `--model` et le niveau d’effort avec `--thinking`.
- **Un compte par agent.** Dans Réglages → Comptes, vous pouvez ajouter des clés Anthropic, OpenAI ou OpenRouter ; chaque compte Cline a son propre fichier de fournisseurs, et tout le reste est partagé.
- **MCP et tokens.** Les serveurs du [gestionnaire MCP](/fr/features/mcp-manager/ "Gestionnaire MCP") d’AgentVera parviennent à Cline via son fichier de réglages MCP, et AgentVera lit la consommation de tokens de Cline pour les [budgets de tokens](/fr/features/token-budgets/ "Budgets de tokens").
- **Volets et revue.** Faites tourner Cline 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é

Trois commandes suffisent pour démarrer avec Cline CLI : `npm install -g cline`, `cline auth` et `cline`. Les choix qui comptent viennent juste après : désactivez l’approbation automatique sur du vrai travail, planifiez avant d’agir sur les grosses tâches, gardez les règles du projet dans `AGENTS.md` ou `.clinerules/`, et ne donnez aux lancements ponctuels en CI que les accès dont ils ont besoin.

Sources : [référence de Cline CLI](https://docs.cline.bot/cli/cli-reference "Référence de Cline CLI"), [présentation de la CLI](https://docs.cline.bot/usage/cli-overview "Présentation de Cline CLI"), [autorisation](https://docs.cline.bot/getting-started/authorizing-with-cline "Autorisation avec Cline"), [règles Cline](https://docs.cline.bot/customization/cline-rules "Règles Cline"), [MCP](https://docs.cline.bot/mcp/mcp-overview "Cline MCP"), [changelog de la CLI](https://github.com/cline/cline/blob/main/apps/cli/CHANGELOG.md "Changelog de Cline CLI").

## Questions fréquentes

**Cline CLI est-il gratuit ?** La CLI elle-même ne coûte rien. Vous payez le modèle : des crédits Cline achetés sur app.cline.bot, un abonnement ClinePass (9,99 $ par mois en novembre 2026, pour une sélection de modèles ouverts) ou votre propre clé API chez Anthropic, OpenAI, OpenRouter et bien d’autres fournisseurs. Certains modèles gratuits viennent avec un petit quota.

**Cline CLI demande-t-il avant de modifier des fichiers ?** Pas par défaut. --auto-approve vaut true, et un lancement ponctuel comme cline "task" tourne en mode yolo. Démarrez avec --auto-approve false pour obtenir une question oui/non à chaque outil, ou activez et désactivez l’approbation automatique avec Shift+Tab dans la vue interactive.

**Comment reprendre une session Cline CLI ?** Lancez cline history pour choisir une ancienne session dans une liste, ou cline --id <session-id> pour la rouvrir directement. cline history --json liste les sessions avec leurs identifiants, ce qui est pratique dans les scripts.

**Cline CLI lit-il AGENTS.md ?** Oui. En plus de ses propres dossiers de règles (.clinerules/ ou .cline/rules/ dans le projet, ~/.cline/rules au niveau global), Cline lit AGENTS.md à la racine du projet, ainsi que .cursorrules et .windsurfrules.

**Puis-je utiliser mon abonnement Claude Code ou ChatGPT avec Cline CLI ?** Parmi ses fournisseurs, Cline propose un fournisseur Claude Code et une connexion ChatGPT (openai-codex). Vérifiez les conditions du fournisseur avant d’utiliser un abonnement via un autre outil.

---

**À 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/