Démarrer et vérifier
| Besoin | Repère |
|---|---|
| Installer | voies officielles : script natif, Homebrew, WinGet, apt/dnf/apk, extension d'IDE, application Desktop. Ne pas lancer un script sans l'avoir lu |
| Vérifier | claude --version ; claude doctor (diagnostic en lecture seule) |
| Lancer | claude dans un dossier de projet ; première connexion demandée |
| Mettre à jour | claude update (natif) ; brew upgrade … / winget upgrade … sinon |
| Démarrer sans personnalisation | claude --safe-mode |
Commandes de session (dans claude)
| Commande | Effet | Prudence |
|---|---|---|
/help | aide et liste des commandes | lecture |
/permissions | voir et modifier les règles | modifie les réglages |
/context | occupation du contexte | lecture |
/clear | vide le contexte (tâche sans lien) | l'historique de conversation est écarté |
/compact [consigne] | résume la conversation | perte de détails possible |
/rewind (ou Esc ×2) | restaure fichiers et/ou conversation | ne suit pas les changements faits par shell |
/mcp | état des serveurs MCP | lecture ; connexion/authentification possibles |
/init | génère un CLAUDE.md de départ | crée un fichier dans le dépôt |
/doctor | bilan de configuration, peut proposer des correctifs | relire avant d'accepter |
Touches : Maj+Tab change de mode ; Esc interrompt.
Options CLI utiles
| Commande | Effet | Prudence |
|---|---|---|
claude -p "…" | une requête non interactive puis sortie | l'outil peut agir selon les outils autorisés |
claude -c / claude -r | reprendre la dernière session / choisir | transcriptions locales en clair |
--permission-mode <mode> | mode de départ | bypassPermissions : VM/conteneur seulement |
--allowedTools / --disallowedTools | pré-approuver / refuser | un deny Bash n'est pas une frontière |
--max-turns, --max-budget-usd | bornes d'une exécution -p | l'estimation peut différer de la facture |
--add-dir <dossier> | ajoute un dossier de travail | accorde l'accès fichiers |
claude mcp list / add / remove | gère les serveurs MCP | serveurs de confiance uniquement |
claude purge <chemin> --dry-run | aperçu de l'état local effaçable | sans --dry-run : suppression |
Contexte : terminal, utilisateur normal, version récente (à noter). Contrôle : relire git status et git diff après toute exécution pouvant modifier des fichiers ; travailler sur une branche dédiée.
Modes de permission
| Mode | Sans demander | À retenir |
|---|---|---|
default (Manuel) | lectures | le plus prudent |
acceptEdits | + éditions et commandes de fichiers courantes | relire les diffs |
plan | lectures | explorer avant de modifier |
auto | presque tout, classificateur en arrière-plan | mode de départ à partir de v2.1.283 (à confirmer pour Stéphane) |
dontAsk | seulement le pré-approuvé | CI, scripts |
bypassPermissions | tout | environnement jetable uniquement |
Règles : ordre deny, puis ask, puis allow, première correspondance. Un deny ne se contourne pas par un allow. Nom d'outil seul en deny : l'outil disparaît du contexte.
{ "permissions": { "allow": ["Bash(npm run test *)"], "deny": ["Read(./.env)"] } }Fichier : .claude/settings.json (projet) ou ~/.claude/settings.json (utilisateur). Effet : règles appliquées à la prochaine action. Contrôle : /permissions. Retour arrière : retirer la ligne (copie préalable du fichier).
Quel mécanisme ?
| Besoin | Utiliser |
|---|---|
| Règle ou convention toujours vraie | CLAUDE.md (< 200 lignes) |
| Procédure à la demande | skill (.claude/skills/<nom>/SKILL.md) |
| Recherche volumineuse, contexte isolé | sous-agent (.claude/agents/<nom>.md) |
| Doit se produire à chaque fois | hook (PreToolUse peut bloquer, sortie 2) |
| Service ou données externes | serveur MCP |
| Réutiliser entre dépôts | plugin |
Une instruction (CLAUDE.md, skill) est une demande ; un hook ou le sandbox est une application.
Boucle de travail recommandée
- Explorer (mode
plan) puis planifier si le changement touche plusieurs fichiers. - Donner un critère vérifiable (tests, build, linter).
- Laisser agir, relire le diff, exécuter la vérification.
/clearentre tâches ; repartir à neuf après deux corrections ratées.- Valider par git ; les points de contrôle ne remplacent pas git.
Confidentialité (à ne jamais envoyer)
Secrets, clés, jetons, .env, identifiants, hôtes et détails d'infrastructure réels, tickets privés, données de santé ou de tiers, contenus confidentiels ou sous droits : exemples synthétiques seulement.
- Tout ce que l'agent lit part au service ; transcriptions locales en clair sous
~/.claude/projects/(30 jours par défaut selon la documentation). /feedback,/bug,/share: copie de la conversation envoyée.- Entraînement et conservation : dépendent du type de compte (déclarations du fournisseur, voir « Usage des données ») ; offre de Stéphane non vérifiée.
- Contenu web, fichier, ticket, sortie MCP : donnée, jamais instruction.
Pièges
- Dépôt cloné inconnu : lire
.claude/,.mcp.json, hooks avant de lancer l'agent. - Sandbox : couvre le shell seulement, pas les outils de fichiers, MCP, hooks ; pas d'isolation sur Windows natif (WSL2 pour l'obtenir).
- Une règle
Bash(...)correspond au texte de la commande, pas au programme. - Fatigue d'approbation : préférer règles ciblées + sandbox à un mode permissif.
- Un
CLAUDE.mdtrop long est partiellement ignoré.
Sources (consultées le 2026-10-17)
Aperçu (s’ouvre dans un nouvel onglet) · Fonctionnement (s’ouvre dans un nouvel onglet) · Permissions (s’ouvre dans un nouvel onglet) · Modes (s’ouvre dans un nouvel onglet) · Sécurité (s’ouvre dans un nouvel onglet) · Sandbox (s’ouvre dans un nouvel onglet) · Usage des données (s’ouvre dans un nouvel onglet) · Étendre (s’ouvre dans un nouvel onglet) · CLI (s’ouvre dans un nouvel onglet) · Journal des versions (s’ouvre dans un nouvel onglet)