Claude Code CLI : prise en main, commandes et configuration

Vous avez installé Claude Code CLI, créé lab-claude, et lancé quelques prompts. Mais vous n’exploitez qu’une fraction de l’outil : vous ne connaissez ni les commandes slash, ni les raccourcis, ni les fichiers de configuration, ni le mode non-interactif. Ce guide vous donne une prise en main complète de la CLI, sans entrer encore dans le pilotage fin d’une session (traité dans les guides suivants).

Ce que vous allez apprendre

Lire correctement la surface visuelle de la CLI (prompt, status bar, modes)
Utiliser les commandes slash essentielles au quotidien
Maîtriser les raccourcis clavier qui font gagner un temps réel
Référencer fichiers et dossiers avec les @-mentions
Lancer Claude Code en mode headless pour des scripts ou pipelines
Éditer settings.json pour la configuration et les permissions
Changer de modèle et suivre les coûts

Pourquoi maîtriser la CLI avant d’optimiser ses prompts

Connaître la surface technique de l’outil économise énormément de temps. Sans ces bases :

vous retapez ce que /resume ferait en une commande
vous copiez-collez du code au lieu d’utiliser @fichier
vous laissez passer des permissions par défaut inadaptées
vous ne savez pas basculer entre modèles selon la tâche

Ce guide est volontairement factuel : peu de théorie, beaucoup de raccourcis et d’exemples concrets.

Prérequis

Claude Code CLI installé et authentifié (voir installation CLI)
Projet fil rouge lab-claude en place (voir créer lab-claude)
Terminal local prêt

Vue d’ensemble de la surface CLI

Une session Claude Code CLI affiche trois zones principales :

Prompt d’entrée (> ou │) : votre zone de saisie
Fil de session : historique des échanges et des actions
Status bar (en bas) : modèle actif, mode courant, répertoire, coût cumulé

La status bar est votre radar : elle vous dit en permanence si vous êtes en mode plan, acceptEdits ou default, quel modèle répond, et dans quel répertoire vous travaillez.

Démarrer, quitter, reprendre une session

cd ~/Projets/lab-claude
claude

Claude s’ouvre dans le répertoire courant et lit automatiquement CLAUDE.md s’il existe.

Ctrl + D : quitter proprement la session
Ctrl + C : annuler la saisie en cours, double pression pour quitter

claude --resume       # ouvre le sélecteur de sessions
claude --continue     # reprend la dernière session immédiatement

Dans une session active, utilisez /resume pour rouvrir une session précédente sans quitter.

Les commandes slash essentielles

Les commandes slash commencent par / et s’exécutent directement dans la session. Voici les plus utiles au quotidien :

Commande	Rôle
`/help`	Afficher toutes les commandes disponibles
`/config`	Ouvrir la configuration interactive (thème, langue, modèle)
`/theme`	Changer rapidement de thème d’affichage
`/model`	Basculer entre modèles (Sonnet, Opus, Haiku)
`/init`	Générer un `CLAUDE.md` de départ pour le projet
`/clear`	Effacer le contexte et repartir propre
`/compact`	Compresser le contexte de la session
`/status`	État de la session, authentification, version
`/cost`	Consommation tokens et coût estimé (API)
`/stats`	Statistiques d’usage détaillées (utile en plan Pro/Max)
`/memory`	Consulter et éditer les mémoires auto
`/mcp`	Gérer les serveurs MCP connectés
`/permissions`	Voir et ajuster les permissions d’outils
`/add-dir`	Ajouter un répertoire supplémentaire au contexte
`/resume`	Rouvrir une session précédente
`/agents`	Lister et gérer les subagents disponibles
`/hooks`	Gérer les hooks configurés
`/review`	Lancer une revue de PR
`/logout`	Déconnecter le compte

Les raccourcis clavier qui font gagner du temps

Raccourci	Effet
`Esc`	Interrompre Claude en cours d’action
`Shift + Tab`	Basculer entre modes : default → acceptEdits → plan
`Tab`	Autocomplétion (commandes, fichiers)
`↑` / `↓`	Naviguer dans l’historique des prompts
`Ctrl + R`	Recherche dans l’historique
`Ctrl + C`	Annuler la saisie (2 pressions = quitter)
`Ctrl + D`	Quitter la session
`Ctrl + L`	Effacer l’écran (le contexte est conservé)
`Ctrl + J`	Insérer une nouvelle ligne sans envoyer

Shift + Tab est le raccourci le plus important à mémoriser : il fait tourner l’agent entre les modes default, acceptEdits et plan. Les trois modes sont détaillés dans mode plan, diff et validations.

Les @-mentions : référencer fichiers et dossiers

Dans un prompt, @ permet de pointer un fichier ou un dossier pour que Claude le charge automatiquement.

Lis @app/main.py et @tests/test_health.py.
Propose un plan en 3 étapes pour ajouter /version.

Usages courants :

@fichier.py : référence un fichier précis
@dossier/ : référence tout un dossier
@CLAUDE.md : force la relecture des règles projet
@README.md : cadre le contexte métier

