Si vous débutez avec Claude Code, le terminal peut sembler intimidant. Ce guide vous présente les commandes essentielles et vous explique précisément ce qui se passe lorsque Claude Code exécute des commandes en votre nom.

Considérez le terminal comme une conversation textuelle avec votre ordinateur. Au lieu de cliquer sur des icônes et de naviguer dans des menus, vous tapez des requêtes et obtenez des réponses textuelles. Le terminal est antérieur aux interfaces graphiques de plusieurs décennies, et il perdure parce qu’il est plus rapide pour de nombreuses tâches, permet l’automatisation et donne accès à des outils puissants sans équivalent graphique.

Qu’est-ce que le terminal, vraiment ?

Le terminal est un programme qui fournit une interface textuelle vers votre ordinateur. Quand vous tapez une commande comme ls (lister les fichiers), vous exécutez un petit programme qui renvoie des informations. Les commandes sont simplement de petits programmes ciblés qui font une seule chose bien.

La terminologie prête à confusion pour les débutants, car terminal, shell, console et ligne de commande sont souvent utilisés de façon interchangeable. La distinction pratique : le terminal est la fenêtre dans laquelle vous tapez, tandis que le shell est le programme à l’intérieur qui interprète vos commandes. Quand quelqu’un dit « ouvrez votre terminal » ou « utilisez la ligne de commande », cela revient au même pour un usage quotidien.

Les shells courants incluent bash (le plus répandu, standard sur Linux), zsh (par défaut sur macOS depuis 2019, très similaire à bash) et PowerShell (le shell moderne de Microsoft pour Windows). Les commandes de base fonctionnent de façon identique sur bash et zsh, et vous avez rarement besoin de vous soucier du shell que vous utilisez.

Le modèle mental « Vous êtes ici »

Le terminal opère toujours depuis un emplacement spécifique de votre système de fichiers : votre répertoire de travail. La commande pwd (print working directory) affiche où vous vous trouvez, comme la flèche « Vous êtes ici » sur le plan d’un centre commercial. La commande cd (change directory) vous permet de vous déplacer. Chaque opération se fait relativement à votre emplacement actuel, sauf si vous spécifiez un chemin absolu.

Quand vous tapez ls, vous demandez « qu’est-ce qu’il y a dans ce dossier ? ». Quand vous tapez cd Documents, vous entrez dans le dossier Documents. Le symbole .. signifie « répertoire parent » (un niveau au-dessus), et ~ est un raccourci pour votre dossier personnel.

Pourquoi ça intimide

L’apparence minimaliste du terminal intimide les débutants. Pas de boutons, pas d’annulation, pas de confirmations « Êtes-vous sûr ? ». Cette crainte est en partie justifiée : des commandes comme rm (remove) suppriment définitivement les fichiers sans les envoyer à la corbeille. Mais voici la réalité : une dizaine de commandes suffisent pour un usage quotidien, et les commandes sûres surpassent largement celles dangereuses.

Des commandes comme ls, cd, pwd, cat et grep sont purement en lecture seule. Elles ne peuvent rien endommager. Les commandes risquées concernent la suppression (rm), la modification du système (chmod, sudo) ou les opérations sur le disque. Avec Claude Code, vous voyez exactement quelles commandes il veut exécuter et devez approuver tout ce qui est potentiellement destructif.

Commandes essentielles que tout débutant devrait connaître

Ces commandes constituent le socle de la maîtrise du terminal. Maîtrisez-les, et vous comprendrez ce que fait Claude Code lorsqu’il explore votre codebase.

Navigation : trouver son chemin

pwd affiche votre emplacement actuel. Exécutez-la en premier pour vous orienter.

$ pwd
/home/username/projects

ls liste le contenu du répertoire courant. Les options -la affichent les fichiers cachés (ceux commençant par .) dans un format détaillé :

$ ls -la
total 24
drwxr-xr-x  3 user user 4096 Jan 15 10:30 .
drwxr-xr-x 18 user user 4096 Jan 14 09:00 ..
-rw-r--r--  1 user user  220 Jan 15 10:30 .gitignore
drwxr-xr-x  2 user user 4096 Jan 15 10:30 src
-rw-r--r--  1 user user 1024 Jan 15 10:30 package.json

cd change votre emplacement. Utilisez cd .. pour remonter d’un niveau, cd ~ pour revenir à votre dossier personnel, et cd - pour basculer vers votre emplacement précédent :

cd Documents          # Entrer dans le dossier Documents
cd ../..              # Remonter de deux niveaux
cd ~/projects/myapp   # Aller vers un chemin absolu via le raccourci home

Opérations sur les fichiers : créer et gérer des fichiers

