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
--system-prompt: Prendre complètement le contrôle du prompt système et effacer les instructions par défautclaude --system-prompt "You are a Python expert who only writes type-annotated code"
--system-prompt-file: Lire le prompt depuis un fichier, adapté aux scénarios standardisésclaude -p --system-prompt-file ./prompts/code-review.txt "Review this PR"
--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。