Claude Code (CLI) : Guide de référence rapide

Installation

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

# Vérifier l'installation
claude --version

# Authentification (ouvre le flux OAuth dans le navigateur)
claude
# Ou avec une clé API directement
export ANTHROPIC_API_KEY="sk-ant-..."

Modes de lancement

# Session interactive dans le répertoire courant
claude

# One-shot : prompt direct, réponse, sortie immédiate
claude -p "Explique ce que fait ce script bash : $(cat script.sh)"

# Continuer la session précédente
claude --continue
claude -c

# Reprendre une session spécifique par ID
claude --resume 
claude -r 

Flags courants

Slash commands (dans une session interactive)

/help              Liste des commandes disponibles
/clear             Efface le contexte de la conversation courante
/compact           Résume la conversation pour libérer du contexte
/model             Change de modèle pour la session
/permissions       Affiche/modifie les permissions accordées
/agents            Liste les sous-agents disponibles
/mcp               Statut des serveurs MCP connectés
/init              Génère un fichier CLAUDE.md de démarrage pour le projet
/review            Lance une revue de code sur les changements courants

CLAUDE.md – contexte projet persistant

# CLAUDE.md

Conventions du projet, stack technique, commandes de build/test,
règles de style - tout ce qui doit être rappelé automatiquement
à chaque session dans ce répertoire.

Placé à la racine du repo (ou dans un dossier parent), lu automatiquement au démarrage de chaque session dans ce répertoire ou ses sous-dossiers. Sert de mémoire persistante sans avoir à retaper le contexte projet à chaque fois.

Permissions

Claude Code demande une confirmation avant chaque action qui modifie le système (écrire un fichier, exécuter une commande shell, etc.), sauf configuration explicite pour l’autoriser à l’avance.

# Config utilisateur - persiste entre sessions
# ~/.claude/settings.json

{
  "permissions": {
    "allow": ["Bash(git status)", "Bash(git diff)"],
    "deny": ["Bash(rm -rf *)"]
  }
}

MCP (Model Context Protocol)

# Ajouter un serveur MCP à la config du projet
claude mcp add  

# Lister les serveurs configurés
claude mcp list

# Retirer un serveur
claude mcp remove 

Les serveurs MCP exposent des outils supplémentaires (accès à une base de données, une API externe, un système de fichiers distant) que Claude Code peut appeler pendant une session, au-delà de ses capacités de base (lecture/écriture de fichiers, exécution shell).

Sous-agents

Un sous-agent est une instance Claude Code lancée pour une tâche
déléguée spécifique, avec son propre contexte, isolée de la
conversation principale. Utile pour des recherches ou tâches
longues dont le détail d'exécution n'a pas besoin d'encombrer
le contexte principal.

Bonnes pratiques

• Un CLAUDE.md à jour vaut mieux qu’un long prompt répété. Documenter les conventions une fois, pas à chaque session.
• Vérifier les commandes proposées avant de confirmer, surtout sur un système en production – la confirmation existe pour être lue, pas pour être cliquée par réflexe.
• /compact avant que le contexte ne devienne trop long plutôt que de laisser la session dériver – une conversation compacte reste plus précise.
• Scoper les permissions allow au strict nécessaire (lecture seule, commandes non destructives) plutôt que d’autoriser large pour gagner en confort.