N-Gage Formation Claude

Claude Code

Claude Code en ligne de commande (CLI)

Statut : stable Plan minimum : Pro Démo : 5-10 min Vérifié le : 2026-05-17

Source officielle : https://code.claude.com/docs/en/quickstart

Claude Code en ligne de commande (CLI)

TL;DR

Un assistant agentique installé sur votre poste, lancé depuis le terminal avec la commande claude : il lit votre projet, modifie vos fichiers, exécute des commandes, et discute avec vous, sans quitter la console. Là où Claude.ai donne la recette, Claude Code cuisine pour vous. Vous gardez la main : chaque action sensible (écriture, exécution, suppression) passe par une demande de validation explicite.

Pour qui c'est utile

Quatre profils en tirent le maximum :

  • Développeurs qui veulent éviter le copier-coller entre une fenêtre de chat et leur éditeur, et qui acceptent que l'agent touche directement leurs fichiers (avec validation).
  • Ops et SRE qui passent leurs journées en terminal et veulent un assistant qui lit les logs, génère des scripts shell, débugue une config Docker ou Nginx sans changer d'environnement.
  • Data engineers qui manipulent des pipelines, des notebooks, des fichiers Parquet ou CSV, et qui veulent un agent capable d'exécuter du Python ou du SQL en local pour explorer la donnée.
  • Power users à l'aise dans un terminal (consultants techniques, formateurs, freelances) qui automatisent des tâches récurrentes (refactor d'un projet, génération de docs, audit de code, scripts maison) et qui veulent rester dans leur flux.

Le point commun : un projet qui vit déjà dans un dossier local, et l'envie de ne pas passer par une interface web pour le manipuler.

Comprendre Claude Code en CLI (la mécanique sous le capot)

Cinq différences notables par rapport à Claude.ai web, qui changent complètement la façon de travailler :

Un agent dans le terminal, pas une fenêtre de chat. Quand vous tapez claude, vous ouvrez une session interactive directement dans votre console. Claude voit votre invite, vos sorties shell, vos erreurs. Vous voyez ses raisonnements et ses propositions d'action.

Lit et écrit des fichiers, exécute des commandes. Là où Claude.ai vous renvoie du texte que vous devez recoller, Claude Code propose d'éditer le fichier directement, de lancer la commande dans votre shell, ou de modifier la config. Vous voyez la diff, vous validez, il applique.

Toujours une demande de validation pour les actions sensibles. Modifier un fichier, exécuter une commande shell, supprimer un dossier : Claude demande explicitement avant. Vous pouvez accepter, refuser, ou répondre par un commentaire pour ajuster. Cette boucle de validation est le mécanisme de sécurité central.

Session attachée au dossier courant. Quand vous lancez claude depuis ~/projets/site-web, l'agent considère ce dossier comme son périmètre de travail. Il y lit les fichiers, y exécute les commandes, y stocke sa mémoire de conversation. Si vous changez de dossier (cd ~/projets/api) et relancez claude, vous travaillez sur un autre projet avec une autre mémoire. Un dossier = un contexte de travail.

Mode interactif vs mode script. claude ouvre une session interactive (vous dialoguez). claude -p "votre prompt" exécute un prompt unique en mode "print", affiche la réponse, et rend la main au shell. Le mode -p est précieux dans un script bash, un alias, ou un pipeline (par exemple cat erreurs.log | claude -p "résume les 3 problèmes principaux").

À retenir : Claude Code n'est pas une « version terminal » de Claude.ai. C'est un agent local avec accès à votre système de fichiers et à votre shell, qui hérite de votre identité (votre login, vos permissions, vos credentials shell).

Quand Claude Code CLI brille vs Cowork vs Desktop Code

Le CLI brille dans ces cas : - Vous vivez déjà en terminal et n'avez pas envie d'ouvrir une interface graphique - Votre projet est local (code, scripts, configs, données plates) - Vous voulez intégrer Claude dans un pipeline ou un script via claude -p - Vous travaillez en SSH sur un serveur distant (le CLI fonctionne très bien en remote) - Vous voulez le maximum de contrôle sur les permissions et les hooks

Cowork (interface visuelle Pro+) est plus adapté quand : - Vous voulez voir le rendu d'une page web, d'un dashboard, ou d'un design en parallèle du chat - Vous travaillez sur un livrable visuel (slides, document, image) - Vous préférez l'interface graphique au terminal

