Pour commencer

Claude Code propose deux façons principales d’interagir :

  • Mode interactif : Exécutez claude pour démarrer une session REPL
  • Mode unique : Utilisez claude -p "requête" pour des commandes rapides
# Démarrer le mode interactif
claude

# Démarrer avec une requête initiale
claude "expliquer ce projet"

# Exécuter une seule commande et quitter
claude -p "que fait cette fonction ?"

# Traiter le contenu transmis par pipe
cat logs.txt | claude -p "analyser ces erreurs"

Commandes CLI

CommandeDescriptionExemple
claudeDémarrer le REPL interactifclaude
claude "requête"Démarrer le REPL avec une invite initialeclaude "expliquer ce projet"
claude -p "requête"Exécuter une requête unique, puis quitterclaude -p "expliquer cette fonction"
cat file | claude -p "requête"Traiter le contenu transmis par pipecat logs.txt | claude -p "expliquer"
claude -cContinuer la conversation la plus récenteclaude -c
claude -c -p "requête"Continuer en mode impressionclaude -c -p "Vérifier les erreurs de type"
claude -r "<session-id>" "requête"Reprendre une session par IDclaude -r "abc123" "Terminer cette PR"
claude configConfigurer les paramètresclaude config set --global theme dark
claude updateMettre à jour vers la dernière versionclaude update
claude mcpConfigurer les serveurs Model Context ProtocolVoir la section MCP dans les tutoriels

Drapeaux CLI

Personnalisez le comportement de Claude Code avec ces drapeaux de ligne de commande :

DrapeauDescriptionExemple
--print, -pImprimer la réponse sans mode interactif (voir documentation détaillée du mode impression ci-dessous)claude -p "requête"
--output-formatSpécifier le format de sortie pour le mode impression (options : text, json, stream-json)claude -p "requête" --output-format json
--verboseActiver la journalisation détaillée, affiche la sortie complète tour par tour (utile pour le débogage en mode impression et interactif)claude --verbose
--max-turnsLimiter le nombre de tours agentiques en mode non interactifclaude -p --max-turns 3 "requête"
--permission-prompt-toolSpécifier un outil MCP pour gérer les invites d’autorisation en mode non interactifclaude -p --permission-prompt-tool mcp_auth_tool "requête"
--resumeReprendre une session spécifique par ID, ou en choisissant en mode interactifclaude --resume abc123 "requête"
--continueCharger la conversation la plus récente dans le répertoire actuelclaude --continue
--dangerously-skip-permissionsIgnorer les invites d’autorisation (à utiliser avec précaution)claude --dangerously-skip-permissions

Le drapeau --output-format json est particulièrement utile pour les scripts et l’automatisation, permettant d’analyser les réponses de Claude de manière programmatique.

Détails du mode impression

Le drapeau -p (ou --print) active le mode non interactif dans Claude Code, permettant de transmettre l’entrée et la sortie pour une utilisation programmatique. Ce drapeau prend en charge divers formats de sortie pour différents cas d’utilisation.

Utilisation de base

# Mode impression de base - affiche uniquement le texte de réponse final
claude -p "Expliquer comment utiliser le drapeau print"

# Avec entrée stdin
echo "Combien font 2+2 ?" | claude -p

# Reprendre une session en mode impression avec une invite
claude -p --resume <session-id> "Reprendre la session avec cette invite"

Formats de sortie

L’option --output-format (utilisée avec -p) prend en charge trois formats :

1. Sortie texte (par défaut)
claude -p "Expliquer les formats de sortie"
# Affiche uniquement le texte de réponse
2. Sortie JSON
claude -p --output-format json "Expliquer comment utiliser la sortie JSON"

Produit un objet JSON structuré :

{
  "cost_usd": 0.003,
  "duration_ms": 1234,
  "duration_api_ms": 800,
  "result": "Le texte de réponse ici...",
  "session_id": "abc123"
}
3. Sortie JSON en streaming
claude -p --output-format stream-json "Créer un script Python"

En mode streaming, chaque message est émis sous forme d’objet JSON distinct au fur et à mesure de sa réception :

  • Messages d’utilisation d’outils
  • Messages texte de l’assistant
  • Messages de résultat d’outils
  • Message système final avec statistiques