mkdir crée des répertoires. Utilisez -p pour créer des dossiers imbriqués en une seule commande :

mkdir projects
mkdir -p projects/web/frontend/components

touch crée des fichiers vides ou met à jour l’horodatage de fichiers existants :

touch newfile.txt
touch index.js styles.css  # Créer plusieurs fichiers

cp copie des fichiers. Ajoutez -r pour les répertoires (copie récursive) :

cp original.txt backup.txt
cp -r src/ src-backup/

mv déplace ou renomme des fichiers. Il n’existe pas de commande séparée pour renommer :

mv oldname.txt newname.txt   # Renommer
mv file.txt ~/Documents/     # Déplacer vers Documents

rm supprime définitivement les fichiers. Soyez prudent avec cette commande. Utilisez -i pour obtenir des confirmations pendant votre apprentissage :

rm unwanted.txt          # Supprimer un fichier (sans confirmation !)
rm -i important.txt      # Demander avant de supprimer
rm -r foldername/        # Supprimer un dossier et son contenu

Afficher le contenu des fichiers

cat affiche un fichier entier d’un coup. Idéal pour les fichiers courts :

cat config.json

less permet une lecture paginée pour les fichiers plus longs. Naviguez avec les flèches, espace pour la page suivante, q pour quitter :

less longfile.log

head et tail affichent les premières ou dernières lignes. L’option -n spécifie le nombre de lignes :

head -n 20 file.txt    # 20 premières lignes
tail -n 50 server.log  # 50 dernières lignes
tail -f app.log        # Suivre le fichier en temps réel (idéal pour les logs)

Rechercher des éléments

grep cherche des motifs textuels dans les fichiers. Claude Code s’en sert énormément :

grep "error" logfile.txt           # Trouver les lignes contenant "error"
grep -i "warning" app.log          # Recherche insensible à la casse
grep -r "TODO" ./src/              # Rechercher récursivement dans src
grep -n "function" script.js       # Afficher les numéros de ligne

find localise des fichiers par nom ou attributs :

find . -name "*.txt"               # Trouver tous les fichiers .txt
find /home -name "config"          # Trouver les fichiers nommés "config"
find . -type f -name "*.log"       # Trouver uniquement les fichiers (pas les répertoires)

which révèle où se trouve une commande :

which python    # Affiche /usr/bin/python ou similaire
which node

Comprendre les chemins

Les chemins existent sous deux formes. Les chemins absolus partent de la racine (/ sur Mac/Linux, C:\ sur Windows) et fonctionnent depuis n’importe où : /home/user/projects/app.js. Les chemins relatifs sont basés sur votre emplacement actuel : ./src/components/Button.js ou ../config/settings.json.

Symboles de chemins à mémoriser :

• . : répertoire courant
• .. : répertoire parent (un niveau au-dessus)
• ~ : répertoire personnel
• / : répertoire racine (sommet du système de fichiers)

Claude Code : commandes CLI et interaction

Claude Code est l’assistant de programmation agentique d’Anthropic qui vit dans votre terminal. Il comprend votre codebase de façon contextuelle et exécute des commandes en votre nom, avec votre permission.

Installation

Claude Code nécessite Node.js 18 ou ultérieur. Installez-le via npm :

npm install -g @anthropic-ai/claude-code

Après l’installation, naviguez vers n’importe quel projet et tapez claude pour démarrer. Les nouveaux utilisateurs s’authentifient via le navigateur.

Options CLI essentielles

Rediriger du contenu vers Claude Code permet des workflows puissants :

cat error.log | claude -p "explique ces erreurs"
git diff | claude -p "revois ces modifications"

Commandes slash dans Claude Code

Une fois que vous avez démarré une session interactive avec claude, les commandes slash contrôlent l’expérience :

Gestion de session :

• /help : Liste toutes les commandes disponibles
• /clear : Efface l’historique de conversation pour un nouveau départ
• /compact : Résume la conversation pour libérer la fenêtre de contexte
• /exit ou /quit : Quitter Claude Code

Contexte et configuration :

• /init : Génère un fichier CLAUDE.md décrivant votre projet
• /config : Ouvre l’interface de paramètres
• /model : Changer de modèle IA en cours de session
• /permissions : Voir et ajuster les permissions

Outils de développement :

• /review : Demander une revue de code
• /doctor : Diagnostiquer les problèmes d’installation
• /cost : Afficher l’utilisation des tokens pour la session en cours

La commande /compact mérite une mention spéciale : quand les conversations s’allongent, Claude peut commencer à « oublier » le contexte antérieur. Exécuter /compact focus on the authentication code résume tout en préservant ce qui compte.

Lire la sortie de Claude Code