Desktop Code (même moteur dans Claude Desktop) est plus adapté quand : - Vous voulez la puissance agentique de Claude Code sans la barrière du terminal - Vous mélangez plusieurs surfaces (chat, Projects, Skills) dans la même application - Vous travaillez sur un Mac ou Windows avec un workflow déjà bien intégré à Claude Desktop

Les trois partagent le même moteur agentique. Le choix est une question d'ergonomie et de contexte de travail, pas de fonctionnalités.

Pas à pas détaillé

Installer Claude Code

  1. Ouvrez un terminal sur votre poste : Terminal sur macOS, PowerShell ou CMD sur Windows (Claude Code recommande PowerShell), Bash ou Zsh sous Linux ou WSL.
  2. Lancez la commande d'installation correspondant à votre système : - macOS, Linux, WSL : curl -fsSL https://claude.ai/install.sh | bash - Windows PowerShell : irm https://claude.ai/install.ps1 | iex - Alternative macOS via Homebrew : brew install --cask claude-code - Alternative Windows via Winget : winget install Anthropic.ClaudeCode
  3. L'installeur télécharge le binaire natif, l'installe dans un dossier utilisateur (~/.local/bin sur Linux/macOS, %LOCALAPPDATA%\Programs sur Windows) et met à jour votre PATH. Fermez et rouvrez votre terminal pour que le PATH soit pris en compte.

Vérifier l'installation

  1. Tapez claude --version. Vous devez voir un numéro de version (ex. claude 1.0.42). Si la commande n'est pas trouvée, votre PATH n'a pas été mis à jour : rouvrez votre terminal ou suivez les instructions affichées par l'installeur.
  2. En cas de doute, lancez claude doctor : ce diagnostic vérifie votre version, votre login, la connectivité réseau, et signale les problèmes courants (PATH, permissions, version Node si applicable).

Se connecter

  1. Placez-vous dans un dossier projet : cd /chemin/vers/votre/projet. C'est important : la session sera attachée à ce dossier.
  2. Tapez claude. Au premier lancement, l'agent affiche une URL d'authentification. Copiez-la dans votre navigateur, connectez-vous avec votre compte Claude Pro, Max, Team ou Enterprise, et autorisez l'accès.
  3. Revenez dans le terminal : le message « Logged in » apparaît, suivi de l'écran d'accueil de la session.

Premier prompt

  1. Tapez votre premier message en langage naturel. Quelques idées pour démarrer : - que fait ce projet ? - liste les fichiers principaux et explique l'architecture - y a-t-il un README ? Résume-le-moi en 5 lignes
  2. Claude lit les fichiers utiles (il vous montre lesquels), puis répond. Si vous lui demandez de modifier quelque chose, il propose une diff que vous validez (y pour accepter, n pour refuser, texte libre pour commenter).

Sortir et reprendre

  1. Pour quitter une session : tapez exit ou faites Ctrl+D. Votre conversation est sauvegardée dans le dossier courant.
  2. Pour reprendre la dernière conversation du dossier : claude -c (continue).
  3. Pour choisir parmi les conversations sauvegardées : claude -r (resume). Une liste s'affiche, vous sélectionnez.
  4. Pour lancer une commande ponctuelle en mode script : claude -p "résume les changements git de la semaine". La réponse s'affiche, la commande rend la main au shell.

Cas d'usage avec exemples concrets

Refactor d'un projet (développeur back-end) - Vous vous placez à la racine d'un projet Python : cd ~/projets/api-paiement. - Vous lancez claude et demandez : « Renomme toutes les références à legacy_user en customer dans le code, et adapte les tests. » - Claude liste les fichiers concernés, vous montre une diff par fichier, vous validez en bloc ou un par un. Il lance ensuite pytest pour vérifier que rien ne casse.

Analyse de logs (ops sur serveur distant) - En SSH sur un VPS de production, vous lancez claude dans /var/log. - Vous demandez : « Regarde les 500 dernières lignes de nginx/error.log et donne-moi les 3 patterns d'erreur les plus fréquents avec une hypothèse de cause. » - Claude lit le fichier (avec votre autorisation), groupe les erreurs, propose un diagnostic et une commande de vérification (ex. systemctl status php-fpm).

Génération de scripts (data engineer) - Dans un dossier ~/scripts, vous lancez claude et tapez : « Écris-moi un script Python qui lit tous les fichiers CSV du dossier ~/exports/2026, garde uniquement les lignes où la colonne status = paid, et exporte un fichier consolidé. » - Claude crée le script, vous le montre, vous le validez. Il propose ensuite de l'exécuter pour vérifier qu'il fonctionne.

