Commandes CLI
| Commande | Description | Exemple |
|---|
claude | Démarrer REPL interactif | claude |
claude "query" | Démarrer REPL avec 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 | claude -c |
claude -c -p "query" | Continuer via SDK | claude -c -p "Check for type errors" |
claude -r "<session-id>" "query" | Reprendre une session par ID | claude -r "abc123" "Finish this PR" |
claude update | Mettre à jour vers la dernière version | claude update |
claude mcp | Configurer les serveurs Model Context Protocol (MCP) | Voir la documentation Claude Code MCP. |
Drapeaux CLI
Personnalisez le comportement de Claude Code avec ces drapeaux de ligne de commande :
| Drapeau | Description | Exemple |
|---|
--add-dir | Ajouter 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 |
--agents | Définir des sous-agents personnalisés dynamiquement via JSON (voir ci-dessous pour le format) | claude --agents '{"reviewer":{"description":"Reviews code","prompt":"You are a code reviewer"}}' |
--allowedTools | Une liste d’outils qui doivent être autorisés sans demander la permission à l’utilisateur, en plus des fichiers settings.json | "Bash(git log:*)" "Bash(git diff:*)" "Read" |
--disallowedTools | Une liste d’outils qui doivent être interdits sans demander la permission à l’utilisateur, en plus des fichiers settings.json | "Bash(git log:*)" "Bash(git diff:*)" "Edit" |
--print, -p | Imprimer la réponse sans mode interactif (voir la documentation SDK pour les détails d’utilisation programmatique) | claude -p "query" |
--system-prompt | Remplacer l’intégralité de l’invite système par du texte personnalisé (fonctionne en modes interactif et impression ; ajouté en v2.0.14) | claude --system-prompt "You are a Python expert" |
--system-prompt-file | Charger l’invite système à partir d’un fichier, remplaçant l’invite par défaut (mode impression uniquement ; ajouté en v1.0.54) | claude -p --system-prompt-file ./custom-prompt.txt "query" |
--append-system-prompt | Ajouter du texte personnalisé à la fin de l’invite système par défaut (fonctionne en modes interactif et impression ; ajouté en v1.0.55) | claude --append-system-prompt "Always use TypeScript" |
--output-format | Spécifier le format de sortie pour le mode impression (options : text, json, stream-json) | claude -p "query" --output-format json |
--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 |
--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" |
--verbose | Activer la journalisation détaillée, affiche la sortie complète tour par tour (utile pour le débogage en modes impression et interactif) | claude --verbose |
--max-turns | Limiter le nombre de tours d’agent en mode non interactif | claude -p --max-turns 3 "query" |
--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 | claude --model claude-sonnet-4-5-20250929 |
--permission-mode | Commencer dans un mode de permission spécifié | 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" |
--resume | Reprendre une session spécifique par ID, ou en choisissant en mode interactif | claude --resume abc123 "query" |
--continue | Charger la conversation la plus récente dans le répertoire actuel | claude --continue |
--dangerously-skip-permissions | Ignorer les invites de permission (à utiliser avec prudence) | claude --dangerously-skip-permissions |
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.
--agents accepte un objet JSON qui définit un ou plusieurs sous-agents personnalisés. Chaque sous-agent nécessite un nom unique (comme clé) et un objet de définition avec les champs suivants :
| Champ | Requis | Description |
|---|
description | Oui | Description en langage naturel du moment où le sous-agent doit être invoqué |
prompt | Oui | L’invite système qui guide le comportement du sous-agent |
tools | Non | Tableau d’outils spécifiques que le sous-agent peut utiliser (par exemple, ["Read", "Edit", "Bash"]). S’il est omis, hérite de tous les outils |
model | Non | Alias de modèle à utiliser : sonnet, opus, ou haiku. S’il est omis, utilise le modèle de sous-agent par défaut |
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."
}
}'
Drapeaux d’invite système
Claude Code fournit trois drapeaux pour personnaliser l’invite système, chacun servant un objectif différent :
| Drapeau | Comportement | Modes | Cas d’utilisation |
|---|
--system-prompt | Remplace l’intégralité de l’invite par défaut | Interactif + Impression | Contrôle complet sur le comportement et les instructions de Claude |
--system-prompt-file | Remplace par le contenu du fichier | Impression uniquement | Charger les invites à partir de fichiers pour la reproductibilité et le contrôle de version |
--append-system-prompt | Ajoute à l’invite par défaut | Interactif + Impression | Ajouter des instructions spécifiques tout en conservant le comportement par défaut de Claude Code |
-
--system-prompt : Utilisez quand 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 quand vous voulez 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 -p --system-prompt-file ./prompts/code-review.txt "Review this PR"
-
--append-system-prompt : Utilisez quand vous voulez 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"
--system-prompt et --system-prompt-file s’excluent mutuellement. Vous ne pouvez pas utiliser les deux drapeaux simultanément.
Pour la plupart des cas d’utilisation, --append-system-prompt est recommandé car il préserve les capacités intégrées de Claude Code tout en ajoutant vos exigences personnalisées. Utilisez --system-prompt ou --system-prompt-file uniquement quand vous avez besoin d’un contrôle complet sur l’invite système.
-p) incluant les formats de sortie,
le streaming, la journalisation détaillée et l’utilisation programmatique, consultez la
documentation SDK.
Voir aussi
