Passer au contenu principal

Commandes CLI

Vous pouvez démarrer des sessions, traiter du contenu, reprendre des conversations et gérer les mises à jour avec ces commandes :
CommandeDescriptionExemple
claudeDémarrer une session interactiveclaude
claude "query"Démarrer une session interactive avec une invite initialeclaude "explain this project"
claude -p "query"Interroger via SDK, puis quitterclaude -p "explain this function"
cat file | claude -p "query"Traiter le contenu canalisécat logs.txt | claude -p "explain"
claude -cContinuer la conversation la plus récente dans le répertoire courantclaude -c
claude -c -p "query"Continuer via SDKclaude -c -p "Check for type errors"
claude -r "<session>" "query"Reprendre une session par ID ou nomclaude -r "auth-refactor" "Finish this PR"
claude updateMettre à jour vers la dernière versionclaude update
claude auth loginSe connecter à votre compte Anthropic. Utilisez --email pour pré-remplir votre adresse e-mail et --sso pour forcer l’authentification SSOclaude auth login --email [email protected] --sso
claude auth logoutSe déconnecter de votre compte Anthropicclaude auth logout
claude auth statusAfficher l’état de l’authentification en JSON. Utilisez --text pour une sortie lisible par l’homme. Quitte avec le code 0 si connecté, 1 sinonclaude auth status
claude agentsLister tous les subagents configurés, groupés par sourceclaude agents
claude mcpConfigurer les serveurs Model Context Protocol (MCP)Voir la documentation Claude Code MCP.
claude remote-controlDémarrer une session Remote Control pour contrôler Claude Code depuis Claude.ai ou l’application Claude tout en exécutant localement. Voir Remote Control pour les drapeauxclaude remote-control

Drapeaux CLI

