Pour utiliser Claude Code, installez-le avec une seule commande, lancez claude dans un dossier de projet, connectez-vous avec votre compte Claude dans le navigateur, puis décrivez ce que vous voulez en langage courant. Claude lit le code dont il a besoin, propose des modifications et des commandes, et demande avant de faire quoi que ce soit que vous n’avez pas autorisé.
C’est toute la boucle. Le reste de ce guide couvre ce qui la fait bien fonctionner : un fichier CLAUDE.md, les modes de permission, quelques commandes slash, le plan mode et quelques habitudes qui vous gardent dans vos limites d’usage.
Ce qu’est Claude Code
Claude Code est l’agent de code d’Anthropic. Il s’exécute dans votre terminal (et aussi dans VS Code, JetBrains, une app de bureau et le web), travaille sur les fichiers du dossier où vous le lancez et peut exécuter des commandes shell comme vos tests, vos linters et git. Contrairement à une fenêtre de chat, il n’a pas besoin que vous colliez du code : il va lire ce dont il a besoin.
Étape 1 : installer Claude Code
L’installateur natif est la méthode recommandée. Il se met à jour tout seul en arrière-plan.
| Plateforme | Commande |
|---|---|
| macOS, Linux, WSL | curl -fsSL https://claude.ai/install.sh | bash |
| Windows PowerShell | irm https://claude.ai/install.ps1 | iex |
| macOS (Homebrew) | brew install --cask claude-code |
| Windows (WinGet) | winget install Anthropic.ClaudeCode |
Les installations Homebrew et WinGet ne se mettent pas à jour toutes seules : mettez-les à jour de temps en temps avec votre gestionnaire de paquets. Vérifiez que tout a fonctionné :
claude --versionÉtape 2 : se connecter
Allez dans un dossier de projet et lancez-le :
cd your-project
claudeLa première fois, Claude Code ouvre votre navigateur pour la connexion. Vous pouvez utiliser :
- un abonnement Claude Pro, Max, Team ou Enterprise, le choix habituel ;
- un compte Claude Console, facturé au token à partir de crédits prépayés ;
- un fournisseur cloud : Amazon Bedrock, Google Cloud ou Microsoft Foundry.
Votre connexion est enregistrée, vous ne le faites donc qu’une fois. Si vous avez plusieurs comptes, /login permet de passer de l’un à l’autre.
Étape 3 : votre première tâche
Commencez par quelque chose de petit et de réel, pas « construis-moi une app ». De bonnes premières tâches :
- « Explique comment fonctionne l’authentification dans ce projet. »
- « Lance les tests et dis-moi pourquoi celui qui échoue échoue. »
- « Ajoute une validation des entrées au formulaire d’inscription, avec un test. »
Tapez-la et appuyez sur Entrée. Claude lit des fichiers, puis propose des modifications ou des commandes. Selon votre mode de permission, il demande d’abord ou il agit, et il vous montre chaque modification sous forme de diff. Lisez-les : c’est toujours vous qui livrez le code.
Vous pouvez aussi démarrer directement avec une tâche :
claude "find where we parse dates and list the formats we accept"D’autres façons utiles de démarrer :
| Commande | Ce qu’elle fait |
|---|---|
claude | Démarre une session interactive |
claude "task" | Démarre une session avec un premier message |
claude -p "task" | Exécute une fois, affiche la réponse et quitte (pratique pour les scripts) |
claude -c | Reprend la conversation la plus récente de ce dossier |
claude -r | Choisit une conversation plus ancienne à reprendre |
Étape 4 : écrire un CLAUDE.md
Chaque session démarre avec une fenêtre de contexte vierge. CLAUDE.md est le moyen pour Claude de se souvenir de votre projet : un fichier Markdown qu’il lit au début de chaque session.
Lancez ceci dans une session :
/initClaude parcourt la base de code et écrit un premier CLAUDE.md avec vos commandes de build, vos commandes de test et les conventions qu’il a repérées. Si un CLAUDE.md existe déjà, il propose des améliorations. Ensuite, modifiez-le vous-même. Ce qu’il est bon d’y mettre :
- comment compiler, lancer et tester (
pnpm test, pas « lance les tests ») - les conventions qui ne se voient pas dans le code
- les choses à éviter (« ne jamais modifier les fichiers générés dans
src/gen/») - où se trouvent les parties importantes
Gardez-le court ; Anthropic suggère de rester sous 200 lignes environ par fichier. Les longs fichiers consomment du contexte et sont suivis moins fidèlement. Vous pouvez les découper avec des imports @path/to/file.
Un CLAUDE.md peut se trouver à plusieurs endroits :
| Fichier | Portée |
|---|---|
./CLAUDE.md ou ./.claude/CLAUDE.md | Le projet, partagé avec votre équipe via git |
~/.claude/CLAUDE.md | Vous, dans tous les projets |
./CLAUDE.local.md | Vous, dans ce projet seulement (à garder hors de git) |
Si votre dépôt a déjà un AGENTS.md pour d’autres agents, les versions récentes de Claude Code le lisent quand il n’y a pas de CLAUDE.md, et vous pouvez l’importer depuis un CLAUDE.md avec @AGENTS.md.
Étape 5 : comprendre les permissions
Claude Code demande avant de faire quoi que ce soit de risqué. La fréquence des demandes dépend du mode de permission. Appuyez sur Shift+Tab pour les faire défiler ; le mode actuel s’affiche en bas de l’écran.
| Mode | Ce qui s’exécute sans demander | Idéal pour |
|---|---|---|
Manual (default) | Lecture de fichiers | Apprendre, code sensible |
| Accept edits | Lectures, modifications de fichiers, commandes simples du système de fichiers | Un travail que vous relirez de toute façon dans le diff |
| Plan mode | Lectures seulement ; aucune modification de votre source | Explorer et concevoir avant de coder |
| Auto mode | La plupart des actions, vérifiées par un classifieur de sécurité | Tâches plus longues avec moins de demandes |
Les versions récentes démarrent par défaut en auto mode ; les plus anciennes démarrent en Manual. En auto mode, un second modèle examine chaque action et bloque ce qui paraît risqué ou hors sujet, mais ce n’est pas une garantie : gardez un œil sur ce qu’il fait.
Pour un contrôle plus fin, /permissions permet d’ajouter des règles allow, ask et deny, comme « toujours autoriser npm test » ou « toujours demander avant git push ». Sous macOS, Linux et WSL2, /sandbox exécute les commandes Bash dans un bac à sable.
Il existe aussi --dangerously-skip-permissions, qui ne demande jamais rien. La documentation d’Anthropic dit de ne l’utiliser que dans un conteneur ou une machine virtuelle. Ne l’utilisez pas sur votre machine principale pendant l’apprentissage.
Étape 6 : les commandes slash à connaître
Tapez / dans une session pour voir toutes les commandes. Voici celles que vous utiliserez le plus :
| Commande | Ce qu’elle fait |
|---|---|
/help | Affiche l’aide et les commandes |
/init | Crée ou améliore CLAUDE.md |
/clear | Démarre une nouvelle conversation (l’ancienne reste dans /resume) |
/compact | Résume la conversation jusqu’ici pour libérer du contexte |
/context | Montre ce qui remplit votre fenêtre de contexte |
/model | Change de modèle ; les flèches règlent l’effort |
/plan | Entre en plan mode, éventuellement avec une tâche |
/permissions | Gère les règles allow, ask et deny |
/rewind | Revient à un point antérieur de la conversation et du code |
/resume | Rouvre une conversation précédente |
/mcp | Gère les serveurs MCP (outils supplémentaires) |
/usage | Affiche les limites d’usage de votre offre |
/review | Relit vos changements en cours |
/memory | Modifie vos fichiers CLAUDE.md |
/rewind est celle que les débutants ratent. Si Claude part dans la mauvaise direction, revenez avant le début plutôt que de le ramener en discutant.
Étape 7 : utiliser le plan mode pour tout ce qui est plus gros
Pour les changements qui touchent plus d’un fichier ou deux, demandez d’abord un plan. Appuyez sur Shift+Tab jusqu’au plan mode, ou tapez :
/plan add rate limiting to the public APIEn plan mode, Claude lit le code, pose des questions de clarification et écrit un plan, mais il ne modifie pas votre source. Vous lisez le plan, contestez ce qui ne vous plaît pas et l’approuvez quand il est bon. Il passe alors en édition et déroule le plan.
Cela coûte quelques minutes et épargne beaucoup d’annulations. Vous pouvez aussi démarrer une session en plan mode avec claude --permission-mode plan.
De bonnes habitudes de prompt
Claude Code suit bien les instructions claires. La plupart des mauvais résultats viennent d’instructions floues.
- Dites comment vérifier le travail. « Ajoute l’endpoint et fais passer
pnpm test api» vaut mieux que « ajoute l’endpoint ». - Pointez les fichiers. Citez le fichier ou la fonction par son nom, ou tapez
@pour référencer un fichier. - Une tâche par conversation. Utilisez
/clearquand vous passez à autre chose. - Donnez des exemples. « Suis le modèle de
users.service.ts» vaut mieux qu’un paragraphe de description. - Demandez d’abord une explication quand vous ne connaissez pas le code : « Comment fonctionne X ? Ne change rien pour l’instant. »
- Interrompez tôt. Appuyez sur Esc pour l’arrêter s’il part dans la mauvaise direction, puis corrigez-le.
- Mettez les corrections répétées dans CLAUDE.md. Si vous l’avez dit deux fois, écrivez-le.
Les limites et comment y rester
Les offres par abonnement ont des limites d’usage : une fenêtre glissante de 5 heures et une limite hebdomadaire, les offres supérieures en ayant davantage. Les longues conversations consomment plus, car chaque message emporte tout le contexte avec lui.
- Vérifiez où vous en êtes avec
/usage. - Utilisez
/clearentre des tâches sans rapport. - Utilisez
/compactdans les longues sessions, en précisant éventuellement ce qu’il faut garder :/compact keep the API decisions. - Utilisez
/contextpour voir ce qui prend de la place, comme de gros fichiers ou de nombreux outils MCP. - Choisissez un modèle plus léger pour les travaux simples avec
/model.
Plus de détails dans Limites d’usage de Claude Code et comment réduire la consommation de tokens de Claude Code.
Quand un seul terminal ne suffit plus
Une fois à l’aise, vous voudrez un second Claude qui travaille pendant que le premier lance les tests. Deux agents dans le même dossier se marchent sur les fichiers, donc chacun a besoin de son propre git worktree. C’est là qu’un seul terminal devient malcommode.
AgentVera est une application de bureau pour macOS, Windows et Linux qui exécute Claude Code (et d’autres agents CLI) dans de vrais terminaux, côte à côte. Elle utilise la connexion Claude Code que vous avez déjà.
- Workspace : une grille d’agents par projet, de 1×1 à 5×4. Chaque agent a son nom, son modèle, son effort et son Role and instructions, et retrouve sa conversation après un redémarrage.
- Worktrees : dans le panneau Git, créez un worktree et lancez-y un agent en un clic, pour que des agents parallèles ne partagent jamais de fichiers.
- Permissions par agent : dans la boîte New agent, choisissez Ask, Auto ou Full access. Auto utilise l’auto mode propre à Claude Code.
- Checkpoints et replay : les 60 derniers tours de chaque agent sont conservés, et vous pouvez rejouer une session.
- Le contexte en un coup d’œil : chaque volet affiche sa taille de contexte en direct, et l’auto-compact se déclenche avant que la fenêtre ne se remplisse.
Tout cela est dans l’offre gratuite. L’approbation automatique, qui laisse passer les lectures et les tests sûrs tout en demandant avant des actions comme git push ou rm, est dans Pro et Team.
Quand vous en serez là, lisez comment lancer plusieurs agents Claude Code et téléchargez AgentVera gratuitement.
Gardez l’aide-mémoire des commandes Claude Code ouvert pendant votre apprentissage, et si vous travaillez dans VS Code, voyez la configuration de l’extension VS Code.
En résumé
Installez, lancez claude, connectez-vous et commencez par une petite tâche réelle. Lancez /init et gardez votre CLAUDE.md court. Utilisez Shift+Tab pour choisir ce que Claude a le droit de faire, le plan mode pour tout ce qui est plus gros, /rewind quand ça tourne mal, et /clear et /compact pour rester dans vos limites. Cela couvre l’essentiel de ce qu’il vous faut pour les premières semaines.