# 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.

<table width="100%">
<tr>
<td><a href="../">← Retour à Claude Code Best Practice</a></td>
<td align="right"><img src="../../!/claude-jumping.svg" alt="Claude" width="60" /></td>
</tr>
</table>

---

## 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 <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-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)
