232 lines
11 KiB
Markdown
232 lines
11 KiB
Markdown
# 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 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)
|