Introduction à Claude Code

Introduction à Claude Code

Qu'est-ce que Claude Code ?

Claude Code est l'outil en ligne de commande (CLI) officiel d'Anthropic. Il permet d'interagir directement avec Claude depuis votre terminal pour réaliser des tâches de développement logiciel : écrire du code, débugger, refactorer, explorer un codebase, et bien plus.

Pourquoi utiliser Claude Code ?

Aspect Sans Claude Code Avec Claude Code
Écriture de code Tout écrire manuellement Claude génère et modifie le code directement dans vos fichiers
Débugage Lire les logs, chercher sur Stack Overflow Claude analyse l'erreur et propose un fix
Exploration Naviguer fichier par fichier Claude parcourt le codebase et résume l'architecture
Tests Écrire chaque test à la main Claude génère les tests en comprenant le contexte
Git Rédiger les messages de commit soi-même Claude analyse le diff et rédige un message pertinent

Installation

Via npm (recommandé)

# Installation globale
npm install -g @anthropic-ai/claude-code

# Vérifier l'installation
claude --version

Prérequis

  • Node.js version 18 ou supérieure
  • Un compte Anthropic avec une clé API ou un abonnement Claude
  • Un terminal (bash, zsh, PowerShell, etc.)

Premier lancement

# Lancer Claude Code dans le répertoire courant
claude

# Lancer avec un prompt initial
claude "explique-moi la structure de ce projet"

# Lancer en mode non-interactif (one-shot)
claude -p "liste les fichiers TypeScript de ce projet"

Au premier lancement, Claude Code vous demandera de vous authentifier. Suivez les instructions affichées dans le terminal.

L'interface interactive

Une fois lancé, Claude Code vous présente un prompt interactif :

╭─────────────────────────────────────────╮
│ Claude Code                             │
│                                         │
│ /help for help                          │
╰─────────────────────────────────────────╯

>

Vous pouvez taper directement vos instructions en langage naturel. Claude comprend le contexte de votre projet (fichiers, structure, git, etc.) et peut agir dessus.

Concepts clés

Le contexte de travail

Claude Code travaille dans le répertoire courant. Il peut :

  • Lire des fichiers du projet
  • Modifier des fichiers existants
  • Créer de nouveaux fichiers
  • Exécuter des commandes bash
  • Rechercher dans le code avec des outils optimisés

Le système de permissions

Claude Code demande votre autorisation avant d'effectuer des actions potentiellement destructives :

  • Lecture : généralement autorisée automatiquement
  • Écriture/Modification : demande de confirmation
  • Exécution de commandes : demande de confirmation
  • Actions Git : demande de confirmation

Vous pouvez configurer le niveau de permission pour adapter le comportement à vos besoins.

Le fichier CLAUDE.md

Le fichier CLAUDE.md à la racine de votre projet sert de mémoire persistante. Claude Code le lit automatiquement au démarrage. Vous pouvez y placer :

  • Les conventions de code du projet
  • Les instructions spécifiques pour Claude
  • Les commandes de build/test importantes
  • Les patterns architecturaux à respecter
# CLAUDE.md

## Conventions
- Utiliser TypeScript strict
- Toujours écrire les tests avec Vitest
- Commits en français avec conventional commits

## Commandes utiles
- `npm run build` : build le projet
- `npm run test` : lancer les tests
- `npm run lint` : vérifier le linting

Modes de fonctionnement

Mode interactif (par défaut)

claude

Ouvre une session conversationnelle. Vous échangez avec Claude en temps réel, il exécute des actions et attend vos retours.

Mode one-shot (pipe)

claude -p "corrige les erreurs TypeScript dans src/"

Exécute une instruction unique et retourne le résultat. Idéal pour les scripts et l'automatisation.

Mode avec reprise de conversation

# Reprendre la dernière conversation
claude --continue

# Reprendre une conversation spécifique
claude --resume