Quand Claude Code exécute des commandes, vous voyez une sortie claire comme :

⏺ Running: git status
  Description: Shows working tree status

L’outil demande permission avant d’exécuter quoi que ce soit qui modifie des fichiers ou lance des commandes potentiellement impactantes. Vous pouvez accepter une fois, accepter toujours pour la session, ou refuser. Lisez toujours ce que Claude Code veut faire avant d’approuver.

Raccourcis clavier essentiels dans Claude Code :

• Escape : Arrêter la génération en cours de Claude
• Ctrl+C deux fois : Forcer la sortie
• Tab : Basculer l’affichage de la réflexion étendue
• Shift+Tab : Parcourir les modes

Quelles commandes Claude Code exécute-t-il vraiment ?

Comprendre ce qui se passe en coulisses vous aide à apprendre et renforce votre confiance. Voici ce que Claude Code exécute pour les tâches courantes.

Découverte de fichiers

Plutôt que d’exécuter des commandes find ou ls brutes, Claude Code utilise des outils intégrés optimisés pour la rapidité et la sécurité. Pour rechercher des fichiers, il utilise des patterns glob :

**/*.js           Tous les fichiers JavaScript récursivement
src/**/*.ts       Fichiers TypeScript dans src/
*.{json,yaml}     Fichiers JSON et YAML dans le répertoire courant
test/**/*test.js  Fichiers de test correspondant au pattern

Pour les listings de répertoires, les outils internes de Claude Code fournissent une sortie structurée. Vous pouvez occasionnellement voir des ls ou ls -la standards quand Claude a besoin d’un aperçu rapide.

Recherche de contenu

Les capacités de recherche de Claude Code reposent sur ripgrep (rg), un outil de recherche rapide. Quand vous demandez à Claude de trouver quelque chose, il peut exécuter :

rg "function authenticate" --type js     # Chercher dans les fichiers JavaScript
rg "TODO" -c                              # Compter les occurrences
rg "error" -i -C 2                        # Insensible à la casse avec lignes de contexte
rg "import.*React" --glob "*.tsx"         # Trouver les imports React dans les fichiers TSX

Claude Code utilise ripgrep plutôt que le grep traditionnel pour des améliorations de performance spectaculaires sur les grandes codebases.

Lecture et modification de fichiers

Pour lire des fichiers, Claude Code utilise son outil Read intégré plutôt que cat. Cela fournit les numéros de ligne et gère les fichiers spéciaux comme les images, PDF et notebooks. Pour les modifications, l’outil Edit effectue des changements chirurgicaux plutôt que d’utiliser sed ou awk :

{
  "file_path": "/path/to/file.ts",
  "old_string": "oldFunctionName",
  "new_string": "newFunctionName",
  "replace_all": true
}

Cette approche évite les écrasements accidentels et permet une comparaison claire des différences.

Commandes Git

C’est avec Git que vous verrez le plus de commandes bash. Claude Code exécute fréquemment :

# Vérifier l'état (souvent en parallèle)
git status                    # Qu'est-ce qui a changé ?
git diff                      # Modifications non indexées
git diff --staged             # Modifications indexées
git log --oneline -10         # Commits récents

# Apporter des modifications
git add .                     # Indexer toutes les modifications
git commit -m "message"       # Commiter avec un message
git branch --show-current     # Nom de la branche actuelle

# Travailler avec les dépôts distants
git push origin main
git pull origin main

Avant de commiter, Claude Code exécute généralement git status, git diff et git log en parallèle pour comprendre la situation complète.

Gestionnaires de paquets et outils de build

Les workflows de développement impliquent des commandes fréquentes des gestionnaires de paquets :

# Node.js/npm
npm install                   # Installer les dépendances
npm run build                 # Construire le projet
npm run dev                   # Démarrer le serveur de développement
npm test                      # Lancer les tests

# Python/pip
pip install -r requirements.txt
pytest                        # Lancer les tests

# Autres écosystèmes
cargo build                   # Rust
go build                      # Go
yarn install                  # Yarn

Commandes système et processus

Occasionnellement, Claude Code vérifie l’état du système :

which python          # Trouver où Python est installé
env                   # Lister les variables d'environnement
ps                    # Vérifier les processus en cours
file document.pdf     # Déterminer le type de fichier
wc -l bigfile.txt     # Compter les lignes

Considérations multi-plateformes

L’expérience du terminal varie selon les systèmes d’exploitation.

Utilisateurs macOS

macOS utilise zsh par défaut depuis Catalina (2019). Ouvrez Terminal via Cmd + Espace, tapez « Terminal » et appuyez sur Entrée. Pour des fonctionnalités avancées, beaucoup de développeurs préfèrent iTerm2, qui offre des panneaux divisés, une meilleure recherche et une personnalisation poussée.

