SpyBara
Go Premium

cli-reference.md 2026-10-21 23:02 UTC to 2026-10-22 22:58 UTC

This page contains 81 additions and 81 deletions.

2026
Thu 1 23:59 Fri 2 22:59 Sat 3 23:57 Tue 6 23:59 Wed 7 23:59 Fri 9 23:02 Sat 10 23:01 Sat 17 23:57 Mon 19 23:58 Tue 20 23:00 Wed 21 23:02 Thu 22 22:58 Fri 23 22:59 Tue 27 22:59 Thu 29 23:57

Référence CLI

Référence complète pour l'interface de ligne de commande Claude Code, incluant les commandes et les drapeaux.

Commandes CLI

Vous pouvez démarrer des sessions, traiter du contenu, reprendre des conversations et gérer les mises à jour avec ces commandes :

Commande Description Exemple
claude Démarrer une session interactive claude
claude "query" Démarrer une session interactive avec un prompt initial claude "explain this project"
claude -p "query" Interroger via SDK, puis quitter claude -p "explain this function"
cat file | claude -p "query" Traiter le contenu canalisé cat logs.txt | claude -p "explain"
claude -c Continuer la conversation la plus récente dans le répertoire courant claude -c
claude -c -p "query" Continuer via SDK claude -c -p "Check for type errors"
claude -r "<session>" "query" Reprendre une session par ID ou nom claude -r "auth-refactor" "Finish this PR"
claude update Mettre à jour vers la dernière version claude update
claude gateway Démarrer le serveur passerelle d'applications Claude auto-hébergé, pour les administrateurs déployant SSO et la politique devant Claude Code sur Amazon Bedrock, Google Cloud's Agent Platform, ou Microsoft Foundry. Nécessite --config pointant vers un gateway.yaml. claude gateway --config gateway.yaml
claude install [version] Installer ou réinstaller le binaire natif. Accepte une version comme 2.1.118, ou stable ou latest. Voir Installer une version spécifique claude install stable
claude auth login Se connecter à votre compte Anthropic. Utilisez --email pour pré-remplir votre adresse e-mail, --sso pour forcer l'authentification SSO, et --console pour vous connecter avec Anthropic Console pour la facturation de l'utilisation de l'API au lieu d'un abonnement Claude claude auth login --console
claude auth logout Se déconnecter de votre compte Anthropic claude auth logout
claude auth status Afficher l'état d'authentification en JSON. Utilisez --text pour une sortie lisible par l'homme. Quitte avec le code 0 si connecté, 1 sinon. Le JSON inclut un champ configDirectory nommant le répertoire de configuration que l'interface de ligne de commande utilise. Le champ nécessite Claude Code v2.1.268 ou ultérieur. Le champ authMethod du JSON prend l'une des valeurs none, claude.ai, oauth_token, api_key, api_key_helper ou third_party claude auth status
claude agents Ouvrir la vue agent pour surveiller et dispatcher les sessions d'arrière-plan parallèles. Utilisez --cwd <path> pour afficher uniquement les sessions démarrées sous ce répertoire, ou --json pour imprimer les sessions actives en tant que tableau JSON pour les scripts (--json --all inclut également les sessions d'arrière-plan terminées). Passez --permission-mode, --model, --effort, ou --agent pour définir les valeurs par défaut pour les sessions dispatched. Accepte --settings, --add-dir, --plugin-dir, et --mcp-config comme la commande claude de niveau supérieur. L'ouverture de la vue agent nécessite un terminal interactif claude agents --json
claude attach <id|name> Attacher à une session d'arrière-plan dans ce terminal. Passer une partie du nom d'une session en cours d'exécution à la place de l'ID nécessite Claude Code v2.1.290 ou ultérieur claude attach 7c5dcf5d
claude auto-mode defaults Imprimer les règles du classificateur mode auto intégrées en JSON. Utilisez claude auto-mode config pour voir votre configuration effective avec les paramètres appliqués. --label <prefix> imprime uniquement les règles dont l'étiquette commence par ce préfixe, correspondance insensible à la casse. Nécessite Claude Code v2.1.208 ou ultérieur claude auto-mode defaults --label 'Git Destructive'
claude auto-mode reset Restaurer la configuration mode auto par défaut en supprimant la section autoMode de votre fichier de paramètres utilisateur. Demande une confirmation avant d'écrire ; passez -y/--yes pour ignorer la demande. Les règles des paramètres gérés ou du flag --settings s'appliquent toujours. Nécessite Claude Code v2.1.212 ou ultérieur. Voir Inspecter les valeurs par défaut et votre configuration effective claude auto-mode reset --yes
claude daemon logs Suivre le fichier de log du superviseur de session d'arrière-plan, ~/.claude/daemon.log, en imprimant les nouvelles lignes à mesure qu'elles arrivent jusqu'à ce que vous appuyiez sur Ctrl+C claude daemon logs
claude daemon run Exécuter le superviseur de session d'arrière-plan au premier plan de ce terminal, en imprimant son log claude daemon run
claude daemon status Imprimer l'état du superviseur de session d'arrière-plan, la version, le répertoire socket, et le nombre de workers pour les diagnostics. Quitte avec 1 si le superviseur n'est pas en cours d'exécution claude daemon status
claude daemon stop --any Arrêter le superviseur de session d'arrière-plan et les sessions qu'il héberge. Passez --keep-workers pour laisser les sessions d'arrière-plan en cours d'exécution afin que le superviseur suivant se reconnecte à elles. --any confirme l'arrêt d'un superviseur à la demande, qui est la valeur par défaut. Utilisez ceci pour récupérer d'un superviseur qui ne répond pas claude daemon stop --any --keep-workers
claude doctor Imprimer les diagnostics d'installation et de paramètres en lecture seule depuis le terminal sans démarrer une session, y compris la vérification de la santé de l'installation, les erreurs de validation du fichier de paramètres, et l'éligibilité à Remote Control. Pour la vérification de configuration en session qui peut également appliquer des correctifs, exécutez /doctor claude doctor
claude import [source] Démarrer une session interactive qui exécute /import pour apporter la configuration d'autres agents de codage dans Claude Code. Accepte les mêmes options --dry-run et --yes que la commande. Non disponible sur Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, ou Claude Platform sur AWS. Également indisponible quand vous désactivez la récupération des feature flags. Nécessite Claude Code v2.1.213 ou ultérieur claude import codex --dry-run
claude logs <id|name> Imprimer la sortie récente d'une session d'arrière-plan. Passer une partie du nom d'une session à la place de l'ID nécessite Claude Code v2.1.290 ou ultérieur claude logs 7c5dcf5d
claude mcp Configurer les serveurs Model Context Protocol (MCP) Voir la documentation Claude Code MCP.
claude mcp login <name> Exécuter le flux OAuth d'un serveur MCP configuré sans ouvrir le panneau interactif /mcp. Fonctionne pour les serveurs HTTP, SSE et les connecteurs claude.ai. Ajoutez --no-browser sur SSH pour imprimer l'URL d'autorisation au lieu d'ouvrir un navigateur. Pour un serveur HTTP ou SSE, collez l'URL de redirection à l'invite. Pour un connecteur claude.ai, voir Autoriser à nouveau un connecteur depuis votre shell. Voir S'authentifier à partir de la ligne de commande claude mcp login sentry
claude mcp logout <name> Effacer les identifiants OAuth stockés pour un serveur MCP claude mcp logout sentry
claude plugin Gérer les plugins Claude Code. Alias : claude plugins. Voir la référence des plugins pour les sous-commandes claude plugin install code-review@claude-plugins-official
claude purge [path] Supprimer tout l'état local de Claude Code pour un projet : transcriptions, listes de tâches, journaux de débogage, historique des modifications de fichiers, lignes d'historique des prompts, et l'entrée du projet dans ~/.claude.json. Omettez [path] pour choisir dans une liste interactive. Flags : --dry-run pour prévisualiser, -y/--yes pour ignorer la confirmation, -i/--interactive pour confirmer chaque élément, --all pour chaque projet. Voir Effacer les données locales claude purge ~/work/repo --dry-run
claude remote-control Démarrer un serveur Remote Control pour contrôler Claude Code depuis Claude.ai ou l'application Claude. S'exécute en mode serveur (pas de session interactive locale). Voir Flags du mode serveur. Après avoir arrêté le serveur, vous pouvez ramener les sessions qu'il servait. Voir Reprendre les sessions après l'arrêt du serveur claude remote-control --name "My Project"
claude respawn <id> Redémarrer une session d'arrière-plan, en cours d'exécution ou arrêtée, avec sa conversation intacte. Utilisez --all pour redémarrer chaque session en cours d'exécution, par exemple pour récupérer un binaire Claude Code mis à jour claude respawn 7c5dcf5d
claude rm <id> Supprimer une session d'arrière-plan de la liste. Quand la suppression est refusée sur le worktree de la session et qu'une deuxième claude rm peut la résoudre, le refus imprime le flag exact et la valeur à passer : --discard-unpushed <commit>@<worktree-id> abandonne un worktree qui a des commits non poussés ainsi que ces commits, et --force-remove-worktree <worktree-id> supprime un répertoire worktree que git ou le hook WorktreeRemove n'a pas pu supprimer. --discard-unpushed nécessite Claude Code v2.1.260 ou ultérieur, et --force-remove-worktree nécessite v2.1.268 ou ultérieur. La transcription de la conversation reste sur votre machine locale, disponible via claude --resume claude rm 7c5dcf5d
claude self-hosted-runner Démarrer un processus runner qui enregistre cette machine ou ce conteneur auprès d'un environnement auto-hébergé et héberge les sessions cloud Claude Code sur votre infrastructure. Exécutez claude self-hosted-runner setup pour une procédure pas à pas guidée de l'opérateur, claude self-hosted-runner doctor pour diagnostiquer un runner déployé, et claude self-hosted-runner orchestrator pour générer des runners à la demande. Nécessite Claude Code v2.1.224 ou ultérieur claude self-hosted-runner setup
claude setup-token Générer un jeton OAuth de longue durée pour CI et les scripts. Imprime le jeton sur le terminal sans l'enregistrer. Nécessite un abonnement Claude. Voir Générer un jeton de longue durée claude setup-token
claude stop <id> Arrêter une session d'arrière-plan. Accepte également claude kill claude stop 7c5dcf5d
claude ultrareview [target] Exécuter ultrareview de manière non interactive. Imprime les résultats sur stdout et quitte avec 0 en cas de succès ou 1 en cas d'échec. Utilisez --json pour le payload brut et --timeout <minutes> pour remplacer la valeur par défaut de 45 minutes. Utilisez --post sur une cible de pull request github.com pour publier les résultats terminés sur la PR en tant qu'un seul commentaire simple depuis votre compte GitHub. --no-post est la valeur par défaut. --post et --no-post nécessitent Claude Code v2.1.227 ou ultérieur. Voir Publier les résultats sur la pull request claude ultrareview 1234 --json

