# Utiliser Claude Code : le guide du débutant

URL: https://agentvera.dev/fr/blog/how-to-use-claude-code/ · Publié: 2026-10-22

Comment utiliser Claude Code pas à pas : installer, se connecter, première tâche, CLAUDE.md, modes de permission, commandes slash, plan mode et limites d’usage.

**En bref:**

- Claude Code demande une offre Claude Pro, Max, Team ou Enterprise, un compte Claude Console, ou Amazon Bedrock, Google Cloud ou Microsoft Foundry ; l’offre gratuite de Claude.ai ne l’inclut pas.
- Après l’installation, lancez claude dans un dossier de projet, connectez-vous une fois dans le navigateur, puis /init crée un CLAUDE.md à garder sous 200 lignes environ.
- Shift+Tab fait défiler les modes de permission ; plan mode pour les changements touchant plus d’un fichier ou deux, /rewind pour défaire une fausse piste, /clear et /compact pour rester dans les limites.

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é :

```bash
claude --version
```

## Étape 2 : se connecter

Allez dans un dossier de projet et lancez-le :

```bash
cd your-project
claude
```

La 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 :

```bash
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 :

```
/init
```

Claude 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 API
```

En 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 `/clear` quand 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 `/clear` entre des tâches sans rapport.
- Utilisez `/compact` dans les longues sessions, en précisant éventuellement ce qu’il faut garder : `/compact keep the API decisions`.
- Utilisez `/context` pour 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](/fr/blog/claude-code-usage-limits/ "Limites d’usage de Claude Code") et [comment réduire la consommation de tokens de Claude Code](/fr/blog/claude-code-token-usage/ "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](/fr/features/workspace/ "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](/fr/features/git-and-github/ "Git et GitHub"), 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](/fr/features/checkpoints-and-replay/ "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](/fr/blog/run-multiple-claude-code-agents/ "Lancer plusieurs agents Claude Code") et [téléchargez AgentVera gratuitement](/fr/download/ "Télécharger AgentVera").

Gardez l’[aide-mémoire des commandes Claude Code](/fr/blog/claude-code-commands-cheat-sheet/ "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](/fr/blog/claude-code-vs-code/ "Extension VS Code de Claude 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.

## Questions fréquentes

**Faut-il une offre payante pour utiliser Claude Code ?** Oui. Claude Code demande une offre Claude Pro, Max, Team ou Enterprise, ou un compte Claude Console avec des crédits API. Il peut aussi passer par Amazon Bedrock, Google Cloud ou Microsoft Foundry. L’offre gratuite de Claude.ai ne l’inclut pas.

**Claude Code fonctionne-t-il sous Windows ?** Oui. Installez-le depuis PowerShell avec l’installateur natif ou avec WinGet. Il tourne aussi dans WSL. Les commandes comme /init, le plan mode et les permissions fonctionnent de la même façon sur toutes les plateformes.

**À quoi sert CLAUDE.md ?** CLAUDE.md est un fichier Markdown d’instructions de projet que Claude Code lit au début de chaque session : commandes de build et de test, style de code, choses à éviter. Lancez /init pour générer une première version, puis gardez-le court et modifiez-le au fil de l’eau.

**Comment empêcher Claude Code de modifier des fichiers sans demander ?** Appuyez sur Shift+Tab jusqu’au mode Manual (ou au plan mode, qui ne modifie rien tant que vous n’approuvez pas un plan). Vous pouvez aussi ajouter des règles ask et deny avec /permissions, par exemple pour toujours demander avant git push.

**Que faire quand Claude Code atteint sa limite d’usage ?** Consultez /usage pour voir quand la fenêtre se réinitialise. Utilisez /clear entre des tâches sans rapport et /compact dans les longues sessions pour que chaque message porte moins de contexte. Avec plusieurs comptes Claude, vous pouvez changer avec /login.

---

**À 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 inclut des agents illimités. Télécharger: https://agentvera.dev/fr/download/ · Tarifs: https://agentvera.dev/fr/pricing/