Personnalisez le comportement de Claude Code avec ces drapeaux de ligne de commande :
DrapeauDescriptionExemple
--add-dirAjouter des répertoires de travail supplémentaires pour que Claude y accède (valide que chaque chemin existe en tant que répertoire)claude --add-dir ../apps ../lib
--agentSpécifier un agent pour la session actuelle (remplace le paramètre agent)claude --agent my-custom-agent
--agentsDéfinir des subagents personnalisés dynamiquement via JSON (voir ci-dessous pour le format)claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'
--allow-dangerously-skip-permissionsActiver le contournement des permissions en tant qu’option sans l’activer immédiatement. Permet de composer avec --permission-mode (à utiliser avec prudence)claude --permission-mode plan --allow-dangerously-skip-permissions
--allowedToolsOutils qui s’exécutent sans demander la permission. Voir syntaxe des règles de permission pour la correspondance de motifs. Pour restreindre les outils disponibles, utilisez --tools à la place"Bash(git log *)" "Bash(git diff *)" "Read"
--append-system-promptAjouter du texte personnalisé à la fin de l’invite système par défautclaude --append-system-prompt "Always use TypeScript"
--append-system-prompt-fileCharger du texte d’invite système supplémentaire à partir d’un fichier et l’ajouter à l’invite par défautclaude --append-system-prompt-file ./extra-rules.txt
--betasEn-têtes bêta à inclure dans les requêtes API (utilisateurs de clé API uniquement)claude --betas interleaved-thinking
--chromeActiver l’intégration du navigateur Chrome pour l’automatisation web et les testsclaude --chrome
--continue, -cCharger la conversation la plus récente dans le répertoire courantclaude --continue
--dangerously-skip-permissionsIgnorer toutes les invites de permission (à utiliser avec prudence)claude --dangerously-skip-permissions
--debugActiver le mode débogage avec filtrage de catégorie optionnel (par exemple, "api,hooks" ou "!statsig,!file")claude --debug "api,mcp"
--disable-slash-commandsDésactiver tous les skills et commandes pour cette sessionclaude --disable-slash-commands
--disallowedToolsOutils qui sont supprimés du contexte du modèle et ne peuvent pas être utilisés"Bash(git log *)" "Bash(git diff *)" "Edit"
--fallback-modelActiver le basculement automatique vers le modèle spécifié lorsque le modèle par défaut est surchargé (mode impression uniquement)claude -p --fallback-model sonnet "query"
--fork-sessionLors de la reprise, créer un nouvel ID de session au lieu de réutiliser l’original (à utiliser avec --resume ou --continue)claude --resume abc123 --fork-session
--from-prReprendre les sessions liées à une PR GitHub spécifique. Accepte un numéro de PR ou une URL. Les sessions sont automatiquement liées lors de la création via gh pr createclaude --from-pr 123
--ideSe connecter automatiquement à l’IDE au démarrage s’il y a exactement un IDE valide disponibleclaude --ide
--initExécuter les hooks d’initialisation et démarrer le mode interactifclaude --init
--init-onlyExécuter les hooks d’initialisation et quitter (pas de session interactive)claude --init-only
--include-partial-messagesInclure les événements de streaming partiels dans la sortie (nécessite --print et --output-format=stream-json)claude -p --output-format stream-json --include-partial-messages "query"
--input-formatSpécifier le format d’entrée pour le mode impression (options : text, stream-json)claude -p --output-format json --input-format stream-json
--json-schemaObtenir une sortie JSON validée correspondant à un JSON Schema après que l’agent ait terminé son flux de travail (mode impression uniquement, voir structured outputs)claude -p --json-schema '{"type":"object","properties":{...}}' "query"
--maintenanceExécuter les hooks de maintenance et quitterclaude --maintenance
--max-budget-usdMontant en dollars maximum à dépenser pour les appels API avant d’arrêter (mode impression uniquement)claude -p --max-budget-usd 5.00 "query"
--max-turnsLimiter le nombre de tours agentiques (mode impression uniquement). Quitte avec une erreur lorsque la limite est atteinte. Pas de limite par défautclaude -p --max-turns 3 "query"
--mcp-configCharger les serveurs MCP à partir de fichiers ou de chaînes JSON (séparés par des espaces)claude --mcp-config ./mcp.json
--modelDéfinit le modèle pour la session actuelle avec un alias pour le dernier modèle (sonnet ou opus) ou le nom complet d’un modèleclaude --model claude-sonnet-4-6
--no-chromeDésactiver l’intégration du navigateur Chrome pour cette sessionclaude --no-chrome
--no-session-persistenceDésactiver la persistance de session afin que les sessions ne soient pas enregistrées sur le disque et ne puissent pas être reprises (mode impression uniquement)claude -p --no-session-persistence "query"
--output-formatSpécifier le format de sortie pour le mode impression (options : text, json, stream-json)claude -p "query" --output-format json
--permission-modeCommencer dans un mode de permission spécifiéclaude --permission-mode plan
--permission-prompt-toolSpécifier un outil MCP pour gérer les invites de permission en mode non interactifclaude -p --permission-prompt-tool mcp_auth_tool "query"
--plugin-dirCharger les plugins à partir de répertoires pour cette session uniquement (répétable)claude --plugin-dir ./my-plugins
--print, -pImprimer la réponse sans mode interactif (voir la documentation Agent SDK pour les détails d’utilisation programmatique)claude -p "query"
--remoteCréer une nouvelle session web sur claude.ai avec la description de tâche fournieclaude --remote "Fix the login bug"
--resume, -rReprendre une session spécifique par ID ou nom, ou afficher un sélecteur interactif pour choisir une sessionclaude --resume auth-refactor
--session-idUtiliser un ID de session spécifique pour la conversation (doit être un UUID valide)claude --session-id "550e8400-e29b-41d4-a716-446655440000"
--setting-sourcesListe séparée par des virgules des sources de paramètres à charger (user, project, local)claude --setting-sources user,project
--settingsChemin vers un fichier JSON de paramètres ou une chaîne JSON pour charger des paramètres supplémentairesclaude --settings ./settings.json
--strict-mcp-configUtiliser uniquement les serveurs MCP de --mcp-config, en ignorant toutes les autres configurations MCPclaude --strict-mcp-config --mcp-config ./mcp.json
--system-promptRemplacer l’invite système entière par du texte personnaliséclaude --system-prompt "You are a Python expert"
--system-prompt-fileCharger l’invite système à partir d’un fichier, remplaçant l’invite par défautclaude --system-prompt-file ./custom-prompt.txt
--teleportReprendre une session web dans votre terminal localclaude --teleport
--teammate-modeDéfinir comment les coéquipiers de l’équipe d’agents s’affichent : auto (par défaut), in-process, ou tmux. Voir configurer les équipes d’agentsclaude --teammate-mode in-process
--toolsRestreindre les outils intégrés que Claude peut utiliser. Utilisez "" pour désactiver tous, "default" pour tous, ou des noms d’outils comme "Bash,Edit,Read"claude --tools "Bash,Edit,Read"
--verboseActiver la journalisation détaillée, affiche la sortie complète tour par tourclaude --verbose
--version, -vAfficher le numéro de versionclaude -v
--worktree, -wDémarrer Claude dans un git worktree isolé à <repo>/.claude/worktrees/<name>. Si aucun nom n’est donné, un est généré automatiquementclaude -w feature-auth
Le drapeau --output-format json est particulièrement utile pour les scripts et l’automatisation, vous permettant d’analyser les réponses de Claude par programmation.

