Bonnes pratiques — Drapeaux de démarrage du CLI
Référence des drapeaux de démarrage de Claude Code, des sous-commandes de premier niveau et des variables d'environnement de démarrage lors du lancement de Claude Code depuis le terminal.
Table des matières
- Gestion des sessions
- Modèle & configuration
- Permissions & sécurité
- Sortie & format
- System prompt
- Agent & sous-agent
- MCP & plugins
- Répertoire & espace de travail
- Budget & limites
- Intégration
- Initialisation & maintenance
- Débogage & diagnostics
- Surcharge des paramètres
- Version & aide
- Sous-commandes
- Variables d'environnement
Gestion des sessions
| Drapeau |
Court |
Description |
--continue |
-c |
Continuer la conversation la plus récente dans le répertoire courant |
--resume |
-r |
Reprendre une session spécifique par ID ou nom, ou afficher le sélecteur interactif |
--from-pr <NUMBER|URL> |
|
Reprendre les sessions liées à une PR GitHub spécifique |
--fork-session |
|
Créer un nouvel ID de session lors de la reprise (à utiliser avec --resume ou --continue) |
--session-id <UUID> |
|
Utiliser un ID de session spécifique (doit être un UUID valide) |
--no-session-persistence |
|
Désactiver la persistance de session (mode print uniquement) |
--remote |
|
Créer une nouvelle session web sur claude.ai |
--teleport |
|
Reprendre une session web dans ton terminal local |
Modèle & configuration
| Drapeau |
Court |
Description |
--model <NAME> |
|
Définir le modèle avec un alias (sonnet, opus, haiku) ou un ID de modèle complet |
--fallback-model <NAME> |
|
Modèle de repli automatique quand le défaut est surchargé (mode print uniquement) |
--betas <LIST> |
|
En-têtes beta à inclure dans les requêtes API (utilisateurs avec clé API uniquement) |
Permissions & sécurité
| Drapeau |
Court |
Description |
--dangerously-skip-permissions |
|
Ignorer TOUTES les demandes de permission. À utiliser avec une extrême prudence |
--allow-dangerously-skip-permissions |
|
Activer le contournement de permissions comme option sans l'activer |
--permission-mode <MODE> |
|
Démarrer dans le mode de permissions spécifié : default, plan, acceptEdits, bypassPermissions |
--allowedTools <TOOLS> |
|
Outils qui s'exécutent sans demande (syntaxe de règle de permission) |
--disallowedTools <TOOLS> |
|
Outils entièrement retirés du contexte du modèle |
--tools <TOOLS> |
|
Restreindre les outils intégrés que Claude peut utiliser (utilise "" pour tout désactiver) |
--permission-prompt-tool <TOOL> |
|
Spécifier l'outil MCP qui gère les demandes de permission en mode non interactif |
Sortie & format
| Drapeau |
Court |
Description |
--print |
-p |
Afficher la réponse sans mode interactif (mode headless/SDK) |
--output-format <FORMAT> |
|
Format de sortie : text, json, stream-json |
--input-format <FORMAT> |
|
Format d'entrée : text, stream-json |
--json-schema <SCHEMA> |
|
Obtenir un JSON validé correspondant au schéma (mode print uniquement) |
--include-partial-messages |
|
Inclure les événements de streaming partiels (requiert --print et --output-format=stream-json) |
--verbose |
|
Activer la journalisation verbeuse avec sortie complète tour par tour |
System prompt
| Drapeau |
Court |
Description |
--system-prompt <TEXT> |
|
Remplacer entièrement le system prompt par un texte personnalisé |
--system-prompt-file <PATH> |
|
Charger le system prompt depuis un fichier, remplaçant le défaut (mode print uniquement) |
--append-system-prompt <TEXT> |
|
Ajouter du texte personnalisé au system prompt par défaut |
--append-system-prompt-file <PATH> |
|
Ajouter le contenu d'un fichier au prompt par défaut (mode print uniquement) |
Agent & sous-agent
| Drapeau |
Court |
Description |
--agent <NAME> |
|
Spécifier un agent pour la session courante |
--agents <JSON> |
|
Définir des sous-agents personnalisés dynamiquement via JSON |
--teammate-mode <MODE> |
|
Définir l'affichage de l'équipe d'agents : auto, in-process, tmux |
MCP & plugins
| Drapeau |
Court |
Description |
--mcp-config <PATH|JSON> |
|
Charger les serveurs MCP depuis un fichier JSON ou une chaîne |
--strict-mcp-config |
|
Utiliser uniquement les serveurs MCP de --mcp-config, ignorer tous les autres |
--plugin-dir <PATH> |
|
Charger les plugins depuis un répertoire pour cette session uniquement (répétable) |
Répertoire & espace de travail
| Drapeau |
Court |
Description |
--add-dir <PATH> |
|
Ajouter des répertoires de travail supplémentaires accessibles à Claude |
--worktree |
-w |
Démarrer Claude dans un worktree git isolé (branché depuis HEAD) |
Budget & limites
| Drapeau |
Court |
Description |
--max-budget-usd <AMOUNT> |
|
Montant maximum en dollars pour les appels API avant arrêt (mode print uniquement) |
--max-turns <NUMBER> |
|
Limiter le nombre de tours agentiques (mode print uniquement) |
Intégration
| Drapeau |
Court |
Description |
--chrome |
|
Activer l'intégration du navigateur Chrome pour l'automatisation web |
--no-chrome |
|
Désactiver l'intégration du navigateur Chrome pour cette session |
--ide |
|
Se connecter automatiquement à l'IDE au démarrage si exactement un IDE valide est disponible |
Initialisation & maintenance
| Drapeau |
Court |
Description |
--init |
|
Exécuter les hooks d'initialisation et démarrer le mode interactif |
--init-only |
|
Exécuter les hooks d'initialisation et quitter (pas de session interactive) |
--maintenance |
|
Exécuter les hooks de maintenance et quitter |
Débogage & diagnostics
| Drapeau |
Court |
Description |
--debug <CATEGORIES> |
|
Activer le mode debug avec filtrage de catégorie optionnel (par ex. "api,hooks") |
Surcharge des paramètres
| Drapeau |
Court |
Description |
--settings <PATH|JSON> |
|
Chemin vers un fichier JSON de paramètres ou chaîne JSON à charger |
--setting-sources <LIST> |
|
Liste de sources à charger séparées par des virgules : user, project, local |
--disable-slash-commands |
|
Désactiver tous les skills et commandes slash pour cette session |
Version & aide
| Drapeau |
Court |
Description |
--version |
-v |
Afficher le numéro de version |
--help |
-h |
Afficher les informations d'aide |
Sous-commandes
Ce sont des commandes de premier niveau exécutées comme claude <subcommand> :
| Sous-commande |
Description |
claude |
Démarrer le REPL interactif |
claude "query" |
Démarrer le REPL avec un prompt initial |
claude agents |
Lister les agents configurés |
claude auth |
Gérer l'authentification Claude Code |
claude doctor |
Lancer les diagnostics en ligne de commande |
claude install |
Installer ou changer de build natif Claude Code |
claude mcp |
Configurer les serveurs MCP (add, remove, list, get, enable) |
claude plugin |
Gérer les plugins Claude Code |
claude remote-control |
Gérer les sessions de contrôle à distance |
claude setup-token |
Créer un token longue durée pour l'usage par abonnement |
claude update / claude upgrade |
Mettre à jour vers la dernière version |
Variables d'environnement
Ces variables d'environnement de démarrage uniquement sont définies dans ton shell avant de lancer Claude Code (elles ne peuvent pas être configurées via settings.json) :
| Variable |
Description |
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 |
Activer les équipes d'agents expérimentales |
CLAUDE_CODE_TMPDIR |
Surcharger le répertoire temp pour les fichiers internes. Configurable aussi via la clé env — voir Référence des paramètres |
CLAUDE_CODE_ADDITIONAL_DIRECTORIES_CLAUDE_MD=1 |
Activer le chargement des CLAUDE.md de répertoires additionnels |
DISABLE_AUTOUPDATER=1 |
Désactiver les mises à jour automatiques. Configurable aussi via la clé env — voir Référence des paramètres |
CLAUDE_CODE_EFFORT_LEVEL |
Contrôler la profondeur de réflexion — voir Référence des paramètres |
USE_BUILTIN_RIPGREP=0 |
Utiliser le ripgrep système au lieu de celui intégré (Alpine Linux) |
CLAUDE_CODE_SIMPLE |
Activer le mode simple (outils Bash + Edit uniquement). Configurable aussi via la clé env — voir Référence des paramètres |
CLAUDE_BASH_NO_LOGIN=1 |
Sauter le login shell pour BashTool |
CCR_FORCE_BUNDLE=1 |
Forcer le bundling/upload du dépôt local en utilisant claude --remote. Configurable aussi via la clé env — voir Référence des paramètres |
Pour les variables d'environnement configurables via la clé "env" dans settings.json (dont MAX_THINKING_TOKENS, CLAUDE_CODE_SHELL, CLAUDE_CODE_ENABLE_TASKS, CLAUDE_CODE_DISABLE_BACKGROUND_TASKS, CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS, et plus), voir la Référence des paramètres Claude.
Sources