Utilisateurs Linux

La plupart des distributions utilisent bash par défaut et incluent des terminaux comme GNOME Terminal ou Konsole. L’installation est identique à celle de macOS.

Utilisateurs Windows

Windows propose plusieurs approches :

Option 1 : WSL (recommandé pour une compatibilité complète) WSL (Windows Subsystem for Linux) exécute un environnement Linux complet au sein de Windows :

# Dans PowerShell en tant qu'administrateur
wsl --install

# Après redémarrage, dans le nouveau terminal Ubuntu :
npm install -g @anthropic-ai/claude-code

Option 2 : Git Bash (configuration plus simple) Git Bash fournit des commandes de type Unix et est supporté par Claude Code. Installez Git for Windows et utilisez le terminal Git Bash inclus.

Option 3 : PowerShell natif Claude Code fonctionne dans PowerShell, bien que certaines commandes diffèrent de leurs équivalents Unix.

Équivalences de commandes entre plateformes

Une différence cruciale : Linux est sensible à la casse (File.txt et file.txt sont des fichiers différents), contrairement à Windows et macOS (par défaut).

Conseils pratiques de sécurité

Décrypter les messages d’erreur

« command not found » signifie que la commande n’existe pas ou n’est pas dans votre PATH. Vérifiez l’orthographe (les commandes sont sensibles à la casse sur Linux), confirmez que le programme est installé, ou utilisez which nomcommande pour le localiser.

« permission denied » indique que vous n’avez pas les droits d’accès. Pour les scripts, chmod +x script.sh ajoute la permission d’exécution. Pour les opérations système, sudo fournit un accès administrateur, mais utilisez-le avec précaution.

« No such file or directory » signifie que votre chemin est incorrect. Vérifiez l’emplacement avec pwd et ls.

Commandes nécessitant de la prudence

La commande la plus dangereuse est rm -rf :

• rm = supprimer
• -r = récursif (supprime tout à l’intérieur des répertoires)
• -f = forcer (pas de demande de confirmation)

N’exécutez jamais rm -rf / ou rm -rf ~. Cela supprimerait votre système entier ou votre dossier personnel. Claude Code demande permission avant d’exécuter des commandes de suppression et bloque les patterns particulièrement risqués.

De même, sudo (superuser do) accorde les privilèges administrateur. Utilisez-le uniquement pour installer des paquets système ou modifier des fichiers protégés, et lisez toujours attentivement ce qui suit sudo.

Raccourcis clavier qui vous sauvent

L’auto-complétion par Tab fait toute la différence. Tapez les premiers caractères de n’importe quel fichier, dossier ou commande et appuyez sur Tab. Le shell complète automatiquement ou affiche les options s’il y a plusieurs correspondances. Cela évite les fautes de frappe et accélère considérablement la navigation.

Quand quelque chose semble inquiétant

Si la sortie du terminal paraît alarmante :

1. Ne paniquez pas. La plupart des messages sont informatifs.
2. Appuyez sur Ctrl+C pour arrêter toute commande en cours.
3. Lisez attentivement l’erreur. Elle explique généralement ce qui s’est mal passé.
4. Demandez de l’aide à Claude Code en décrivant ce qui s’est passé.

Claude Code lui-même dispose de garde-fous : il vous montre exactement quelles commandes il veut exécuter, demande permission pour tout ce qui est potentiellement impactant, et vous permet de refuser les opérations risquées. La commande /permissions vous permet de consulter et ajuster les outils que Claude Code peut utiliser.

Checklist pour démarrer

Prêt à vous lancer ? Voici votre parcours :

1. Ouvrez votre terminal. Terminal.app sur Mac, votre terminal Linux préféré, ou WSL/Git Bash sur Windows.
2. Essayez des commandes sûres. Exécutez pwd, ls, cd Documents, cd .., ls -la pour vous familiariser avec la navigation.
3. Installez Claude Code. Utilisez npm install -g @anthropic-ai/claude-code.
4. Lancez claude doctor. Vérifiez que votre installation est saine.
5. Démarrez Claude Code dans un projet. Naviguez vers un dossier de code et tapez claude.
6. Lancez /init. Laissez Claude Code créer une description du projet.
7. Demandez des explications à Claude Code. Sollicitez des explications pour tout ce que vous ne comprenez pas.

Le terminal récompense rapidement l’investissement. En quelques heures de pratique, la navigation devient instinctive. En quelques jours, vous vous demanderez comment vous travailliez sans. Et avec Claude Code comme pair programmer, vous avez un guide qui explique chaque étape du parcours.