Modes de permissions pour les agents

De « confirmer chaque action » au mode auto : les modes de permissions déterminent à quelle fréquence un agent te demande ton accord avant de faire quelque chose.

Le problème de base

Un agent capable de modifier des fichiers, d'exécuter des commandes ou de faire des requêtes réseau a besoin de règles : que peut-il faire sans demander, et pour quoi a-t-il besoin de ton accord au préalable ? Ces règles s'appellent les modes de permissions (permission modes).

Les principaux modes dans Claude Code

Manuel (par défaut) : seule la lecture est autorisée, chaque modification de fichier et chaque commande est confirmée au préalable.
Accept Edits : les modifications de fichiers et les commandes système simples (par exemple créer un dossier) tournent sans demander, tout le reste continue d'être confirmé.
Mode Plan : l'agent n'a le droit que de faire des recherches et d'écrire un plan, aucune modification – bon pour explorer avant de vraiment construire.
Mode Auto : presque tout tourne sans demander, un modèle de vérification supplémentaire en arrière-plan bloque les actions risquées (par exemple déploiements en production, force push).
Bypass Permissions : toutes les vérifications sont désactivées – prévu uniquement pour des environnements isolés comme des conteneurs sans accès internet.

Comment changer de mode

En ligne de commande, on bascule entre les modes avec Shift+Tab, ou on démarre directement avec un flag comme --permission-mode plan.

La règle de base

Le moins de droits possible, autant que nécessaire (principe du moindre privilège). Pour un travail sensible ou du code inconnu : mode manuel. Pour des modifications de routine que tu vérifieras de toute façon ensuite via un diff : Accept Edits. Bypass Permissions seulement dans une vraie sandbox, jamais sur ta machine réelle.

EXEMPLE

Démarre avec « claude --permission-mode plan » pour une base de code nouvelle et inconnue. L'agent explore et propose un plan. C'est seulement après ta confirmation que tu passes (par exemple) en mode Accept Edits, pour qu'il puisse réellement écrire les modifications – sans que tu aies à confirmer chaque modification de fichier individuellement.

🛠️ EXERCICE — À TOI DE JOUER

Change délibérément entre deux modes de permissions dans une session Claude Code en cours, et observe la différence.

Démarre Claude Code dans un projet de test en mode par défaut (manuel) et demande une petite modification de code – observe la demande de confirmation.
Passe en mode Accept Edits avec Shift+Tab et demande le même type de modification – compare ce qui tourne désormais sans demander et ce qui continue d'être confirmé.
Passe en mode Plan et demande une modification plus importante – vérifie qu'aucun fichier n'est réellement modifié tant que tu n'as pas accepté le plan.

✅ AUTO-VÉRIFICATION

☐ As-tu pu identifier quelles actions tournaient automatiquement en mode Accept Edits et lesquelles continuaient d'être confirmées ?
☐ As-tu compris pourquoi le mode Plan ne change rien, alors que l'agent lit des fichiers et exécute des commandes ?
☐ Sais-tu pourquoi Bypass Permissions n'a de sens que dans un environnement isolé ?

QUIZ RAPIDE

Quelle est la règle de base pour choisir un mode de permissions ?