Référence des commandes, raccourcis, emplacements de fichiers et squelettes de configuration. Chaque section renvoie au module qui la démontre.
# Installateur natif : macOS, Linux et WSL
curl -fsSL https://claude.ai/install.sh | bash
# Installateur natif : Windows, dans PowerShell
irm https://claude.ai/install.ps1 | iex
# Avec npm
npm install -g @anthropic-ai/claude-code
# Avec Homebrew, sur macOS
brew install --cask claude-code
$ claude --version
<version> (Claude Code)
| Commande | Effet |
|---|---|
claude doctor |
Rapport en lecture seule sur l'installation et les fichiers de réglages |
claude update |
Mise à jour immédiate vers la dernière version |
claude install [version] |
Installe ou réinstalle le binaire natif |
/login, /logout |
Connexion et déconnexion du compte Anthropic, depuis la session |
claude auth status |
État de l'authentification, en JSON |
export ANTHROPIC_API_KEY=sk-ant-... |
Facturation à l'usage ; prend le pas sur le compte connecté |
Les installations natives se mettent à jour seules en arrière-plan ; les deux autres méthodes ont leur propre commande.
brew upgrade claude-code
npm install -g @anthropic-ai/claude-code@latest
Options de claude -p, le mode non interactif utilisé en intégration continue et pour les captures.
$ claude -p "liste les routes de l'API" --model sonnet --output-format json
| Option | Effet |
|---|---|
-p, --print |
Une réponse puis sortie, sans session interactive |
-c, --continue |
Reprend la conversation la plus récente du dossier |
--model <alias> |
sonnet, opus, haiku, ou un identifiant complet |
--permission-mode <mode> |
default, acceptEdits, plan, auto, dontAsk, bypassPermissions |
--allowedTools "Bash(uv run *)" |
Outils exécutés sans demander d'autorisation |
--output-format text\|json\|stream-json |
Format de sortie ; json porte les compteurs de tokens |
--setting-sources user,project,local |
Fichiers de réglages chargés au démarrage |
--mcp-config ./mcp.json |
Serveurs MCP lus dans un fichier ou une chaîne JSON |
--strict-mcp-config |
Ignore toute autre configuration MCP que celle passée |
--plugin-dir ./quizops-kit |
Charge un plugin depuis un dossier, pour cette session |
--add-dir <chemin> |
Ajoute un dossier au périmètre de la session |
--effort <niveau> |
Niveau de raisonnement du lancement |
--verbose |
Journalisation détaillée ; nécessaire pour lire stream-json |
--disallowedTools "Bash(git push*)" |
Outils refusés pour la session |
-r, --resume <session> |
Reprend une session par identifiant ou par nom |
| Raccourci | Effet |
|---|---|
Échap |
Interrompt l'agent en pleine action, ou ferme une boîte de dialogue |
Échap Échap |
Efface le brouillon ; sur une saisie vide, ouvre le menu de retour arrière |
Maj+Tab |
Fait défiler les modes de permission |
Option+T (macOS) ou Alt+T |
Bascule la réflexion étendue |
Option+P (macOS) ou Alt+P |
Change de modèle sans effacer la saisie |
Ctrl+R |
Recherche inverse dans l'historique des prompts |
Ctrl+T |
Affiche ou masque la liste des tâches de l'agent |
Ctrl+O |
Bascule l'affichage détaillé du transcript |
Ctrl+G |
Ouvre la saisie en cours dans l'éditeur de texte |
Ctrl+C |
Interrompt ; sur une saisie vide, deux pressions quittent la session |
Ctrl+B |
Passe la commande ou l'agent en cours en arrière-plan |
Ctrl+S |
Met la saisie de côté, la restaure à la pression suivante |
Ctrl+X Ctrl+K |
Arrête tous les sous-agents de fond de la session |
Option+O (macOS) ou Alt+O |
Bascule le mode rapide |
Haut et Bas |
Parcourent l'historique des prompts |
Ctrl+L |
Redessine l'écran sans toucher à la conversation |
Ctrl+D |
Quitte la session, à la deuxième pression |
Maj+Entrée ou Ctrl+J |
Saut de ligne sans envoyer le message |
? sur une saisie vide |
Panneau d'aide des raccourcis |
/ en début de ligne |
Commande intégrée ou skill |
@ |
Complétion de chemin : le fichier nommé entre en contexte |
! en début de ligne |
Exécute une commande shell et injecte sa sortie dans la session |
| Commande | Effet |
|---|---|
/clear |
Vide la conversation et repart d'un contexte neuf |
/compact |
Résume la conversation pour libérer du contexte |
/context |
Détaille l'occupation de la fenêtre de contexte |
/cost |
Alias de /usage : consommation de la session et limites du forfait |
/model |
Change de modèle |
/effort |
Règle le niveau de raisonnement : low à xhigh, max, auto, status |
/permissions |
Règles d'autorisation, de question et de refus des outils |
/config |
Réglages de la session ; accepte /config theme=dark sans ouvrir l'interface |
/resume |
Reprend une session par identifiant, par nom ou dans le sélecteur |
/rewind |
Revient à un point antérieur de la conversation ou du code |
/memory |
Édite les fichiers CLAUDE.md et la mémoire automatique |
/init |
Génère un CLAUDE.md de départ |
/doctor |
Examen de l'installation et de la configuration, avec corrections proposées |
/status |
Onglet Statut : version, modèle, compte, connectivité |
/hooks |
Affiche les hooks configurés pour les événements d'outils |
/agents |
Rappelle comment créer et gérer les sous-agents |
/mcp |
Connexions MCP, authentification, reconnect, enable, disable |
/plugin |
Menu des plugins ; accepte list, install, enable, disable |
/reload-plugins |
Recharge les plugins sans relancer la session |
/plan |
Entre en mode plan, avec une description de tâche en argument |
/skills |
Liste les skills disponibles et leur provenance |
/skill-doctor |
Coût en contexte et fréquence d'usage de chaque skill |
/tasks |
Tâches de fond de la session : shells et sous-agents |
/diff |
Modifications en cours dans le dossier de travail |
/export |
Exporte la conversation en texte brut |
/add-dir |
Ajoute un dossier de travail à la session en cours |
/help |
Aide et liste des commandes |
Les neuf skills livrés avec l'outil, démontrés au module 05. Ils répondent en anglais par défaut.
| Skill | Effet |
|---|---|
/code-review (alias /review) |
Relit un diff, une branche ou une pull request ; --fix applique les constats |
/simplify |
Relit le code modifié et applique les simplifications |
/batch |
Décompose une tâche répétitive et la mène en parallèle |
/loop |
Rejoue un prompt ou une commande, à intervalle donné ou choisi par l'agent |
/debug |
Active la journalisation de débogage et relit le fichier produit |
/claude-api |
Charge en contexte la référence de l'API Anthropic |
/security-review |
Analyse les modifications de la branche à la recherche de vulnérabilités |
/verify |
Construit et lance le projet pour confirmer qu'un changement marche |
/run |
Lance l'application du projet et la pilote |
Les six modes (default, acceptEdits, plan, auto, dontAsk, bypassPermissions) sont décrits au module 02. Maj+Tab les fait défiler en session, /plan entre directement en mode plan.
claude --permission-mode plan
claude --permission-mode acceptEdits
~/.claude/
├── CLAUDE.md préférences valables sur tous vos projets
├── settings.json réglages personnels
├── skills/<nom>/SKILL.md
├── agents/<nom>.md
├── rules/<sujet>.md
└── projects/<projet>/memory/ mémoire automatique, MEMORY.md en index
<projet>/
├── CLAUDE.md conventions de l'équipe
├── CLAUDE.local.md vos préférences sur ce projet
├── .mcp.json serveurs MCP du projet
├── .claude-plugin/ plugin.json, ou marketplace.json d'une place de marché
└── .claude/
├── settings.json permissions, hooks, plugins activés
├── settings.local.json vos réglages de poste
├── commands/<nom>.md ancien format, fusionné dans les skills
├── skills/<nom>/SKILL.md
├── agents/<nom>.md
├── rules/<sujet>.md
└── hooks/<script>.sh
| Chemin | Versionné |
|---|---|
CLAUDE.md, .claude/settings.json |
Oui |
.claude/rules/, skills/, commands/, agents/, hooks/ |
Oui |
.mcp.json, .claude-plugin/ |
Oui |
.claude/settings.local.json |
Non, dans .gitignore |
CLAUDE.local.md |
Non, dans .gitignore |
.env, base de données locale |
Non, dans .gitignore |
~/.claude/ |
Hors dépôt |
Réglages gérés (/Library/Application Support/ClaudeCode/, /etc/claude-code/) |
Déployés par l'informatique |
Voir le module 05 : $ARGUMENTS reprend tous les arguments, $0 le premier, $1 le second, ${CLAUDE_SKILL_DIR} le dossier du skill.
---
name: nouvelle-question
description: Ajoute une question au quiz QuizOps dans data/questions.json puis vérifie le fichier. À utiliser quand on demande d'ajouter, de créer ou d'insérer une question de quiz.
argument-hint: "[énoncé de la question]"
allowed-tools: Read, Edit, Bash(uv run python *)
---
Ajoute une question au quiz QuizOps.
1. Lis `data/questions.json` et repère le plus grand `id`.
2. Rédige la question à partir de la demande : $ARGUMENTS.
3. Ajoute l'objet à la fin du tableau, avec `id` égal au plus grand id plus un.
4. Lance `uv run python ${CLAUDE_SKILL_DIR}/verifier.py` et corrige jusqu'à obtenir `0 erreur`.
5. Affiche la question ajoutée et le résultat de la vérification. Ne committe pas.
Voir le module 08 : les noms d'outils acceptés par tools, disallowedTools, allowed-tools et --allowedTools sont Read, Write, Edit, Glob, Grep, Bash, WebFetch, WebSearch, Agent, Skill.
---
name: relecteur
description: Relit du code ou un diff avec la grille du projet et rend des constats classés par gravité. À utiliser pour une revue, une relecture ou un avis sur des modifications.
tools: Read, Grep, Glob
model: sonnet
maxTurns: 15
memory: project
---
Tu es le relecteur du projet QuizOps. Tu ne modifies jamais un fichier : tu lis, tu compares au cahier des charges (`PRD.md`) et aux conventions (`CLAUDE.md`), et tu rends un tableau `constat | fichier:ligne | gravité` avec trois gravités : bloquant, à corriger, remarque.
Termine par une recommandation en une phrase : fusionner, corriger d'abord, ou reprendre.
Voir le module 06.
{
"hooks": {
"PostToolUse": [
{ "matcher": "Write|Edit",
"hooks": [{ "type": "command",
"command": "jq -r '.tool_input.file_path' | grep '\\.py$' | xargs -r uvx ruff format -q" }] }
],
"PreToolUse": [
{ "matcher": "Bash",
"hooks": [{ "type": "command",
"command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/garde-fou.sh" }] }
]
}
}
Voir le module 07.
{
"mcpServers": {
"playwright": {
"type": "stdio",
"command": "npx",
"args": ["@playwright/mcp@latest"],
"env": {}
}
}
}
Voir le module 07.
{
"name": "quizops-kit",
"description": "Outillage de l'équipe QuizOps : revue, ajout de question, hooks de formatage et de garde-fou, serveur MCP Playwright",
"version": "1.0.0",
"author": {
"name": "Formation Vibe Coding"
}
}
| Variable | Effet |
|---|---|
ANTHROPIC_API_KEY |
Clé d'API envoyée en en-tête X-Api-Key ; prime sur le compte connecté |
ANTHROPIC_MODEL |
Modèle par défaut, par alias ou par identifiant complet |
CLAUDE_CODE_SUBAGENT_MODEL |
Modèle par défaut des sous-agents et des coéquipiers sans modèle assigné |
CLAUDE_CODE_MAX_CONCURRENT_SUBAGENTS |
Sous-agents simultanés dans une session, 20 par défaut |
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS |
1 active les équipes d'agents, expérimentales et désactivées par défaut |
MAX_THINKING_TOKENS |
Budget fixe de réflexion étendue, plancher à 1 024 tokens |
MAX_MCP_OUTPUT_TOKENS |
Plafond de tokens d'une réponse d'outil MCP, 25 000 par défaut |
DISABLE_AUTOUPDATER |
1 coupe les mises à jour automatiques ; claude update reste disponible |
CLAUDE_CONFIG_DIR |
Remplace ~/.claude comme répertoire de configuration |
Ces variables se posent dans l'environnement du shell ou dans le bloc env d'un fichier de réglages.
{ "env": { "CLAUDE_CODE_SUBAGENT_MODEL": "haiku" } }
| Symptôme | Cause probable | Que faire |
|---|---|---|
claude: command not found |
Le PATH n'est pas encore pris en compte |
Ouvrir un nouveau terminal, puis claude doctor |
| Le navigateur ne s'ouvre pas à la connexion | Session SSH, conteneur ou WSL | Appuyer sur c pour copier l'adresse et l'ouvrir à la main |
| L'agent oublie une contrainte donnée au début | Fenêtre de contexte saturée | /compact, ou écrire la contrainte dans CLAUDE.md |
| Un bug corrigé réapparaît | L'agent travaille sur une version périmée du fichier | Lui faire relire le fichier avec @chemin |
| Les réponses tournent en rond | Hypothèses contradictoires accumulées | /clear, puis repartir du code actuel |
| Il propose de créer un fichier qui existe déjà | Il a perdu l'état du projet | Lui faire lister le dossier avec !ls app/ |
| Les conventions du projet ne sont pas suivies | CLAUDE.md non chargé ou contradictoire |
/context, section Memory Files, puis relire le fichier |
| Un skill ne se déclenche jamais seul | description sans les mots de la demande |
Y ajouter les verbes que vous employez |
| Trop de questions d'autorisation | Mode trop strict pour la tâche | Maj+Tab vers acceptEdits, ou une règle permissions.allow |
| L'agent modifie des fichiers non prévus | Aucune contrainte de périmètre | Nommer dans le prompt les fichiers autorisés |
| Session lente ou coûteuse | Contexte trop chargé | /context pour voir, /clear pour repartir |
| La session est bloquée par un hook | Matcher trop large sur PreToolUse |
/hooks pour voir, éditer settings.local.json, relancer |
| Un hook de formatage ne reformate rien | Le chemin arrive dans le JSON de l'entrée standard | jq -r '.tool_input.file_path' en tête de la commande |
Un serveur MCP reste Pending approval |
Le .mcp.json du projet n'a pas été approuvé |
Lancer claude en interactif et approuver, ou /mcp |
| Un hook versionné ne s'applique pas | Le dossier n'a pas été approuvé au premier lancement | Ouvrir une session interactive et approuver le dossier |
| Un plugin modifié n'est pas pris en compte | Les plugins sont chargés au démarrage | /reload-plugins |
Un skill ajouté n'apparaît pas dans le menu / |
Les dossiers de skills n'ont pas été relus | /reload-skills |
| Une commande est refusée quoi que dise le prompt | Une règle permissions.deny la couvre |
/permissions pour la lire, puis la corriger |
/context déborde après l'ajout de serveurs MCP |
Les descriptions d'outils restent chargées | /mcp disable <serveur> sur ce qui ne sert pas |
| La sortie d'un outil MCP est tronquée | Plafond de MAX_MCP_OUTPUT_TOKENS |
Relever la variable, ou restreindre la requête |
| L'agent ne voit pas un dossier voisin | Il est hors du périmètre de la session | --add-dir au lancement, ou /add-dir en session |
claude -p ignore les réglages du projet |
Les sources de réglages ne sont pas toutes chargées | --setting-sources project |
Les tokens consommés ne sont pas visibles en -p |
Sortie en texte brut | --output-format json, puis lire le champ usage |
➡️ Voir aussi : Ressources Externes
➡️ Travaux pratiques : Exercices