Sortie détaillée avec le mode impression

Lors de l’utilisation de --verbose avec -p, il doit être associé à --output-format json ou --output-format stream-json :

claude -p --verbose --output-format json "Déboguer ce code"

En mode JSON détaillé, la sortie inclut la transcription complète de la conversation :

[
  {
    "role": "user",
    "content": "Déboguer ce code"
  },
  {
    "role": "assistant",
    "content": "Je vais vous aider à déboguer ce code..."
  },
  {
    "role": "system",
    "cost_usd": 0.003,
    "duration_ms": 1234,
    "duration_api_ms": 800,
    "result": "Le texte de réponse ici...",
    "session_id": "abc123"
  }
]

Options supplémentaires pour le mode impression

Nombre maximum de tours
claude -p --max-turns 3 "Corriger ce code" < file.py

Limite le nombre de tours agentiques en mode non interactif.

Outil d’invite d’autorisation
claude -p --permission-prompt-tool mcp_auth_tool "Créer un fichier"

Spécifie un outil MCP pour gérer les invites d’autorisation en mode non interactif.

Reprendre une session
claude -p --resume abc123 "Reprendre la session avec cette invite"

Reprendre une session spécifique par ID en mode impression avec une nouvelle invite.

Continuer une session

claude -c -p "Continuer avec cette tâche suivante"

Continuer la dernière conversation dans ce projet.

Commandes slash

Contrôlez le comportement de Claude pendant une session interactive :

CommandeObjectif
/bugSignaler des bugs (envoie la conversation à Anthropic)
/clearEffacer l’historique de conversation
/compact [instructions]Compacter la conversation avec des instructions de focus optionnelles
/configVoir/modifier la configuration
/costAfficher les statistiques d’utilisation des tokens
/doctorVérifie l’état de votre installation Claude Code
/helpObtenir de l’aide sur l’utilisation
/initInitialiser le projet avec le guide CLAUDE.md
/loginChanger de compte Anthropic
/logoutSe déconnecter de votre compte Anthropic
/memoryÉditer les fichiers mémoire CLAUDE.md
/pr_commentsVoir les commentaires de pull request
/reviewDemander une revue de code
/statusVoir les statuts du compte et du système
/terminal-setupInstaller le raccourci Shift+Enter pour les sauts de ligne (iTerm2 et VSCode uniquement)
/vimEntrer en mode vim pour alterner entre les modes insertion et commande

Raccourcis spéciaux

Mémoire rapide avec #

Ajoutez des mémoires instantanément en commençant votre saisie par # :

# Toujours utiliser des noms de variables descriptifs

On vous demandera de sélectionner dans quel fichier mémoire stocker ceci.

Sauts de ligne dans le terminal

Entrez des commandes multiligne en utilisant :

  • Échappement rapide : Tapez \ suivi d’Entrée
  • Raccourci clavier : Option+Entrée (ou Shift+Entrée si configuré)

Pour configurer Option+Entrée dans votre terminal :

Pour Mac Terminal.app :

  1. Ouvrez Paramètres → Profils → Clavier
  2. Cochez “Utiliser Option comme touche Meta”

Pour iTerm2 et terminal VSCode :

  1. Ouvrez Paramètres → Profils → Touches
  2. Sous Général, définissez la touche Option gauche/droite sur “Esc+”

Conseil pour les utilisateurs iTerm2 et VSCode : Exécutez /terminal-setup dans Claude Code pour configurer automatiquement Shift+Entrée comme alternative plus intuitive.

Voir configuration du terminal dans les paramètres pour plus de détails sur la configuration.

Mode Vim

Claude Code prend en charge un sous-ensemble de raccourcis Vim qui peuvent être activés avec /vim ou configurés via /config.

Le sous-ensemble pris en charge comprend :

  • Changement de mode : Esc (vers NORMAL), i/I, a/A, o/O (vers INSERT)
  • Navigation : h/j/k/l, w/e/b, 0/$/^, gg/G
  • Édition : x, dw/de/db/dd/D, cw/ce/cb/cc/C, . (répéter)