Tutoriel Cline CLI : installation, cline auth, plan/act et subagents
La nouvelle CLI autonome de Cline installe le même agent plan/act dans votre terminal. Ce guide pas à pas couvre l'installation, la configuration d'un fournisseur avec cline auth, les flags de tâche et l'activation des subagents dans VS Code — avec une image de la vidéo à chaque étape.
En bref
- Installez une fois avec npm install -g cline, puis tapez cline dans n'importe quel dossier de projet pour ouvrir une session interactive.
- Les sessions interactives démarrent en plan mode ; tapez /act quand vous voulez des modifications, /plan pour revenir, ou passez --mode pour une exécution ponctuelle.
- cline auth est le centre de contrôle des comptes et des modèles : compte Cline, Cline ou fournisseurs bring-your-own comme OpenRouter — à relancer quand vous voulez.
- Les subagents vivent dans l'extension VS Code : installez la CLI, cliquez sur Enable Subagents dans le panneau Cline, et Cline lance des instances headless dans le terminal pour chercher en parallèle.
Cline CLI & Sub Agents: Cline is back with a new CLI Agent, but is it good?
Chaîne : AICodeKing8:03
Introducing Cline CLI 2.0
Chaîne : Cline1:42
Cline CLI — official documentation
Docs : docs.cline.bot
Les captures viennent de la démo propre (terminal et VS Code) de la review d'AICodeKing — aucune caméra dans la vidéo, seul l'écran de fin a été écarté. Les commandes et flags ont été recoupés avec la documentation officielle de Cline et son annonce de lancement.
Les images appartiennent à leurs créateurs respectifs et sont créditées ici avec des liens profonds vers l'instant exact ; le texte est de nous.
Configurer la Cline CLI, étape par étape
Découvrir la CLI, l'installer, connecter un fournisseur
- 1
Savoir ce que la CLI est (et n'est pas)
La documentation de Cline présente la CLI comme une compagne de l'IDE, pas un remplacement : le même noyau d'agent, conçu pour piloter de nombreux agents en parallèle, entièrement scriptable et doté d'une interface de chat commode. Modes plan & act, checkpoints, exécution terminal et usage headless sont au programme — tout ce que vous savez de l'extension VS Code se transpose.
La page What's Special About Cline CLI dans la doc officielle.Voir à 1:18 - 2
Voir à quoi elle sert
L'article de lancement collecte des idées venues du Discord : des PNJ de jeu qui écrivent leurs souvenirs dans des fichiers, une app mobile de télécommande, un bot Discord propulsé par Cline, Cline dans des scripts shell et Cline dans GitHub issues pour trier les bug reports automatiquement. Rien de tout cela n'est requis pour démarrer — mais cela explique pourquoi la CLI est headless et scriptable par conception.
Des idées d'usage pour la CLI, tirées de l'annonce de lancement.Voir à 1:48 - 3
Installer la CLI
Lancez npm install -g cline dans n'importe quel terminal (Node.js requis). La même commande apparaît dans la bannière Cline for CLI is here de VS Code, avec un bouton copier. Une fois npm terminé, la commande cline est disponible partout.
La commande d'installation officielle dans l'annonce de la CLI Preview.Voir à 4:30 - 4
La lancer dans un dossier de projet
cd vers un projet et tapez cline. Un encadré de bienvenue affiche la version preview, le fournisseur et le modèle actifs, et un badge plan mode ; en dessous, Start a new Cline task attend votre première instruction. La barre du bas sert de mémo raccourcis : alt+enter ou ctrl+j pour une nouvelle ligne, ctrl+e ouvre votre éditeur pour les longs prompts, enter envoie.
Premier lancement : l'encadré de bienvenue et la saisie de nouvelle tâche.Voir à 3:36 - 5
Connecter un fournisseur avec cline auth
Une installation toute fraîche ne connaît ni compte ni modèle. Lancez cline auth et l'assistant d'autorisation apparaît : s'authentifier avec un compte Cline, choisir le fournisseur actif (Cline ou bring-your-own), configurer un fournisseur d'API ou quitter. Dans la démo, le modèle actif est anthropic/claude-sonnet-4.5 via OpenRouter. Un changement d'avis plus tard ? C'est toujours cline auth.
L'assistant cline auth avec les options de compte et de fournisseur.Voir à 3:49
Plan, act et les flags headless
- 6
Attendez-vous au plan mode d'abord
Envoyez un bonjour et Cline répond avec un plan au lieu de toucher aux fichiers — les sessions interactives démarrent en plan mode, dédié à la collecte d'informations et à la conception. La réponse se termine par tokens et coût, puis l'invite affiche [plan mode] Cline is ready for your message...
Une première réponse en plan mode, coût et indices de mode compris.Voir à 4:24 - 7
Passer en act avec /act
Tapez /act et la session bascule en act mode, où Cline peut modifier des fichiers et exécuter des commandes ; /plan ramène en arrière. Pour les tâches ponctuelles, fixez plutôt le mode de départ avec -m/--mode, et la référence actuelle de la CLI liste aussi -p/--plan pour les exécutions qui planifient d'abord.
![Terminal cursor pointing at the /plan or /act to switch modes hint below the [plan mode] Cline is ready for your message input in the Cline CLI](/images/guides/cline-cli-tutorial/cline-cli-tutorial-plan-act-switch-hint.webp "Terminal cursor pointing at the /plan or /act to switch modes hint below the [plan mode] Cline is ready for your message input in the Cline CLI")
L'indice /plan or /act se trouve juste sous la saisie.Voir à 4:16 - 8
Apprendre les flags headless
La section INSTANT TASK OPTIONS de la référence est l'antisèche : -o (--oneshot) exécute une tâche en pleine autonomie puis quitte, -y (--yolo) coupe toute demande interactive et clôt automatiquement, -s surcharge un réglage pour cette seule tâche, -m fixe le mode de départ. Les flags ont évolué depuis le lancement — la référence actuelle rabat oneshot/yolo sur --auto-approve et -p/--plan ; faites cline -h pour voir ce que votre version gère.
Instant task options : oneshot, yolo, réglages par tâche et mode.Voir à 4:35
Les subagents depuis l'extension VS Code
- 9
Mettre à jour l'extension et repérer la bannière
Les subagents arrivent avec l'extension VS Code, nouveau en v4.106.0. Mettez Cline à jour, ouvrez le panneau, et le changelog plus la bannière Cline for CLI is here! apparaissent — avec l'extrait npm install -g cline et la note selon laquelle Cline peut lancer des commandes cline dans des sous-processus séparés pour garder propre la fenêtre de contexte principale.
La bannière CLI dans le panneau Cline de VS Code.Voir à 5:25 - 10
Cliquer sur Enable Subagents
Le deuxième bouton de la bannière, Enable Subagents, active la fonction dans les feature settings de l'extension. C'est l'étape qui échoue sans la CLI : les subagents fonctionnent en lançant des instances headless de cline dans votre terminal, donc npm install -g cline doit avoir été exécuté avant.
Installed et Enable Subagents côte à côte dans le panneau.Voir à 5:32 - 11
Demander un subagent
Donnez à l'agent principal une tâche qui récompense l'exploration — dans la démo : Spin up a sub agent that tells me about the repo. Cline raisonne sur la demande et dépêche un subagent de lui-même quand la recherche parallèle aide ; vous pouvez aussi le demander explicitement.
L'agent principal prépare le lancement d'un sub agent.Voir à 5:42 - 12
Approuver le prompt en attente
Avant toute exécution, le panneau affiche Cline wants to use a subagent avec le prompt exact qu'il compte envoyer — ici, une analyse de dépôt en cinq points couvrant l'objectif, la stack, les fonctionnalités, le modèle de données et les patterns d'implémentation. Approuvez (ou laissez l'auto-approve faire) et le subagent tourne en headless, renvoyant un rapport au lieu de remplir la fenêtre de contexte principale.
Le prompt de subagent en attente, point par point.Voir à 5:46
Cline CLI ou extension VS Code de Cline : laquelle, quand
Les deux surfaces font tourner le même agent Cline avec les modes plan et act ; le choix porte donc sur l'endroit où vous voulez l'agent, pas sur ce qu'il sait faire.
- 1Le développement au quotidien : restez dans l'extension. Panneau, diffs, checkpoints et contexte de l'éditeur sont à portée de main dans VS Code.
- 2Automatisation et corvées répétitives : la CLI. Prompts ponctuels, scripts shell, GitHub Actions, bots Discord ou Slack — les exécutions headless avec des flags comme -o et -y sont sa raison d'être.
- 3Sessions mixtes : l'état voyage. Une tâche peut démarrer dans le terminal et continuer dans l'IDE (et inversement) ; le plan esquissé en terminal devient un après-midi d'éditions dans VS Code.
- 4Les subagents exigent les deux : l'extension orchestre pendant que la CLI exécute. Le bouton Enable Subagents ne fonctionne qu'avec la CLI installée — tout le mécanisme est là.
Si vous n'en prenez qu'une, prenez celle qui colle à votre façon de travailler ; installer la CLI coûte une commande npm et débloque l'interrupteur des subagents dans tous les cas.
Les subagents en pratique : prompts, limites, correctifs
Les subagents ont été la vedette de cette version — et le point où le premier essai déraille. Ce que montre la démo, plus ce qu'ajoute la doc actuelle :
- 1Pas de bouton Enable Subagents ? Mettez d'abord l'extension en v4.106.0 ou plus récent — le bouton vit dans la bannière Cline for CLI, et la CLI doit être installée sinon rien ne se lance.
- 2Aucun subagent ne se lance ? Demandez-le explicitement ("spin up a sub agent to..."). D'après la doc actuelle, les subagents sont des chercheurs en lecture seule : lire des fichiers, chercher et lancer des commandes sûres oui — modifier des fichiers, le navigateur ou MCP non, et ils n'appellent pas d'autres subagents.
- 3Ça a tourné — et maintenant ? Chaque subagent renvoie un rapport pointant les chemins trouvés, et les stats par agent (appels d'outils, tokens, coût) s'affichent dans le chat pour auditer ce que l'escouade a fait.
- 4Las des approbations ? Les lancements de subagents suivent la permission auto-approve « Read project files » — activez-la et les prompts ne bloquent plus, le prompt complet restant visible dans le panneau.
- 5Le comportement a changé depuis la vidéo ? Au lancement, c'était un toggle expérimental des feature settings ; la doc actuelle décrit les subagents comme activés par défaut, réglables via Settings → Features, avec un jeu de flags consolidé (--auto-approve, -p/--plan) dans la référence CLI. Quand la doc et une vieille review se contredisent, croyez la doc.
Traitez les subagents comme un amplificateur de recherche, pas comme une armée de codeurs : ils compressent une heure de lecture de codebase en un rapport, et c'est toujours l'agent principal qui écrit.