Manuel de référence CLI de Claude Code


I. Commandes CLI

Commande Description Exemple
claude Démarrer REPL interactif claude
claude "query" Démarrer REPL avec prompt initial claude "explain this project"
claude -p "query" Requête SDK puis quitter claude -p "explain this function"
cat file | claude -p "query" Gérer l'entrée redirigée 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 la conversation via SDK claude -c -p "Check for type errors"
claude -r "<session>" "query" Reprendre la session par ID/nom claude -r "auth-refactor" "Finish this PR"
claude update Mettre à jour vers la dernière version claude update
claude mcp Configurer le serveur MCP Voir les détailsDocumentation MCP de Claude Code

II. Options CLI

Les options suivantes personnalisent le comportement d'exécution de Claude Code :

Option Description Exemple
--add-dir Ajouter un répertoire de travail (valide automatiquement le chemin) claude --add-dir ../apps ../lib
--agent Spécifier l'agent de session (remplace le paramètreagentpar défaut) claude --agent my-custom-agent
--agents Définir des sous-agents personnalisés en JSON claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}'
--allowedTools Outils utilisables sans demandes d'autorisation (pour restreindre les outils avec--tools) "Bash(git log:*)" "Bash(git diff:*)" "Read"
--append-system-prompt Ajouter du contenu au prompt système par défaut (efficace dans les modes interactif et impression) claude --append-system-prompt "Always use TypeScript"
--betas Ajouter des en-têtes Beta aux requêtes API (utilisateurs de clé API uniquement) claude --betas interleaved-thinking
--chrome Activer l'intégration du navigateur Chrome (automatisation/tests web) claude --chrome
--continue, -c Charger la conversation la plus récente dans le répertoire courant claude --continue
--dangerously-skip-permissions Ignorer les demandes d'autorisation (à utiliser avec prudence) claude --dangerously-skip-permissions
--debug Activer le mode débogage avec filtrage par catégorie (p. ex."api,hooks") claude --debug "api,mcp"
--disallowedTools Désactiver les outils spécifiés (retirés du contexte) "Bash(git log:*)" "Bash(git diff:*)" "Edit"
--fallback-model Basculer automatiquement lorsque le modèle par défaut est surchargé (mode d'impression uniquement) claude -p --fallback-model sonnet "query"
--fork-session Générer un nouvel ID lors de la reprise de session (associé à--resume/--continue) claude --resume abc123 --fork-session
--ide Se connecter automatiquement à l'IDE disponible claude --ide
--include-partial-messages La sortie inclut des événements de flux partiels (nécessite une association avec--printet--output-format=stream-json) claude -p --output-format stream-json --include-partial-messages "query"
--input-format Format d'entrée du mode d'impression (facultatiftext/stream-json) claude -p --output-format json --input-format stream-json
--json-schema Afficher les résultats de validation conformes au JSON Schema (mode d'impression uniquement) claude -p --json-schema '{"type":"object","properties":{...}}' "query"
--max-turns Limiter les tours de l'agent (mode d'impression uniquement, quitte avec une erreur en cas de dépassement) claude -p --max-turns 3 "query"
--mcp-config Charger la configuration MCP depuis un fichier/une chaîne JSON claude --mcp-config ./mcp.json
--model Spécifier le modèle de session (prend en charge les aliassonnet/opusou le nom complet) claude --model claude-sonnet-4-5-20250929
--no-chrome Désactiver l'intégration Chrome claude --no-chrome
--output-format Format de sortie du mode d'impression (facultatiftext/json/stream-json) claude -p "query" --output-format json
--permission-mode Démarrer avec le mode d'autorisation spécifié claude --permission-mode plan
--permission-prompt-tool Spécifier l'outil de gestion des invites d'autorisation en mode non interactif claude -p --permission-prompt-tool mcp_auth_tool "query"
--plugin-dir Charger les plugins depuis le répertoire spécifié (réutilisable) claude --plugin-dir ./my-plugins
--print, -p Afficher la réponse puis quitter (mode non interactif) claude -p "query"
--resume, -r Reprendre la session par ID/nom, ou ouvrir le sélecteur interactif claude --resume auth-refactor
--session-id Spécifier l'ID de session (doit être un UUID valide) claude --session-id "550e8400-e29b-41d4-a716-446655440000"
--setting-sources Spécifier la source des paramètres à charger (séparés par des virgulesuser/project/local) claude --setting-sources user,project
--settings Charger un fichier/chaîne de configuration JSON personnalisé claude --settings ./settings.json
--strict-mcp-config Utiliser uniquement--mcp-configla configuration, ignorer les autres paramètres MCP claude --strict-mcp-config --mcp-config ./mcp.json
--system-prompt Remplacer le prompt système par défaut (effectif dans les modes interactif et d'impression) claude --system-prompt "You are a Python expert"
--system-prompt-file Charger le prompt système depuis un fichier (remplace la valeur par défaut, mode d'impression uniquement) claude -p --system-prompt-file ./custom-prompt.txt "query"
--tools Restreindre les outils intégrés disponibles (""désactiver tout,"default"activer tout) claude --tools "Bash,Edit,Read"
--verbose Activer la journalisation détaillée pour afficher la sortie complète tour par tour claude --verbose
--version, -v Afficher le numéro de version claude -v

Remarque:--output-format jsonLes options sont idéales pour les scripts et l'automatisation ; vous pouvez analyser par programmation la sortie de réponse de Claude.


III. Notes étendues

Format du flag Agent

--agentsLe flag accepte un objet JSON pour définir un ou plusieurs sous-agents personnalisés. Chaque sous-agent nécessite un nom unique comme clé, et la valeur est un objet contenant les champs suivants :

Champ Requis Description
description Oui Décrire les scénarios d'application du sous-agent
prompt Oui Prompt système définissant le comportement du sous-agent
tools non Liste d'outils spécifiques au sous-agent (comme["Read", "Edit"], si elle est omise, hérite de tous les outils)
model non Modèle utilisé par le sous-agent (prend en chargesonnet/opus/haiku, s'il est omis, le modèle par défaut est utilisé)

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."
  }
}'

Flag de prompt système

Claude Code propose 3 façons de personnaliser le prompt système pour répondre à différents besoins d'utilisation :

Option Comportement Mode applicable Cas d'utilisation typique
--system-prompt Remplacer le prompt système par défaut Interactif + print Personnaliser entièrement les instructions de comportement de Claude
--system-prompt-file Charger le prompt depuis un fichier et remplacer Print uniquement Modèles de prompt partagés en équipe, contrôle de version
--append-system-prompt Ajouter du contenu au prompt par défaut Interactif + print Conserver les fonctionnalités par défaut, ajouter des instructions personnalisées

Scénarios d'utilisation et exemples

  1. --system-prompt: Prendre complètement le contrôle du prompt système et effacer les instructions par défaut
    claude --system-prompt "You are a Python expert who only writes type-annotated code"
  2. --system-prompt-file: Lire le prompt depuis un fichier, adapté aux scénarios standardisés
    claude -p --system-prompt-file ./prompts/code-review.txt "Review this PR"
  3. --append-system-prompt: Conserver les fonctionnalités par défaut, ajouter des exigences personnalisées (recommandé pour la plupart des scénarios)
    claude --append-system-prompt "Always use TypeScript and include JSDoc comments"

Remarque:--system-promptet--system-prompt-fileMutuelles exclusives, ne peuvent pas être utilisées en même temps.
Astuce: privilégiez l'utilisation de--append-system-prompt, car il préserve les capacités intégrées de Claude Code tout en répondant aux besoins de personnalisation ; n'utilisez les deux autres options que lorsqu'une personnalisation complète est requise.

Mode d'impression (-p) utilisation détaillée (format de sortie, streaming, intégration programmatique, etc.), reportez-vous àla documentation du SDK。

Autres extensions