Si vous tapez mal une sous-commande, Claude Code suggère la correspondance la plus proche et quitte sans démarrer une session. Par exemple, claude udpate imprime Did you mean claude update?.

claude --dangerously-skip-permissions daemon <subcommand> exécute la sous-commande daemon, de sorte que la sous-commande fonctionne quand claude est aliasé pour inclure le flag. Seul un --dangerously-skip-permissions ou --allow-dangerously-skip-permissions en tête achemine vers daemon de cette façon ; avec tout autre flag placé avant daemon, la sous-commande ne s'exécute pas.

Drapeaux CLI

Personnalisez le comportement de Claude Code avec ces drapeaux de ligne de commande. claude --help ne répertorie pas tous les drapeaux, donc l'absence d'un drapeau dans --help ne signifie pas qu'il n'est pas disponible.

Drapeau Description Exemple
--add-dir Ajouter des répertoires de travail supplémentaires pour que Claude y accède et modifie les fichiers. Accorde l'accès aux fichiers ; Claude Code ne découvre pas la plupart de la configuration .claude/ à partir de ces répertoires. Valide que chaque chemin existe en tant que répertoire. Vous ne pouvez pas ajouter la plupart des chemins réseau, tels que \\server\share. Pour conserver ces répertoires entre les sessions, définissez permissions.additionalDirectories dans les paramètres claude --add-dir ../apps ../lib
--advisor <model> Activer l'outil advisor côté serveur pour cette session avec un alias de modèle, fable, opus, ou sonnet, ou un ID de modèle complet. Prend la priorité sur le paramètre advisorModel pour la session. fable nécessite l'accès à Fable claude --advisor opus
--agent Spécifier un agent pour la session actuelle (remplace le paramètre agent) claude --agent my-custom-agent
--agents Définir des subagents personnalisés dynamiquement via JSON. Accepte les champs répertoriés pour les subagents définis via CLI. Avec --print, la valeur peut être le chemin vers un fichier JSON contenant l'objet ; la forme fichier nécessite Claude Code v2.1.281 ou ultérieur. Claude Code valide la valeur au démarrage et quitte sur une valeur invalide ; voir Invalid --agents configuration pour le message et pour les drapeaux et la variable d'environnement qui ignorent la validation. La validation nécessite Claude Code v2.1.242 ou ultérieur claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'
--allow-dangerously-skip-permissions Ajouter bypassPermissions au cycle du mode Shift+Tab sans commencer dedans. Permet de commencer dans un mode différent comme plan et de basculer vers bypassPermissions plus tard. Voir modes de permission claude --permission-mode plan --allow-dangerously-skip-permissions
--allowedTools, --allowed-tools Outils qui s'exécutent sans demander la permission, à l'exception des lectures depuis des chemins réseau. Voir syntaxe des règles de permission pour la correspondance de motifs. Pour restreindre les outils disponibles, utilisez --tools à la place. Si vous nommez l'un des outils de suivi des tâches ici, Claude Code les active également pour la session "Bash(git log *)" "Bash(git diff *)" "Read"
--append-subagent-system-prompt Ajouter du texte personnalisé à la fin de l'invite système de chaque subagent, y compris les subagents imbriqués, à l'exception d'un subagent forké, qui réutilise l'invite de la conversation. S'applique uniquement en mode non interactif avec -p. Nécessite Claude Code v2.1.205 ou ultérieur claude -p --append-subagent-system-prompt "Cite file paths in every answer" "query"
--append-subagent-system-prompt-file Charger du texte à partir d'un fichier et l'ajouter aux invites système des subagents. Une alternative à --append-subagent-system-prompt pour le texte trop long pour passer sur la ligne de commande. Les deux drapeaux ne peuvent pas être combinés. S'applique uniquement en mode non interactif avec -p. Nécessite Claude Code v2.1.261 ou ultérieur claude -p --append-subagent-system-prompt-file ./subagent-rules.txt "query"
--append-system-prompt Ajouter du texte personnalisé à la fin de l'invite système par défaut claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Charger du texte d'invite système supplémentaire à partir d'un fichier et l'ajouter à l'invite par défaut claude --append-system-prompt-file ./extra-rules.txt
--autocompact <auto|tokens> Définir la fenêtre auto-compact pour cette session sans modifier vos paramètres enregistrés. Accepte les mêmes valeurs que /autocompact ; cette section couvre les formes de valeur et ce qui remplace le drapeau. Nécessite Claude Code v2.1.221 ou ultérieur claude --autocompact 500k
--ax-screen-reader Afficher une sortie accessible aux lecteurs d'écran : texte plat sans bordures décoratives ni animations. Force le rendu classique, donc le paramètre tui n'a aucun effet ; les sessions en arrière-plan attachées restent rendues en plein écran. Prend la priorité sur CLAUDE_AX_SCREEN_READER et le paramètre axScreenReader. Nécessite Claude Code v2.1.181 ou ultérieur claude --ax-screen-reader
--bare Mode minimal : ignorer la découverte automatique des hooks, skills, commandes personnalisées, subagents, plugins, serveurs MCP, mémoire automatique et CLAUDE.md afin que les appels scriptés démarrent plus rapidement. Les skills dans un répertoire que vous transmettez avec --add-dir se chargent toujours. Claude a accès aux outils Bash, lecture de fichier et édition de fichier. Définit CLAUDE_CODE_SIMPLE. Voir mode bare claude --bare -p "query"
--betas En-têtes bêta à inclure dans les requêtes API (utilisateurs de clé API uniquement) claude --betas interleaved-thinking
--bg, --background Démarrer la session en tant qu'agent en arrière-plan et revenir immédiatement. Affiche l'ID de session et les commandes de gestion. Combinez avec --exec pour exécuter une commande shell en tant que travail en arrière-plan au lieu d'une session Claude, ou avec --agent pour exécuter un subagent spécifique. Vérifie la confiance de l'espace de travail pour le répertoire avant de démarrer. Ne peut pas être combiné avec -p/--print ; voir la référence d'erreur claude --bg "investigate the flaky test"
--channels (Aperçu de recherche) Serveurs MCP dont les notifications de canal Claude doit écouter dans cette session. Liste séparée par des espaces d'entrées plugin:<name>@<marketplace>. Nécessite l'authentification Anthropic via claude.ai ou une clé API Console claude --channels plugin:my-notifier@my-marketplace
--chrome Activer l'intégration du navigateur Chrome pour l'automatisation web et les tests claude --chrome
--cloud Avec une description de tâche, créer une nouvelle session web. Avec un ID de session (session_... ou cse_...) ou une URL claude.ai/code, mettre en file d'attente un message dans cette session existante à la place, avec -p. Voir envoyer un message de suivi. claude --cloud "Fix the login bug"
--continue, -c Charger la conversation la plus récente dans le répertoire courant, y compris une session en arrière-plan qui a terminé ; l'ouverture de sessions en arrière-plan terminées nécessite Claude Code v2.1.257 ou ultérieur. Ignore les sessions créées avec claude -p ou le SDK Agent, et les sessions dont le premier prompt était /loop. claude -p --continue inclut les sessions -p, SDK et /loop. Inclut les sessions qui ont ajouté ce répertoire avec /add-dir claude --continue
--dangerously-load-development-channels Activer des canaux qui ne figurent pas sur la liste d'autorisation approuvée, pour le développement local. Accepte les entrées plugin:<name>@<marketplace> et server:<name>. Demande une confirmation, il prend donc effet dans les sessions interactives. Avec -p, Claude Code ignore le flag claude --dangerously-load-development-channels server:webhook
--dangerously-skip-permissions Ignorer les invites de permission. Équivalent à --permission-mode bypassPermissions. Voir modes de permission pour ce que cela ignore et n'ignore pas. Pour les sessions démarrées avec --bg, le mode persiste lorsque le superviseur redémarre la session claude --dangerously-skip-permissions
--debug Activer le mode débogage avec filtrage de catégorie optionnel, tel que --debug='mcp,startup' ou --debug='!mcp'. Le filtre se lie uniquement dans la forme = ; un filtre séparé par des espaces active le mode débogage sans filtrage claude --debug='mcp,startup'
--debug-file <path> Écrire les journaux de débogage dans un chemin de fichier spécifique. Active implicitement le mode débogage. Prend la priorité sur CLAUDE_CODE_DEBUG_LOGS_DIR claude --debug-file /tmp/claude-debug.log
--desktop Ouvrir l'application Claude Desktop sur le répertoire courant et quitter sans démarrer une session dans le terminal. Ajoutez --continue, ou --resume avec un ID de session, pour ouvrir cette session dans Desktop à la place. --resume ici prend uniquement un ID de session, pas un nom ou un chemin de transcription. Ne prend aucune invite et aucun autre drapeau sauf --verbose et les drapeaux --debug, puisque l'application démarre la session elle-même. Disponible sur macOS et Windows x64 lorsque vous êtes connecté avec un abonnement Claude. Nécessite Claude Code v2.1.285 ou ultérieur claude --desktop
--disable-slash-commands Désactiver tous les skills et commandes pour cette session claude --disable-slash-commands
--disallowedTools, --disallowed-tools Règles de refus. Un nom d'outil nu supprime les outils correspondants du contexte de Claude : "Edit" supprime Edit, "*" supprime tous les outils, et "mcp__*" supprime tous les outils MCP. Une règle délimitée telle que Bash(rm *) laisse l'outil disponible et refuse uniquement les appels correspondants tels qu'écrits. Une règle nommant EndConversation ne peut pas le supprimer tant que tout autre outil reste "Bash(git log *)" "Bash(git diff *)" "Edit"
--effort Définir le niveau d'effort pour la session actuelle. Options : low, medium, high, xhigh, max, ou ultracode. Les niveaux disponibles dépendent du modèle. ultracode demande l'effort xhigh avec ultracode activé, et nécessite Claude Code v2.1.203 ou ultérieur. Remplace les paramètres modelSettings et effortLevel pour cette session et ne persiste pas claude --effort high
--enable-auto-mode Supprimé dans v2.1.111. Le mode auto est maintenant dans le cycle Shift+Tab par défaut ; utilisez --permission-mode auto pour commencer dedans claude --permission-mode auto
--environment <environment-id> Créer une nouvelle session cloud qui s'exécute sur l'environnement auto-hébergé avec l'ID donné. Les ID d'environnement commencent par ccpool_. Voir comportement de dispatch --environment pour le comportement de dispatch et les combinaisons de drapeaux qu'il rejette. Nécessite Claude Code v2.1.224 ou ultérieur claude -p "Fix the login bug" --environment ccpool_abc123
--exclude-dynamic-system-prompt-sections Déplacer le contexte par utilisateur, tel que l'emplacement de la mémoire automatique, hors de l'invite système et dans le premier message utilisateur. Améliore la réutilisation du cache d'invite sur différents utilisateurs et machines exécutant la même tâche. S'applique uniquement avec l'invite système par défaut ; ignoré lorsque --system-prompt ou --system-prompt-file est défini. À utiliser avec -p pour les charges de travail scriptées multi-utilisateurs claude -p --exclude-dynamic-system-prompt-sections "query"
--exec Exécuter une commande shell en tant que travail en arrière-plan soutenu par PTY au lieu de démarrer une session Claude. À utiliser avec --bg pour lancer depuis le shell claude --bg --exec 'pytest -x'
--fallback-model Activer le basculement automatique vers le ou les modèles spécifiés lorsque le modèle principal est surchargé ou non disponible, par exemple un modèle retiré. Accepte une liste séparée par des virgules essayée dans l'ordre. Voir Chaînes de modèles de secours. Pour conserver une chaîne entre les sessions, utilisez le paramètre fallbackModel, que ce drapeau remplace claude --fallback-model sonnet,haiku
--fork-session Lors 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
--forward-subagent-text Émettre les blocs de texte et de réflexion des sous-agents dans le flux de sortie en tant que messages assistant et user avec parent_tool_use_id défini, afin que vous puissiez reconstruire la transcription de chaque sous-agent. Sans ce flag, Claude Code omet le texte et les blocs de réflexion d'un sous-agent qui s'exécute en avant-plan. Nécessite --print et --output-format stream-json. Pour les sous-agents imbriqués, les skills forkés et la version requise pour chacun, voir Suivre les messages des sous-agents. La variable d'environnement CLAUDE_CODE_FORWARD_SUBAGENT_TEXT active le même comportement. Nécessite Claude Code v2.1.211 ou ultérieur claude -p --output-format stream-json --verbose --forward-subagent-text "query"
--from-pr Ouvrir le sélecteur de session filtré aux sessions liées à une demande de tirage spécifique. Accepte un numéro de PR, une URL GitHub ou GitHub Enterprise PR, une URL de demande de fusion GitLab, ou une URL de demande de tirage Bitbucket. Les sessions sont automatiquement liées lorsque Claude crée la demande de tirage claude --from-pr 123
--ide Se connecter automatiquement à l'IDE au démarrage s'il y a exactement un IDE valide disponible claude --ide
--init Exécuter les hooks d'initialisation avec le matcher init avant la session (mode impression uniquement) claude -p --init "query"
--init-only Exécuter les hooks d'initialisation et SessionStart, puis quitter sans démarrer une conversation claude --init-only
--include-hook-events Inclure les événements du cycle de vie des hooks dans le flux de sortie. Les événements de hook SessionStart et Setup sont toujours inclus et n'ont pas besoin de ce drapeau. Certains événements de hook, tels que Notification, SessionEnd, PreCompact et PostCompact, ne produisent jamais d'événement hook_started, même avec ce drapeau. Pour ces événements, Claude Code émet toujours hook_progress tandis qu'un hook de commande qui s'exécute pendant plus d'une seconde produit une sortie, et émet hook_response uniquement lorsqu'un hook qui s'exécute en arrière-plan se termine. Nécessite --output-format stream-json claude -p --output-format stream-json --verbose --include-hook-events "query"
--include-partial-messages Inclure les événements de streaming partiels dans la sortie. Nécessite --print et --output-format stream-json claude -p --output-format stream-json --verbose --include-partial-messages "query"
--input-format Spécifier le format d'entrée pour le mode impression (options : text, stream-json) claude -p --output-format json --input-format stream-json
--json-schema Obtenir 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 Code quitte avec une erreur sur un schéma invalide et accepte le mot-clé format comme annotation sans validation côté client claude -p --json-schema '{"type":"object","properties":{...}}' "query"
--maintenance Exécuter les hooks d'initialisation avec le matcher maintenance avant la session (mode impression uniquement) claude -p --maintenance "query"
--max-budget-usd Arrêter l'exécution une fois que les dépenses estimées en appels API atteignent ce montant (mode impression uniquement). Claude Code compare le plafond à son estimation des coûts côté client, qui peut différer de votre facture. Les dépenses des sous-agents comptent dans le plafond. Les dépenses peuvent dépasser le plafond, donc prévoyez une marge. Lorsque vous revenez à une conversation avec --continue ou --resume, les totaux restaurés à partir des exécutions antérieures n'y comptent pas. Une fois que les dépenses atteignent le plafond, le lancement d'un autre sous-agent échoue avec Budget limit reached, et Claude Code arrête les sous-agents en arrière-plan qui s'exécutent encore ; les comportements d'application du plafond nécessitent Claude Code v2.1.217 ou ultérieur claude -p --max-budget-usd 5.00 "query"
--max-turns Limiter le nombre de tours d'agent (mode impression uniquement). Quitte avec une erreur lorsque la limite est atteinte. Pas de limite par défaut. Avec --input-format stream-json, un message toujours en file d'attente lorsque la limite termine un tour reste en file d'attente et démarre un nouveau tour avec sa propre limite claude -p --max-turns 3 "query"
--mcp-config Charger les serveurs MCP à partir de fichiers ou de chaînes JSON (séparés par des espaces). Lorsque vous transmettez ce flag avec -p, Claude Code attend que les serveurs encore en attente se connectent avant d'exécuter le premier tour, jusqu'au délai d'expiration de démarrage MCP_TIMEOUT, 30 secondes par défaut ; un serveur avec une liste d'outils mise en cache ignore l'attente et se connecte à la première utilisation. Dans un environnement auto-hébergé, une attente plus courte s'applique à la place. L'attente nécessite Claude Code v2.1.221 ou ultérieur claude --mcp-config ./mcp.json
--model Définit le modèle pour la session actuelle avec un alias de modèle tel que sonnet, opus, haiku, ou fable, ou le nom complet d'un modèle. Remplace le paramètre model et ANTHROPIC_MODEL claude --model claude-sonnet-5
--name, -n Définir un nom d'affichage pour la session, affiché dans /resume et le titre du terminal. Vous pouvez reprendre une session nommée avec claude --resume <name>. /rename change le nom en cours de session et l'affiche également dans la barre de prompt claude -n "my-feature-work"
--no-chrome Désactiver l'intégration du navigateur Chrome pour cette session claude --no-chrome
--no-session-persistence Dé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. La variable d'environnement CLAUDE_CODE_SKIP_PROMPT_HISTORY fait la même chose dans n'importe quel mode claude -p --no-session-persistence "query"
--output-format Spécifier le format de sortie pour le mode impression (options : text, json, stream-json) claude -p "query" --output-format json
--permission-mode Commencer dans un mode de permission spécifié. Accepte default, acceptEdits, plan, auto, dontAsk, bypassPermissions, ou manual comme alias pour default. L'alias manual sélectionne le mode de permission que l'interface utilisateur étiquette Manuel et nécessite Claude Code v2.1.200 ou ultérieur ; claude --help le répertorie à la place de default, et les deux valeurs fonctionnent. Remplace defaultMode des fichiers de paramètres. Sans ce drapeau ou --dangerously-skip-permissions, une nouvelle session démarre dans le mode de permission décrit dans quel mode de permission une session démarre, qui couvre également ce qu'une exécution -p démarre claude --permission-mode plan
--permission-prompt-tool Spécifier un outil MCP pour gérer les demandes de permission en mode non interactif. Passez le nom complet, tel que mcp__<server>__<tool>, d'un outil sur un serveur MCP que l'exécution charge. Claude Code attend que le serveur MCP de cet outil se connecte avant d'exécuter le premier tour, jusqu'au délai d'expiration de démarrage MCP_TIMEOUT, 30 secondes par défaut. L'outil de demande ne peut pas approuver un outil MCP marqué comme nécessitant une interaction utilisateur : Claude Code convertit un résultat allow pour celui-ci en refus. Cette restriction nécessite Claude Code v2.1.199 ou ultérieur claude -p --mcp-config ./mcp.json --permission-prompt-tool mcp__permissions__approve "query"
--permission-prompts Définir qui répond aux invites de permission en mode impression. Avec le host par défaut, Claude Code les envoie à l'hôte du SDK Agent ou à l'outil --permission-prompt-tool. Passez none lorsque personne ne peut répondre, et Claude Code les refuse à la place. Voir Désactiver les invites de permission dans les exécutions sans surveillance. Nécessite Claude Code v2.1.259 ou ultérieur claude -p --permission-prompts none "query"
--plugin-dir Charger un plugin à partir d'un répertoire ou d'une archive .zip, ou plusieurs à partir d'un dossier de plugins, pour cette session uniquement. Chaque drapeau prend un chemin. Répétez le drapeau pour plus de chemins : --plugin-dir A --plugin-dir B.zip. Passer un dossier de plugins nécessite Claude Code v2.1.265 ou ultérieur claude --plugin-dir ./my-plugin
--plugin-url Récupérer une archive .zip de plugin à partir d'une URL pour cette session uniquement. Répétez le drapeau pour plusieurs plugins, ou passez des URL séparées par des espaces dans une seule valeur entre guillemets claude --plugin-url https://example.com/plugin.zip
--print, -p Imprimer la réponse sans mode interactif (voir la documentation du SDK Agent pour les détails d'utilisation programmatique). Pour --resume sur une session en arrière-plan qui s'exécute toujours, voir Reprendre une session en arrière-plan en cours d'exécution claude -p "query"
--prompt-suggestions Émettre un message prompt_suggestion avec une prédiction du prochain message utilisateur après chaque tour qui en génère un ; les très courtes conversations peuvent n'en produire aucune. Nécessite --print, --output-format stream-json, et --verbose. Voir Suggestions d'invite claude -p --prompt-suggestions --output-format stream-json --verbose "query"
--ref <branch> Avec --environment, baser le checkout de la nouvelle session sur une ref nommée au lieu du HEAD local claude -p "Run the smoke test" --environment ccpool_abc123 --ref main
--remote Alias déprécié pour --cloud, y compris le formulaire de session existante claude --remote "Fix the login bug"
--remote-control, --rc Démarrer une session interactive avec Remote Control activé afin que vous puissiez également le contrôler depuis claude.ai ou l'application Claude. Optionnellement, passez un nom pour la session claude --remote-control "My Project"
--remote-control-session-name-prefix <prefix> Préfixe pour les noms de session Remote Control générés automatiquement lorsqu'aucun nom explicite n'est défini. Par défaut, le nom d'hôte de votre machine, produisant des noms comme myhost-graceful-unicorn. Définissez CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX pour le même effet claude remote-control --remote-control-session-name-prefix dev-box
--replay-user-messages Ré-émettre les messages utilisateur de stdin sur stdout pour la reconnaissance. Nécessite --input-format stream-json et --output-format stream-json claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages
--restricted Démarrer en mode restreint. Utilisez-le lorsqu'un harnais d'évaluation pilote claude sur une machine partagée et que Claude Code ne doit pas exécuter de commandes ou lire les paramètres utilisateur et projet de cette machine. Claude Code supprime les outils intégrés qui exécutent des commandes ou du code, et WebFetch, à moins que vous les nomiez individuellement dans --tools, pas via la présélection default. Il confine également les outils de fichier intégrés aux répertoires de travail, charge uniquement les paramètres gérés et --settings, refuse bypassPermissions, et refuse de créer des sessions cloud. Nécessite Claude Code v2.1.248 ou ultérieur claude --restricted -p "query"
--resume, -r Reprendre une session spécifique par ID ou nom, ou afficher un sélecteur interactif pour choisir une session. À la place d'un ID, vous pouvez passer le chemin absolu vers le fichier de transcription .jsonl d'une session. Le sélecteur et la recherche par nom incluent les sessions qui ont ajouté ce répertoire avec /add-dir. Lorsque vous transmettez un ID de session, Claude Code recherche le répertoire du projet actuel et ses git worktrees, puis tous les autres projets sur cette machine. Avant v2.1.223, la recherche d'ID couvrait uniquement le répertoire du projet actuel et ses git worktrees. Les sessions en arrière-plan apparaissent dans le sélecteur marquées avec bg. Reprendre une session qui s'exécute toujours ouvre cette session dans ce terminal via claude attach, et une invite que vous transmettez sur la ligne de commande lui est envoyée en tant que son prochain tour. Avant v2.1.285, Claude Code refusait et affichait la commande claude attach à exécuter à la place claude --resume auth-refactor
--safe-mode Démarrer avec toutes les personnalisations désactivées pour dépanner une configuration cassée : CLAUDE.md, skills, plugins, hooks, serveurs MCP, commandes et agents personnalisés, styles de sortie, workflows, thèmes personnalisés, liaisons de touches personnalisées, commandes de ligne d'état et de suggestion de fichiers, serveurs LSP, et mémoire automatique ne se chargent pas. L'authentification, la sélection du modèle, les outils intégrés et les permissions fonctionnent normalement, ce qui diffère de --bare. La politique des paramètres gérés s'applique toujours, y compris les hooks configurés par la politique, la ligne d'état et les commandes de suggestion de fichiers ; les plugins gérés, les skills gérés, le CLAUDE.md géré et les serveurs MCP configurés par la politique ne se chargent pas. Utile pour vérifier si une personnalisation est ce qui déclenche le basculement automatique du modèle. Définit CLAUDE_CODE_SAFE_MODE claude --safe-mode
--session-id Utiliser un ID de session spécifique pour la conversation (doit être un UUID valide) claude --session-id "550e8400-e29b-41d4-a716-446655440000"
--setting-sources Liste séparée par des virgules des sources de paramètres à charger (user, project, local). Voir agent view et agent teams pour les sessions que vous démarrez à partir de celle-ci qui héritent de la liste claude --setting-sources user,project
--settings Chemin vers un fichier JSON de paramètres ou une chaîne JSON en ligne. Les valeurs que vous définissez ici remplacent les mêmes clés dans vos fichiers settings.json pour cette session. Les clés que vous omettez conservent leurs valeurs basées sur les fichiers. Le fichier doit être un fichier régulier d'une taille maximale de 2 Mio. Voir précédence des paramètres claude --settings ./settings.json
--strict-mcp-config Utiliser uniquement les serveurs MCP de --mcp-config, en ignorant toutes les autres configurations MCP. Voir Contrôle exclusif avec managed-mcp.json pour ce que le drapeau fait sous un fichier MCP géré claude --strict-mcp-config --mcp-config ./mcp.json
--system-prompt Remplacer l'invite système entière par du texte personnalisé claude --system-prompt "You are a Python expert"
--system-prompt-file Charger l'invite système à partir d'un fichier, en remplaçant l'invite par défaut claude --system-prompt-file ./custom-prompt.txt
--system-prompt-snapshot Passer off pour reconstruire l'invite système à chaque requête au lieu de réutiliser l'invite enregistrée à la première requête de la conversation, par exemple pendant que vous itérez sur le texte --append-system-prompt entre les exécutions --continue. Nécessite Claude Code v2.1.257 ou ultérieur claude --system-prompt-snapshot off
--teleport Reprendre une session web dans votre terminal local claude --teleport
--teammate-mode Définir comment les coéquipiers de l'équipe d'agents s'affichent : in-process (par défaut), auto, tmux, ou iterm2. Remplace le paramètre teammateMode pour cette session. Voir Choisir un mode d'affichage claude --teammate-mode auto
--tmux Créer une session tmux pour le worktree. Nécessite --worktree. Utilise les volets natifs iTerm2 lorsqu'ils sont disponibles ; passez --tmux=classic pour le tmux traditionnel claude -w feature-auth --tmux
--tools Restreindre les outils intégrés que Claude peut utiliser. Utilisez "" pour désactiver tous, "default" pour l'ensemble par défaut, ou des noms d'outils comme "Bash,Edit,Read". Sur macOS, Linux et WSL, l'ensemble par défaut laisse de côté Glob et Grep, comme décrit sous Comportement de l'outil Glob. Si vous nommez l'un des outils de suivi des tâches ici, Claude Code les active également pour la session. Le drapeau n'affecte pas les outils MCP ; pour les refuser aussi, utilisez --disallowedTools "mcp__*". Une liste qui omet EndConversation ne le supprime pas ; "" le supprime uniquement lorsqu'aucun outil MCP ne reste claude --tools "Bash,Edit,Read"
--verbose Activer la journalisation détaillée, affiche la sortie complète tour par tour. Remplace le paramètre viewMode pour cette session claude --verbose
--version, -v Afficher le numéro de version claude -v
--worktree, -w Démarrer Claude dans un git worktree isolé à <repo>/.claude/worktrees/<name>. Si vous ne donnez pas de nom, Claude Code en génère un. Passez #<number>, une URL de demande de tirage GitHub, ou une URL de demande de fusion GitLab pour récupérer cette PR ou MR de origin et créer une branche du worktree à partir de celle-ci. La création d'une branche à partir d'une demande de fusion GitLab nécessite Claude Code v2.1.233 ou ultérieur claude -w feature-auth

Drapeaux d'invite système

Claude Code fournit cinq drapeaux pour personnaliser l'invite système. Quatre définissent son texte, et avec --system-prompt-snapshot vous contrôlez si une conversation conserve le texte avec lequel elle a commencé. Les cinq fonctionnent à la fois en mode interactif et non interactif.

Drapeau Comportement Exemple
--system-prompt Remplace l'invite système entière par défaut claude --system-prompt "You are a Python expert"
--system-prompt-file Remplace par le contenu du fichier claude --system-prompt-file ./prompts/review.txt
--append-system-prompt Ajoute à l'invite système par défaut claude --append-system-prompt "Always use TypeScript"
--append-system-prompt-file Ajoute le contenu du fichier à l'invite système par défaut claude --append-system-prompt-file ./style-rules.txt
--system-prompt-snapshot Avec off, reconstruit l'invite à chaque requête. Avec on, la valeur par défaut, réutilise une invite enregistrée où l'enregistrement s'applique claude --append-system-prompt "Draft rules" --system-prompt-snapshot off

Vous pouvez combiner ces flags. Pour remplacer le prompt par défaut tout en ajoutant votre propre texte, passez --append-system-prompt ou --append-system-prompt-file avec --system-prompt ou --system-prompt-file. Avec Claude Code v2.1.283 ou ultérieur, vous pouvez également passer un flag avec sa propre forme fichier, comme --append-system-prompt avec --append-system-prompt-file, et Claude Code utilise les deux.

Par exemple, exécutez la commande suivante dans votre shell pour ajouter à la fois un guide de style depuis un fichier et une instruction supplémentaire :

claude -p --append-system-prompt-file ./style.md --append-system-prompt "Always reply in French" "Summarize README.md"

Claude reçoit le prompt système par défaut suivi du contenu de style.md, d'une ligne vide, puis de Always reply in French. Le contenu du fichier vient en premier même si vous passez --append-system-prompt avant --append-system-prompt-file.

Lorsque le texte de remplacement combine des instructions qui sont les mêmes à chaque exécution avec un contexte qui change par exécution, ajoutez une ligne contenant uniquement __SYSTEM_PROMPT_DYNAMIC_BOUNDARY__ entre les instructions et le contexte. Claude Code divise l'invite à la première telle ligne et supprime cette ligne, de sorte que la partie au-dessus reste mise en cache tandis que la partie au-dessous change. Nécessite Claude Code v2.1.275 ou ultérieur. Mettre en cache la partie statique d'une invite personnalisée répertorie les configurations où la division s'applique.

Choisissez en fonction de la question de savoir si l'identité par défaut de Claude Code convient toujours à votre tâche. Utilisez un drapeau d'ajout lorsque Claude doit rester un assistant de codage qui suit également vos règles supplémentaires : instructions par invocation, formatage de sortie, ou contexte de domaine pour un script -p. L'ajout préserve les conseils d'outils par défaut, les instructions de sécurité et les conventions de codage, vous ne fournissez donc que ce qui diffère. Utilisez un drapeau de remplacement lorsque la surface, l'identité ou le modèle de permission diffère de celui de Claude Code, comme un agent non-codage dans un pipeline qu'aucun humain ne regarde. Le remplacement supprime l'intégralité de l'invite système par défaut, y compris les conseils d'outils et les instructions de sécurité, vous êtes donc responsable de tout ce que votre tâche nécessite toujours.

Pour les personas persistants que vous pouvez basculer et partager dans un projet, utilisez les styles de sortie. Pour les conventions de projet que Claude doit toujours suivre, utilisez CLAUDE.md. Le guide du SDK Agent sur les invites système couvre la même décision plus en profondeur.

Drapeaux d'invite système dans les conversations reprises

Par défaut, Claude Code construit l'invite système une fois, à la première requête d'une conversation, avec le texte de tous les drapeaux d'invite système appliqués, et l'enregistre dans la session. Jusqu'à ce que la conversation soit compactée, chaque requête ultérieure utilise cette invite enregistrée, y compris après votre retour à la conversation avec --resume ou --continue. Si vous transmettez un texte de drapeau d'invite système différent, ou aucun, lors de ce lancement ultérieur, il prend effet une fois que la conversation est compactée ou lorsque vous démarrez une nouvelle conversation.

En dehors des sessions web, si vous démarrez Claude Code en mode bare, en passant --bare ou en définissant CLAUDE_CODE_SIMPLE=1, l'enregistrement reste désactivé à moins que vous ne passiez --system-prompt-snapshot on. Avant v2.1.268, les sessions qui ne récupèrent pas les drapeaux de fonctionnalité, y compris les sessions sur Amazon Bedrock, Google Cloud's Agent Platform et Microsoft Foundry, reconstruisaient l'invite à chaque requête et --system-prompt-snapshot n'avait aucun effet.

Pour reconstruire l'invite à chaque requête à la place, par exemple pendant que vous itérez sur sa formulation entre les exécutions --continue, passez --system-prompt-snapshot off. Avant v2.1.265, passer l'un des drapeaux d'invite système désactivait également l'enregistrement à moins que vous ne passiez --system-prompt-snapshot on.

Voir aussi