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 une invite initiale | 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 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 |
claude auth status |
claude agents |
Ouvrir la vue agent pour surveiller et dispatcher les sessions d'arrière-plan parallèles. Lorsque la sortie est canalisée, liste les sous-agents configurés à la place | claude agents |
claude attach <id> |
Attacher à une session d'arrière-plan dans ce terminal | 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 |
claude auto-mode defaults > rules.json |
claude logs <id> |
Imprimer la sortie récente d'une session d'arrière-plan | claude logs 7c5dcf5d |
claude mcp |
Configurer les serveurs Model Context Protocol (MCP) | Voir la documentation Claude Code MCP. |
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 project 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 invites, et l'entrée du projet dans ~/.claude.json. Omettez [path] pour choisir dans une liste interactive. Drapeaux : --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 project 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 Drapeaux du mode serveur | claude remote-control --name "My Project" |
claude respawn <id> |
Redémarrer une session d'arrière-plan arrêtée avec sa conversation intacte. Utilisez --all pour redémarrer chaque session arrêtée |
claude respawn 7c5dcf5d |
claude rm <id> |
Supprimer une session d'arrière-plan de la liste | claude rm 7c5dcf5d |
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 la charge utile brute et --timeout <minutes> pour remplacer la valeur par défaut de 30 minutes |
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?.
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 ; la plupart de la configuration .claude/ est non découverte à partir de ces répertoires. Valide que chaque chemin existe en tant que répertoire. Pour conserver ces répertoires entre les sessions, définissez permissions.additionalDirectories dans les paramètres |
claude --add-dir ../apps ../lib |
--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. Utilise les mêmes noms de champs que le frontmatter des subagents, plus un champ prompt pour les instructions de l'agent |
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 |
Outils 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-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 |
--bare |
Mode minimal : ignorer la découverte automatique des hooks, skills, plugins, serveurs MCP, mémoire automatique et CLAUDE.md afin que les appels scriptés démarrent plus rapidement. 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 |
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 --agent pour exécuter un subagent spécifique |
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 Claude.ai |
claude --channels plugin:my-notifier@my-marketplace |
--chrome |
Activer l'intégration du navigateur Chrome pour l'automatisation web et les tests | claude --chrome |
--continue, -c |
Charger la conversation la plus récente dans le répertoire courant. Inclut les sessions qui ont ajouté ce répertoire avec /add-dir |
claude --continue |
--dangerously-load-development-channels |
Activer les canaux qui ne sont pas sur la liste d'approbation, pour le développement local. Accepte les entrées plugin:<name>@<marketplace> et server:<name>. Demande une confirmation |
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 |
claude --dangerously-skip-permissions |
--debug |
Activer le mode débogage avec filtrage de catégorie optionnel (par exemple, "api,hooks" ou "!statsig,!file") |
claude --debug "api,mcp" |
--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 |
--disable-slash-commands |
Désactiver tous les skills et commandes pour cette session | claude --disable-slash-commands |
--disallowedTools |
Outils qui sont supprimés du contexte du modèle et ne peuvent pas être utilisés | "Bash(git log *)" "Bash(git diff *)" "Edit" |
--effort |
Définir le niveau d'effort pour la session actuelle. Options : low, medium, high, xhigh, max ; les niveaux disponibles dépendent du modèle. Remplace le paramètre effortLevel pour cette session et ne persiste pas |
claude --effort high |
--enable-auto-mode |
{/* max-version: 2.1.110 */}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 |
--exclude-dynamic-system-prompt-sections |
Déplacer les sections par machine de l'invite système (répertoire de travail, informations d'environnement, chemins de mémoire, statut git) 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" |
--fallback-model |
Activer 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-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 |
--from-pr |
Reprendre les 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 tous les événements du cycle de vie des hooks dans le flux de sortie. Nécessite --output-format stream-json |
claude -p --output-format stream-json --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 --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 -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 |
Montant 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-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 | 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) | claude --mcp-config ./mcp.json |
--model |
Dé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èle. Remplace le paramètre model et ANTHROPIC_MODEL |
claude --model claude-sonnet-4-6 |
--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 d'invite |
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, ou bypassPermissions. Remplace defaultMode des fichiers de paramètres |
claude --permission-mode plan |
--permission-prompt-tool |
Spécifier un outil MCP pour gérer les invites de permission en mode non interactif | claude -p --permission-prompt-tool mcp_auth_tool "query" |
--plugin-dir |
Charger un plugin à partir d'un répertoire ou d'une archive .zip pour cette session uniquement. Chaque drapeau prend un chemin. Répétez le drapeau pour plusieurs plugins : --plugin-dir A --plugin-dir B.zip |
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) | claude -p "query" |
--remote |
Créer une nouvelle session web sur claude.ai avec la description de tâche fournie | 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 --replay-user-messages |
--resume, -r |
Reprendre une session spécifique par ID ou nom, ou afficher un sélecteur interactif pour choisir une session. Inclut les sessions qui ont ajouté ce répertoire avec /add-dir |
claude --resume auth-refactor |
--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) |
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. 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 |
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 |
--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 : auto (par défaut), in-process, ou tmux. Remplace le paramètre teammateMode pour cette session. Voir Choisir un mode d'affichage |
claude --teammate-mode in-process |
--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 tous, ou des noms d'outils comme "Bash,Edit,Read" |
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 aucun nom n'est donné, un est généré automatiquement. Passez #<number> ou une URL de demande de tirage GitHub pour récupérer cette PR de origin et créer une branche du worktree à partir de celle-ci |
claude -w feature-auth |
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.
| Drapeau | Comportement | Exemple |
|---|---|---|
--system-prompt |
Remplace l'invite par défaut entière | 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 par défaut | claude --append-system-prompt "Always use TypeScript" |
--append-system-prompt-file |
Ajoute le contenu du fichier à l'invite par défaut | claude --append-system-prompt-file ./style-rules.txt |
--system-prompt et --system-prompt-file s'excluent mutuellement. Les drapeaux d'ajout peuvent être combinés avec l'un ou l'autre drapeau de remplacement.
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 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.
Ces drapeaux s'appliquent uniquement à l'invocation actuelle. 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.
Voir aussi
- Extension Chrome - Automatisation du navigateur et tests web
- Mode interactif - Raccourcis, modes d'entrée et fonctionnalités interactives
- Guide de démarrage rapide - Prise en main de Claude Code
- Flux de travail courants - Flux de travail et modèles avancés
- Paramètres - Options de configuration
- Documentation du SDK Agent - Utilisation programmatique et intégrations