# Bonnes pratiques — Drapeaux de démarrage du CLI ![Last Updated](https://img.shields.io/badge/Last_Updated-Mar%2002%2C%202026-white?style=flat&labelColor=555) 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.
← Retour à Claude Code Best Practice Claude
--- ## Table des matières 1. [Gestion des sessions](#gestion-des-sessions) 2. [Modèle & configuration](#modèle--configuration) 3. [Permissions & sécurité](#permissions--sécurité) 4. [Sortie & format](#sortie--format) 5. [System prompt](#system-prompt) 6. [Agent & sous-agent](#agent--sous-agent) 7. [MCP & plugins](#mcp--plugins) 8. [Répertoire & espace de travail](#répertoire--espace-de-travail) 9. [Budget & limites](#budget--limites) 10. [Intégration](#intégration) 11. [Initialisation & maintenance](#initialisation--maintenance) 12. [Débogage & diagnostics](#débogage--diagnostics) 13. [Surcharge des paramètres](#surcharge-des-paramètres) 14. [Version & aide](#version--aide) 15. [Sous-commandes](#sous-commandes) 16. [Variables d'environnement](#variables-denvironnement) --- ## 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 ` | | 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 ` | | 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 ` | | Définir le modèle avec un alias (`sonnet`, `opus`, `haiku`) ou un ID de modèle complet | | `--fallback-model ` | | Modèle de repli automatique quand le défaut est surchargé (mode print uniquement) | | `--betas ` | | 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 ` | | Démarrer dans le mode de permissions spécifié : `default`, `plan`, `acceptEdits`, `bypassPermissions` | | `--allowedTools ` | | Outils qui s'exécutent sans demande (syntaxe de règle de permission) | | `--disallowedTools ` | | Outils entièrement retirés du contexte du modèle | | `--tools ` | | Restreindre les outils intégrés que Claude peut utiliser (utilise `""` pour tout désactiver) | | `--permission-prompt-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 de sortie : `text`, `json`, `stream-json` | | `--input-format ` | | Format d'entrée : `text`, `stream-json` | | `--json-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 ` | | Remplacer entièrement le system prompt par un texte personnalisé | | `--system-prompt-file ` | | Charger le system prompt depuis un fichier, remplaçant le défaut (mode print uniquement) | | `--append-system-prompt ` | | Ajouter du texte personnalisé au system prompt par défaut | | `--append-system-prompt-file ` | | Ajouter le contenu d'un fichier au prompt par défaut (mode print uniquement) | --- ## Agent & sous-agent | Drapeau | Court | Description | |------|-------|-------------| | `--agent ` | | Spécifier un agent pour la session courante | | `--agents ` | | Définir des sous-agents personnalisés dynamiquement via JSON | | `--teammate-mode ` | | Définir l'affichage de l'équipe d'agents : `auto`, `in-process`, `tmux` | --- ## MCP & plugins | Drapeau | Court | Description | |------|-------|-------------| | `--mcp-config ` | | 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 ` | | Charger les plugins depuis un répertoire pour cette session uniquement (répétable) | --- ## Répertoire & espace de travail | Drapeau | Court | Description | |------|-------|-------------| | `--add-dir ` | | 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 ` | | Montant maximum en dollars pour les appels API avant arrêt (mode print uniquement) | | `--max-turns ` | | 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 ` | | Activer le mode debug avec filtrage de catégorie optionnel (par ex. `"api,hooks"`) | --- ## Surcharge des paramètres | Drapeau | Court | Description | |------|-------|-------------| | `--settings ` | | Chemin vers un fichier JSON de paramètres ou chaîne JSON à charger | | `--setting-sources ` | | 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 ` : | 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-settings.md#variables-denvironnement-via-env) | | `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-settings.md#variables-denvironnement-via-env) | | `CLAUDE_CODE_EFFORT_LEVEL` | Contrôler la profondeur de réflexion — voir [Référence des paramètres](./claude-settings.md#variables-denvironnement-via-env) | | `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-settings.md#variables-denvironnement-via-env) | | `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](./claude-settings.md#variables-denvironnement-via-env) | 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](./claude-settings.md#variables-denvironnement-via-env). --- ## Sources - [Référence CLI Claude Code](https://code.claude.com/docs/en/cli-reference) - [Mode Headless Claude Code](https://code.claude.com/docs/en/headless) - [Configuration Claude Code](https://code.claude.com/docs/en/setup) - [CHANGELOG Claude Code](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) - [Workflows courants Claude Code](https://code.claude.com/docs/en/common-workflows)