Claude Code débutant : installation, permissions sûres et première session utile

Claude Code est un agent de développement utilisable depuis le terminal. Ce n’est pas seulement un chat pour coller du code : il peut lire les fichiers d’un projet, chercher dans le dépôt, proposer des modifications, éditer si vous l’autorisez et lancer des commandes de test ou de build.

Le piège classique des débutants est de commencer trop grand. Si votre premier prompt est “améliore toute cette application”, vous obtiendrez probablement un diff difficile à juger. Le bon objectif du premier jour est plus simple : comprendre le projet, choisir une petite tâche, modifier peu de fichiers et vérifier.

Ce guide suit la documentation officielle setup, common workflows et CLI usage. Ensuite, lisez aussi le guide CLAUDE.md et la gestion du contexte.

Comprendre le rôle de Claude Code

Claude Code est très fort pour les tâches petites mais contextualisées : comprendre une base de code, trouver les fichiers importants, corriger un bug isolé, ajouter des tests, améliorer un README ou préparer une PR.

Pour commencer, suivez cette séquence :

Étape	Action	But
1	Installer et se connecter	Vérifier que l’outil fonctionne
2	Lire sans modifier	Construire une carte du projet
3	Choisir une petite tâche	Limiter le risque
4	Lire le diff et les tests	Valider par des preuves
5	Documenter les règles	Stabiliser les prochaines sessions

Ce rythme est plus fiable qu’une automatisation immédiate.

Préparer l’environnement

N’utilisez pas directement la branche de production. Créez une branche de test :

git status
git switch -c try-claude-code

Si votre version de Git est ancienne :

git checkout -b try-claude-code

Vérifiez aussi :

• un compte Claude avec accès à Claude Code
• une connexion internet
• le dossier racine du projet
• Git opérationnel
• une commande de test ou de build connue
• aucune exposition de .env, clés ou données clients

Sur Windows, PowerShell et CMD n’utilisent pas toujours les mêmes commandes. PS C:\ indique PowerShell.

Installation

Sur macOS, Linux ou WSL :

curl -fsSL https://claude.ai/install.sh | bash

Sur Windows PowerShell :

irm https://claude.ai/install.ps1 | iex

Puis vérifiez :

claude --version
claude doctor

claude doctor est précieux au début, car il signale les problèmes d’installation ou de configuration avant que vous ne les confondiez avec un bug du projet.

L’installation npm existe aussi :

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

Mais sauf besoin précis, commencez par l’installateur natif officiel. Évitez sudo npm install -g, qui peut créer des problèmes de droits et de sécurité.

Les 30 premières minutes

Depuis la racine du projet :

cd my-project
claude

Après la connexion, ne demandez pas encore une fonctionnalité complète. Commencez en lecture seule :

Je découvre ce projet.
N'édite aucun fichier pour l'instant. Lis seulement et explique :

- ce que fait le projet
- les répertoires principaux et leur rôle
- les commandes probables de dev, test et build
- les fichiers risqués à modifier
- les 5 premiers fichiers à lire

Ajoute les chemins de fichiers comme preuves et ne conclus pas sans base claire.

Puis demandez des tâches simples :

Propose 5 tâches adaptées à un débutant dans ce dépôt.
Chaque tâche doit :

- prendre environ 30 minutes
- toucher au maximum 2 fichiers
- avoir un test ou une vérification manuelle
- éviter l'authentification, le paiement, les secrets et les données de production

Ajoute le risque et les étapes de vérification.

Vous obtenez alors un vrai plan de travail.

Permissions sûres

Claude Code peut exécuter des commandes et modifier des fichiers. Les permissions sont donc centrales. Pour commencer prudemment :

claude --permission-mode plan

Dans la session :

/permissions

Soyez prudent avec bypassPermissions et --dangerously-skip-permissions. Ces modes ne conviennent qu’à des environnements isolés comme des conteneurs jetables ou des machines virtuelles.

Un modèle conservateur :

{
  "permissions": {
    "allow": [
      "Bash(git status)",
      "Bash(git diff *)",
      "Bash(npm run test *)",
      "Bash(npm run build *)"
    ],
    "deny": [
      "Bash(git push *)",
      "Bash(rm -rf *)",
      "Read(.env)",
      "Read(**/.env)"
    ]
  }
}