Audit de code (consultant technique) - À la racine d'un projet client, vous lancez claude -p "fais un audit rapide de la sécurité de ce code : variables d'environnement exposées, secrets en dur, dépendances obsolètes. Format : tableau markdown.". - Claude scanne le projet, restitue un tableau d'alertes hiérarchisées dans la sortie standard. Vous pouvez piper le résultat dans un fichier : claude -p "..." > audit.md.

À retenir

  • Claude Code n'est pas un chatbot dans une fenêtre : c'est un collègue qui s'assoit à votre poste, lit vos fichiers et peut agir avec votre permission.
  • Une session claude est attachée au dossier courant : changez de projet, vous changez de contexte. Chaque dossier garde sa propre mémoire de conversation.
  • Le mode interactif (claude) sert à dialoguer, le mode claude -p "votre prompt" sert à scripter une commande ponctuelle qui rend la main au shell.
  • Claude demande toujours votre autorisation avant de modifier un fichier ou d'exécuter une commande sensible. Vous gardez la main.
  • Surveillez le compteur de fenêtre de contexte affiché dans le bandeau de session. Au-delà de 50 %, la qualité des réponses chute (Claude peut oublier, contredire ou inventer). Le bon réflexe : exit, ouvrir une nouvelle session, et reprendre avec un prompt résumant l'état. C'est un avantage concret de Claude Code vs Claude.ai web, où ce compteur n'est pas exposé.

Pièges à éviter

  • Confusion installation avec ou sans npm : la méthode recommandée est l'installeur natif (curl ... | bash ou irm ...), pas npm install. Si vous installez avec npm, n'utilisez jamais sudo npm install -g (problèmes de permissions, fichiers root dans node_modules, mises à jour cassées). La parade : suivre l'ordre indiqué par la doc officielle, installer en natif.
  • Plan Free non supporté : le plan gratuit de Claude.ai ne donne pas accès à Claude Code. Il faut au minimum un abonnement Pro, ou des crédits sur Claude Console (API). La parade : vérifier votre plan avant l'installation.
  • Lancement hors du dossier projet : si vous tapez claude depuis votre dossier home, Claude analyse votre dossier home et pas votre projet. Symptôme : il vous parle de vos Téléchargements et de Documents, pas de votre code. La parade : toujours faire cd dans le bon dossier avant claude.
  • Auto-update silencieux : les installations natives se mettent à jour seules en arrière-plan. Si une nouvelle version casse votre flux, passez sur le canal stable en réglant autoUpdatesChannel à "stable" dans votre settings.json (ou désactivez l'auto-update avec autoUpdates: false).
  • Confusion PowerShell / CMD sur Windows : les commandes d'installation diffèrent entre les deux shells. PowerShell utilise irm (Invoke-RestMethod), CMD ne le connaît pas. Vérifiez votre invite (PS C:\ pour PowerShell, C:\ pour CMD) avant de copier une commande. Claude Code fonctionne mieux dans PowerShell.
  • Mode "tout autoriser" (yolo) : le flag --dangerously-skip-permissions (ou son équivalent dans la config) supprime toutes les demandes de confirmation. Tentant pour gagner du temps, dangereux dans les faits : un mauvais prompt et Claude peut effacer un dossier, pousser une clé sur GitHub, ou casser une configuration système. Restez par défaut sur le mode "demander à chaque action sensible", au moins le temps de prendre vos repères.

Exercice 1 minute

Ouvrez un terminal, placez-vous dans un dossier de projet existant (cd ~/un-projet), lancez claude, puis tapez le prompt suivant : donne-moi un résumé en 5 lignes de ce que fait ce projet. Lisez la réponse, puis tapez exit pour sortir. Relancez ensuite claude -c pour vérifier que la conversation reprend bien là où vous l'aviez laissée.

Variantes par plan

  • Free : pas d'accès à Claude Code. L'authentification renvoie une erreur.
  • Pro : accès complet à la CLI avec les limites d'usage standard du plan Pro.
  • Max : mêmes fonctionnalités que Pro, avec des limites d'usage nettement relevées (utile si vous travaillez plusieurs heures par jour avec Claude Code).
  • Team : accès Claude Code pour tous les sièges, gestion centralisée de la facturation, partage possible des configurations via managed settings.
  • Enterprise : SSO, audit, contrôle d'administration granulaire, possibilité d'imposer une version minimale et un canal de mise à jour via les managed settings.

Liens internes