Workbranch › Guides

Comment démarrer avec Claude Code

Claude Code est l'assistant de programmation d'Anthropic : il lit votre projet, modifie des fichiers et exécute des commandes depuis votre terminal. Ce guide vous accompagne de l'installation à une première session qui fonctionne, avec en prime le fichier qui améliore toutes les sessions suivantes.

Mis à jour le 30 octobre 2026

Les commandes ci-dessous ont été vérifiées dans la documentation de Claude Code d'Anthropic en octobre 2026.

Quels forfaits incluent Claude Code

Étape 1 : installer

1. Ouvrez un terminal. Sous Windows, PowerShell affiche PS C:\ dans l'invite ; CMD affiche simplement C:\.
2. Lancez la commande correspondant à votre système :
   • macOS, Linux, WSL : curl -fsSL https://claude.ai/install.sh | bash
   • Windows PowerShell : irm https://claude.ai/install.ps1 | iex
   • Windows CMD : curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
3. Patientez. L'installateur n'affiche pas de barre de progression pendant le téléchargement.
4. Ouvrez une nouvelle fenêtre de terminal et lancez claude --version. Vous devez voir un numéro de version suivi de (Claude Code).

Vous préférez un gestionnaire de paquets ? brew install --cask claude-code sur Mac ou winget install Anthropic.ClaudeCode sous Windows fonctionnent aussi. Sous Windows natif, il est recommandé d'installer Git for Windows pour que Claude Code puisse utiliser Bash ; sans lui, il se rabat sur PowerShell.

Étape 2 : lancer votre première session dans un projet

1. Placez-vous dans votre projet : cd /path/to/your/project.
2. Tapez claude et appuyez sur Entrée.
3. À la première utilisation, suivez l'invite pour vous connecter dans votre navigateur. Vos identifiants sont enregistrés, vous ne le faites donc qu'une fois. Utilisez /login plus tard pour changer de compte.
4. Posez une question pour vous repérer, par exemple que fait ce projet ? ou où est le point d'entrée principal ?. Claude lit les fichiers dont il a besoin ; vous n'avez pas à coller de code.
5. Essayez une petite modification, par exemple ajoute une validation des champs au formulaire d'inscription. Claude montre la modification et demande avant de l'appliquer ; choisissez Yes (oui) pour approuver.

Claude Code gère aussi Git en langage courant : quels fichiers ai-je modifiés ? ou fais un commit de mes modifications avec un message descriptif.

Étape 3 : donner à Claude les règles de votre projet avec CLAUDE.md

Chaque session démarre avec un contexte vide. Un fichier CLAUDE.md est chargé au début de chacune : c'est là que vous mettez ce que Claude doit toujours savoir, comme les commandes de build et de test, les conventions et ce qu'il faut éviter.

1. Dans une session, lancez /init. Claude parcourt votre code et rédige un premier CLAUDE.md avec les commandes et conventions qu'il trouve. Si le fichier existe déjà, il propose des améliorations au lieu de l'écraser.
2. Ouvrez le fichier et ajoutez ce que Claude n'a pas pu découvrir seul, par exemple « lancer le linter avant chaque commit ».
3. Faites-en un commit pour que les sessions de vos collègues reçoivent les mêmes instructions.

Anthropic conseille de limiter chaque fichier à environ 200 lignes : les fichiers plus longs consomment plus de contexte et sont suivis de façon moins fiable. Vous pouvez inclure d'autres fichiers avec @path/to/file.

Les commandes à apprendre en premier

• claude "task" démarre une session avec votre première instruction déjà saisie.
• claude -p "query" répond une fois puis quitte.
• claude -c reprend la dernière session dans ce dossier ; claude -r permet d'en choisir une plus ancienne. Plus de détails dans comment reprendre une session Claude Code.
• /help liste les commandes, /clear repart de zéro, /exit (ou deux fois Ctrl+D) quitte.
• Tapez / pour voir les commandes et les skills disponibles.

Bon à savoir

• Utilisation : sur Pro et Max, Claude Code et Claude chat partagent les mêmes limites de cinq heures et hebdomadaires. Si une variable d'environnement ANTHROPIC_API_KEY est définie et approuvée, Claude Code utilise cette clé et facture au tarif de l'API ; lancez /login pour revenir à votre abonnement.
• Autorisations : le mode d'autorisation détermine ce que Claude peut faire sans demander. Appuyez sur Maj+Tab pour passer d'un mode à l'autre.
• CLAUDE.md est un guide, pas un verrou : Claude le traite comme du contexte. Les instructions précises et courtes sont suivies le plus régulièrement.

Si ça ne fonctionne pas

• claude est introuvable après l'installation : ouvrez un nouveau terminal. Si cela échoue encore, le dossier d'installation n'est pas encore dans votre PATH ; la page de dépannage d'Anthropic explique comment corriger cela.
• The token '&&' is not a valid statement separator : vous êtes dans PowerShell ; utilisez la commande PowerShell. 'irm' is not recognized signifie que vous êtes dans CMD.
• La commande d'installation échoue avec une erreur 403 ou une erreur de syntaxe : consultez la page de dépannage de l'installation d'Anthropic pour d'autres méthodes d'installation.
• La connexion tourne en boucle ou utilise le mauvais compte : lancez /login dans une session pour vous reconnecter.

Workbranch pour Claude Code

Si vous suivez votre travail de projet dans Workbranch, son plugin Claude Code affiche ce qui reste ouvert quand une session démarre dans un dossier lié à un projet, et vous pouvez dire « save this to Workbranch » pour classer par sujet les tâches, les décisions et les questions ouvertes de la session. Tous les détails sont sur la page Workbranch pour Claude.

Sources

• Use Claude Code with your Pro or Max plan (Claude Help Center, consulté le 2026-10-30)
• Quickstart (Claude Code Docs, consulté le 2026-10-30)
• How Claude remembers your project (Claude Code Docs, consulté le 2026-10-30)

Questions fréquentes