Le principe : autoriser les vérifications à faible risque, bloquer les secrets et garder les opérations destructrices sous contrôle humain.

Exemple 1 : améliorer README

README est une bonne première tâche, car elle améliore la compréhension sans toucher à la logique applicative.

Je veux améliorer README.md.
Lis d'abord README.md et package.json.
Liste les informations manquantes, mais n'édite rien.
Après validation, modifie uniquement README.md.

Puis limitez :

Ajoute seulement deux sections à README.md :

- développement local
- commande de test

Utilise uniquement les commandes visibles dans package.json.
N'invente pas d'outil ni d'étape de déploiement.

Exemple 2 : corriger un petit bug

Donnez une reproduction claire :

Analyse ce bug.

Problème :
- Quand la recherche contient seulement des espaces, l'application affiche tous les résultats.

Attendu :
- Une recherche composée seulement d'espaces doit être traitée comme vide.

Contraintes :
- Explique d'abord la cause probable.
- Modifie au maximum 1 fichier.
- Donne les tests ou vérifications manuelles à lancer.

Après modification :

git diff

Puis :

Relis le git diff actuel.
Cherche les changements inattendus, l'abstraction excessive, les tests manquants et les cas limites.
Si tout va bien, donne 3 vérifications manuelles.

Exemple 3 : ajouter un CTA utile

Sur un site de contenu ou de documentation, Claude Code peut améliorer la prochaine action du lecteur sans refondre le design.

Lis cet article et propose 3 CTA pour débutants.

Objectifs :
- réduire l'anxiété du premier usage
- relier naturellement PDF gratuit, produit ou consultation
- moins de 80 caractères chacun
- éviter le ton commercial agressif

Implémentez ensuite selon les motifs existants :

Trouve le motif CTA existant sur les pages d'article.
Ajoute un CTA à la fin de cet article avec le même ton.
Ne crée pas de composant et ne change pas les styles globaux.

Erreurs fréquentes

Première erreur : demander trop. “Améliore l’application” n’est pas une tâche. “Corrige le cas des espaces dans la recherche” en est une.

Deuxième erreur : ignorer la lecture initiale. Si Claude Code ne peut pas expliquer l’architecture, il ne devrait pas encore modifier.

Troisième erreur : élargir les permissions trop tôt. Un diff compréhensible vaut mieux qu’une automatisation rapide.

Quatrième erreur : croire le message final sans preuve. Vérifiez tests, build, navigateur ou git diff.

Cinquième erreur : garder une conversation interminable. Quand le sujet change, résumez et repartez proprement. Voir gestion du contexte.

Checklist de dépannage

• claude --version fonctionne-t-il ?
• que dit claude doctor ?
• êtes-vous à la racine du projet ?
• git status est-il compréhensible ?
• avez-vous mélangé PowerShell et CMD ?
• êtes-vous en WSL, SSH ou conteneur avec une connexion spéciale ?
• essayez-vous de lire .env ou des clés ?
• un mode de permission dangereux est-il actif ?
• la commande de test existe-t-elle vraiment ?

Prompt utile :

Claude Code ne se comporte pas comme prévu.
N'édite aucun fichier. Aide-moi seulement à diagnostiquer.

Environnement :
- OS :
- shell :
- commande lancée :
- erreur :
- comportement attendu :

Classe les vérifications de la plus sûre à la plus risquée.

Note de vérification de Masa

Dans ClaudeCodeLab, le flux le plus fiable a été : lire, planifier, modifier peu, vérifier. Cela a fonctionné pour les articles, les traductions, le CSS et les scripts de déploiement. Quand la tâche avait une limite claire, le diff était lisible. Quand je laissais l’agent aller trop loin, l’intention devenait difficile à reconstruire.

Pendant la première semaine, gardez les confirmations visibles, relisez chaque git diff et notez les prompts efficaces. Ensuite, passez aux conseils de productivité.

Prochaine étape

Aujourd’hui, ouvrez un dépôt non critique, demandez une carte en lecture seule, choisissez une amélioration de 30 minutes et relisez le diff.

Pour une fiche de rappel, téléchargez gratuitement Claude Code Quick Reference Cheatsheet. Pour l’adoption en équipe, la formation ou un flux réel, utilisez les ressources et la consultation du site.