Mode interactif vs mode headless

Le mode interactif est la session classique : vous tapez, Claude répond, vous validez.

Le mode headless exécute un prompt et quitte : parfait pour scripts, pipelines CI, tâches répétitives.

# Exécution ponctuelle sans session interactive
claude -p "Résume le rôle de app/main.py en 3 points"

# Forcer un modèle
claude -p "Lint check" --model claude-sonnet-4-6

# Sortie brute (pour pipes)
claude -p "List routes" --print

Exemple d’usage en script :

#!/usr/bin/env bash
claude -p "Analyse app/main.py et liste les imports inutiles" \
  --print > rapport-imports.txt

Le mode headless ne remplace pas le mode interactif pour le développement, mais devient indispensable pour l’automatisation.

Les fichiers de configuration

Claude Code utilise trois niveaux de configuration, du plus général au plus local :

Fichier	Portée	Versionné ?
`~/.claude/settings.json`	Utilisateur (toutes vos sessions)	Non
`.claude/settings.json`	Projet (pour toute l’équipe)	Oui
`.claude/settings.local.json`	Projet (surcharges locales)	Non (gitignore)

Les niveaux se cumulent : le plus local gagne en cas de conflit.

Exemple de settings.json projet pour lab-claude

{
  "model": "claude-sonnet-4-6",
  "permissions": {
    "allow": [
      "Bash(uv run ruff check:*)",
      "Bash(uv run pytest:*)",
      "Bash(git status)",
      "Bash(git diff:*)"
    ],
    "deny": [
      "Bash(rm -rf:*)",
      "WebFetch"
    ]
  },
  "env": {
    "PYTHONUNBUFFERED": "1"
  }
}

Commitez .claude/settings.json pour que toute l’équipe partage les mêmes garde-fous.

Gérer les permissions

Claude Code fonctionne avec un système allow / deny / ask :

allow : exécuté sans demande
deny : bloqué, même si demandé
ask : par défaut, demande à chaque appel

Voir et ajuster :

/permissions

Bonnes pratiques :

Autorisez les commandes de validation fréquentes (ruff, pytest, git status)
Refusez explicitement les commandes destructives (rm -rf, suppression de branches)
Laissez ask par défaut pour tout le reste

Changer de modèle et suivre les coûts

Changer de modèle

À la volée : /model dans la session
Au lancement : claude --model claude-opus-4-7
Par défaut : dans settings.json, clé model

Les modèles courants : Opus (raisonnement profond), Sonnet (équilibré, défaut), Haiku (rapide et économique).

Suivre les coûts et l’usage

Deux commandes complémentaires selon votre mode d’accès :

/cost — pertinent en accès API (Claude Console) : affiche tokens consommés et coût estimé en dollars selon le modèle
/stats — pertinent en abonnement Pro/Max : affiche statistiques d’usage (la tarification n’est pas à la session, les dollars de /cost ne reflètent donc pas votre facture)

Règle simple : utilisez /cost si vous consommez par jeton, /stats si vous êtes au forfait. Les deux peuvent être lancées en fin de session pour repérer les prompts coûteux ou les sessions trop longues.

Initialiser un CLAUDE.md rapidement

Depuis la racine d’un projet :

/init

Claude analyse le dépôt et propose un CLAUDE.md de départ. C’est une excellente base à relire et raccourcir (voir configurer CLAUDE.md).

Erreurs fréquentes

Symptôme	Cause probable	Correction
Commande slash non reconnue	Typo ou commande indisponible	`/help` pour lister les commandes
`Shift + Tab` ne change rien	Terminal qui capture la touche	Tester `Alt + M` ou reconfigurer le terminal
`@fichier` n’est pas chargé	Chemin relatif incorrect	Utiliser le chemin depuis la racine du projet
`claude -p` ne rend pas la main	Prompt qui lance un outil interactif	Ajouter `--print` pour sortie brute
Permissions qui demandent sans cesse	`ask` partout	Ajouter les commandes fiables dans `allow`
Coûts qui explosent	Modèle Opus sur tâches simples	Basculer sur Sonnet ou Haiku via `/model`

Checklist de fin de guide

Je connais au moins 10 commandes slash
Je sais basculer entre les 3 modes avec Shift + Tab
J’utilise @fichier au lieu du copier-coller
J’ai un settings.json projet commité
Je sais lancer Claude en mode headless
Je sais changer de modèle et consulter /cost ou /stats selon mon accès
Je sais reprendre une session avec --resume

À retenir

La status bar est votre radar : modèle, mode, répertoire, coût
Shift + Tab est le raccourci le plus rentable à mémoriser
@fichier > copier-coller pour la fraîcheur du contexte
settings.json projet commité = garde-fous partagés avec l’équipe
Le mode headless (claude -p) ouvre les usages d’automatisation

Prochaines étapes

Prompting de base CLI Transformer une demande vague en prompt borné et vérifiable

Premier workflow réel CLI Dérouler exploration, plan, exécution bornée et validation

Configurer CLAUDE.md Poser conventions et garde-fous persistants du projet