Leçon 2 sur 15
Installation et configuration initiale
11 min de lecture
Points clés de cette leçon
- Claude Code s'installe en ligne de commande et s'authentifie à un compte Anthropic.
- La configuration vit dans des fichiers de réglages versionnables ou personnels.
- Un premier lancement bien préparé évite les frictions des sessions suivantes.
Avant de confier des tâches à Claude Code, il faut l'installer, connecter votre compte et poser quelques réglages. Cette leçon vous guide pas à pas pour que votre première session démarre sans accroc.
Installer Claude Code
Claude Code se distribue comme un outil en ligne de commande. L'installation typique passe par un gestionnaire de paquets, puis se vérifie en interrogeant la version installée.
# Vérifier que l'outil répond
claude --version
# Lancer une première session dans le dossier courant
claudeSi la commande claude n'est pas reconnue, c'est généralement que le dossier
des binaires n'est pas dans votre PATH. Reportez-vous aux instructions
d'installation officielles, qui détaillent les chemins selon le système. Pour
le détail exact des plateformes prises en charge, consultez la documentation
sur le site officiel d'Anthropic.
Travaillez dans un projet de test
Comme vu dans l'introduction au cours, utilisez un dépôt sans enjeu pour vos premiers essais. Vous explorerez les commandes sans crainte pour un code de production.
Authentifier votre compte
Au premier lancement, Claude Code vous demande de vous connecter. Le processus ouvre généralement une page d'authentification dans votre navigateur, puis relie la session du terminal à votre compte Anthropic.
L'authentification se fait une fois : un jeton est conservé localement pour les sessions suivantes. Si vous changez de machine ou que la session expire, vous relancerez simplement la connexion. Ne partagez jamais ce jeton et ne le versionnez pas dans un dépôt.
Vérifier que tout fonctionne
Une fois connecté, posez une question simple à l'assistant, par exemple lui
demander de lister les fichiers du projet ou de résumer le README. Si la
réponse arrive, votre installation est opérationnelle.
Configurer vos réglages
Claude Code lit des fichiers de configuration qui ajustent son comportement : permissions, variables d'environnement, intégrations. On distingue deux portées principales.
- Réglages de projet : versionnés avec le dépôt, ils s'appliquent à toute l'équipe et garantissent un comportement cohérent.
- Réglages personnels : locaux à votre machine, ils restent privés et ne sont pas partagés via Git.
Un fichier de réglages au format JSON ressemble à ceci :
{
"permissions": {
"allow": ["Bash(npm test)", "Bash(npm run build)"]
},
"env": {
"NODE_ENV": "development"
}
}Ici, on autorise explicitement deux commandes fréquentes pour éviter d'avoir à les confirmer à chaque exécution, et on fixe une variable d'environnement. Commencez minimal : ajoutez des règles au fur et à mesure des besoins réels.
Permissions et prudence
N'autorisez largement que ce que vous maîtrisez. Une règle trop permissive laisse l'assistant exécuter des commandes sensibles sans validation. Préférez des autorisations ciblées.
Préparer votre premier projet
Avant de lancer une vraie tâche, deux gestes paient immédiatement. D'abord,
ajoutez un fichier CLAUDE.md à la racine : il donne le contexte durable du
projet. C'est l'objet de la leçon sur le fichier CLAUDE.md.
Ensuite, assurez-vous que votre dépôt Git est propre, sans modifications en
attente, pour relire facilement les diffs produits par l'assistant.
Anatomie d'une bonne session de départ
Une session productive suit souvent ce schéma : vous décrivez l'objectif, l'assistant explore le code, propose un plan, puis applique les changements par étapes que vous validez. Plus le contexte initial est clair, moins l'assistant fait d'hypothèses hasardeuses.
En résumé
Vous savez désormais installer Claude Code, connecter votre compte et poser des réglages adaptés à votre contexte. La prochaine étape consiste à comprendre comment l'assistant gère sa mémoire de travail : rendez-vous dans la leçon sur le contexte et la fenêtre de contexte.
Pour situer cette compétence dans un parcours plus large, explorez les autres cours disponibles ou visez la certification Certified Architect.