Format du drapeau agents

Le drapeau --agents accepte un objet JSON qui définit un ou plusieurs subagents personnalisés. Chaque subagent nécessite un nom unique (comme clé) et un objet de définition avec les champs suivants :
ChampRequisDescription
descriptionOuiDescription en langage naturel du moment où le subagent doit être invoqué
promptOuiL’invite système qui guide le comportement du subagent
toolsNonTableau des outils spécifiques que le subagent peut utiliser, par exemple ["Read", "Edit", "Bash"]. S’il est omis, hérite de tous les outils. Supporte la syntaxe Agent(agent_type)
disallowedToolsNonTableau des noms d’outils à explicitement refuser pour ce subagent
modelNonAlias de modèle à utiliser : sonnet, opus, haiku, ou inherit. S’il est omis, par défaut inherit
skillsNonTableau des noms de skill à précharger dans le contexte du subagent
mcpServersNonTableau des serveurs MCP pour ce subagent. Chaque entrée est une chaîne de nom de serveur ou un objet {name: config}
maxTurnsNonNombre maximum de tours agentiques avant que le subagent s’arrête
Exemple :
claude --agents '{
  "code-reviewer": {
    "description": "Expert code reviewer. Use proactively after code changes.",
    "prompt": "You are a senior code reviewer. Focus on code quality, security, and best practices.",
    "tools": ["Read", "Grep", "Glob", "Bash"],
    "model": "sonnet"
  },
  "debugger": {
    "description": "Debugging specialist for errors and test failures.",
    "prompt": "You are an expert debugger. Analyze errors, identify root causes, and provide fixes."
  }
}'
Pour plus de détails sur la création et l’utilisation de subagents, voir la documentation des subagents.

Drapeaux d’invite système

Claude Code fournit quatre drapeaux pour personnaliser l’invite système. Les quatre fonctionnent à la fois en mode interactif et non interactif.
DrapeauComportementCas d’utilisation
--system-promptRemplace l’invite par défaut entièreContrôle complet sur le comportement et les instructions de Claude
--system-prompt-fileRemplace par le contenu du fichierCharger les invites à partir de fichiers pour la reproductibilité et le contrôle de version
--append-system-promptAjoute à l’invite par défautAjouter des instructions spécifiques tout en conservant le comportement par défaut de Claude Code
--append-system-prompt-fileAjoute le contenu du fichier à l’invite par défautCharger des instructions supplémentaires à partir de fichiers tout en conservant les valeurs par défaut
Quand utiliser chacun :
  • --system-prompt : utilisez lorsque vous avez besoin d’un contrôle complet sur l’invite système de Claude. Cela supprime toutes les instructions Claude Code par défaut, vous donnant une ardoise vierge.
    claude --system-prompt "You are a Python expert who only writes type-annotated code"
    
  • --system-prompt-file : utilisez lorsque vous souhaitez charger une invite personnalisée à partir d’un fichier, utile pour la cohérence d’équipe ou les modèles d’invite contrôlés par version.
    claude --system-prompt-file ./prompts/code-review.txt
    
  • --append-system-prompt : utilisez lorsque vous souhaitez ajouter des instructions spécifiques tout en conservant les capacités par défaut de Claude Code. C’est l’option la plus sûre pour la plupart des cas d’utilisation.
    claude --append-system-prompt "Always use TypeScript and include JSDoc comments"
    
  • --append-system-prompt-file : utilisez lorsque vous souhaitez ajouter des instructions à partir d’un fichier tout en conservant les valeurs par défaut de Claude Code. Utile pour les ajouts contrôlés par version.
    claude --append-system-prompt-file ./prompts/style-rules.txt
    
--system-prompt et --system-prompt-file s’excluent mutuellement. Les drapeaux d’ajout peuvent être utilisés ensemble avec l’un ou l’autre drapeau de remplacement. Pour la plupart des cas d’utilisation, --append-system-prompt ou --append-system-prompt-file est recommandé car ils préservent les capacités intégrées de Claude Code tout en ajoutant vos exigences personnalisées. Utilisez --system-prompt ou --system-prompt-file uniquement lorsque vous avez besoin d’un contrôle complet sur l’invite système.

Voir aussi