CLI : Référence complète des commandes Claude Code

claude [OPTIONS] [PROMPT]

# Session interactive standard
claude

# Session interactive avec un modèle spécifique
claude --model claude-opus-4-6

# Mode print : exécuter une tâche et quitter
claude --print "Explique le code dans src/auth.ts"
claude -p "Génère des tests unitaires pour utils/date.ts"

# Mode print avec format JSON
claude --print --output-format json "Liste les fonctions de ce fichier"

# Mode stream-json (pour traitement en temps réel)
claude --print --output-format stream-json "Analyse ce projet"

# Limiter le nombre de tours (mode agentic)
claude --max-turns 5 "Refactorise le module auth"

# Restreindre les outils disponibles
claude --allowedTools "Read,Bash" "Analyse sans modifier les fichiers"

# Reprendre la dernière session
claude --continue

# Reprendre une session par son ID
claude --resume abc123

# Verbose (debug)
claude --verbose "Pourquoi ce test échoue-t-il ?"

# Démarrer une session dans un worktree isolé
claude --worktree "Implémente la feature de paiement"

# Avec un modèle spécifique
claude -w --model claude-opus-4-5 "Refactorise le module auth"

# Démarrage minimal, sans aucun contexte projet
claude --bare --print "Génère un UUID v4 en TypeScript"

# Dans un script shell (démarrage ~10x plus rapide)
claude --bare --print --output-format json "Analyse ce JSON" < data.json

# En CI/CD pour une tâche ponctuelle
claude --bare --print --max-turns 1 "Vérifie la syntaxe de ce fichier YAML" < config.yml

# Récupère la dernière session web active
claude --teleport

# Si plusieurs sessions sont disponibles, une liste vous est présentée

# Utiliser l'agent "code-reviewer" défini dans .claude/agents/code-reviewer.md
claude --agent code-reviewer "Revois les changements dans src/api/"

# Agent de sécurité pour un audit
claude --agent security-auditor --print "Analyse ce fichier" < src/auth.ts

# Agent de rédaction technique
claude --agent tech-writer "Génère la documentation pour ce module"

# Session limitée à 0.50 $
claude --max-budget-usd 0.50 "Analyse et refactorise le dossier src/"

# En CI/CD pour éviter les dérapages
claude \
  --print \
  --max-budget-usd 1.00 \
  --max-turns 20 \
  "Exécute les tests et corrige les erreurs"

# Passer un fichier en entrée
cat src/auth.ts | claude --print "Ajoute des commentaires JSDoc à ce code"

# Chaîner des commandes
git diff HEAD~1 | claude --print "Résume ces changements en bullet points"

# Passer un prompt en entrée standard
echo "Explique le Design Pattern Observer" | claude --print

# Intégration dans un script shell
RESULT=$(claude --print --output-format json "Analyse ce code" < src/main.ts)
echo $RESULT | jq '.content[0].text'

# Lecture depuis un fichier
claude --print "Quels sont les risques de sécurité ici ?" < config/database.yml

# Exécution non-interactive avec contrôle strict
ANTHROPIC_API_KEY="sk-ant-..." \
  claude \
  --print \
  --max-turns 1 \
  --output-format json \
  "Vérifie la qualité du code dans src/"

# Mode agentic avec tours multiples
claude \
  --print \
  --max-turns 10 \
  --dangerously-skip-permissions \
  "Exécute la suite de tests et corrige les erreurs"

# Avec variables d'environnement dans la config
claude \
  --print \
  --allowedTools "Read,Bash,Write" \
  --system-prompt "Tu es un expert en sécurité. Ne modifie aucun fichier." \
  "Audite ce projet"

claude agents

# Exemple de sortie
# ID          STATUS      BRANCH                    SINCE
# agent-a3f2  running     feat/refactor-auth        5m ago
# agent-b8c1  running     feat/add-tests            2m ago
# agent-d9e4  completed   fix/memory-leak           12m ago

claude config [SOUS-COMMANDE] [OPTIONS]

# Exemples
claude config list

claude config get model
# → claude-sonnet-4-6

claude config set model claude-opus-4-6

claude config add allowedTools "Bash"
claude config remove allowedTools "Bash"

# Avec scope (global par défaut)
claude config --global set model claude-haiku-4-5

claude mcp [SOUS-COMMANDE] [OPTIONS]

claude mcp add [OPTIONS] <nom> -- <commande> [args...]

# Ajouter un MCP stdio (local, via npx)
claude mcp add filesystem -- npx -y @modelcontextprotocol/server-filesystem ~/projets

# Ajouter un MCP avec scope projet
claude mcp add --scope project postgres -- \
  npx -y @modelcontextprotocol/server-postgres postgresql://localhost/mydb

# Ajouter un MCP avec variable d'environnement
claude mcp add github -e GITHUB_TOKEN=ghp_xxx -- \
  npx -y @modelcontextprotocol/server-github

# Ajouter un MCP via transport SSE (HTTP)
claude mcp add --transport sse mon-api https://api.exemple.com/mcp

# Ajouter un MCP Python (via uvx)
claude mcp add mon-script -- uvx mon-package-python

claude mcp remove [--scope <portée>] <nom>

claude mcp remove filesystem
claude mcp remove --scope project postgres

claude mcp list
# Affiche : nom, statut (connected/disconnected), outils disponibles, scope

# Afficher les logs d'un MCP (utile pour déboguer)
claude mcp logs github

# Suivre les logs en temps réel
claude mcp logs -f filesystem

# Affiche la configuration complète d'un MCP
claude mcp get github

claude doctor

# Exemple de sortie
claude doctor
# ✓ Claude Code v1.x.x (à jour)
# ✓ API Anthropic accessible
# ✓ ANTHROPIC_API_KEY valide
# ✓ MCP filesystem : connecté (5 outils)
# ✗ MCP github : erreur de connexion (GITHUB_TOKEN manquant)
# ✓ Permissions fichiers : OK

# Met à jour Claude Code vers la dernière version
claude update

# Vérifie la version sans mettre à jour
claude --version

{
  "type": "result",
  "subtype": "success",
  "cost_usd": 0.0023,
  "is_error": false,
  "duration_ms": 1842,
  "num_turns": 1,
  "result": "Texte de la réponse ici...",
  "session_id": "abc123"
}

# Traitement ligne par ligne
claude --print --output-format stream-json "prompt" | while IFS= read -r line; do
  echo "$line" | jq -r 'select(.type == "content_block_delta") | .delta.text // empty'
done