DevOps / CI/CD

La configuration Claude Code sera-t-elle réécrite par l’Agent en 2026 ? Protection SBPL

La configuration Claude Code sera-t-elle réécrite par l’Agent en 2026 ? Protection SBPL

Le fichier .claude/settings.json est modifiable par l’Agent dès que le processus peut écrire dans le répertoire du projet.

La solution gagnante dépend du niveau d’autonomie : pour une tâche supervisée, combinez denyWrite et l’échec fermé ; pour une équipe, déplacez les règles critiques vers les managed settings ; pour un Agent autonome, ajoutez une protection SBPL du processus entier ou utilisez un Mac indépendant.

Dernière mise à jour : 15 septembre 2026. Les champs et comportements décrits ici ont été recoupés avec la documentation officielle de configuration, les pages sur les permissions et le sandboxing, le dépôt public Sandbox Runtime et la page de manuel macOS consacrée à sandbox-exec.

Cet article concerne les développeurs qui conservent .claude/settings.json dans un dépôt réel et autorisent Claude Code à modifier des fichiers. Il s’adresse aussi aux ingénieurs DevSecOps qui doivent empêcher une règle d’équipe d’être affaiblie, ainsi qu’aux responsables de plateformes préparant une exécution longue ou sans supervision sur un Mac distant.

Le répertoire contrôlé par l’Agent

Le modèle de menace est simple : l’Agent reçoit une demande, consulte sa configuration, puis agit dans une zone où cette même configuration est accessible en écriture. Dans ce cas, le fichier qui définit les limites n’est pas une frontière ; c’est une ressource modifiable.

Un scénario réaliste ne nécessite pas de supposer une vulnérabilité générale de Claude Code. Il suffit que les permissions accordées au processus couvrent :

  • le code du projet ;
  • le dossier .claude ;
  • les hooks exécutés lors d’une action ;
  • les Skills ou scripts chargés par les sessions suivantes ;
  • un fichier local contenant une règle d’autorisation ou d’exclusion.

La configuration peut alors être modifiée avant l’action suivante. Un Agent peut aussi déclencher un sous-processus Bash qui lit une version différente de la politique, selon le niveau auquel la restriction a été appliquée.

Il faut donc séparer quatre notions souvent confondues :

  • les outils Edit et Write, qui modifient directement des fichiers selon les permissions de la session ;
  • Bash, qui lance des commandes et des sous-processus ;
  • le Bash Sandbox, qui vise principalement Bash et ses enfants ;
  • la protection du processus Claude Code, qui doit être appliquée de l’extérieur si le fichier de stratégie lui-même doit rester hors de portée.

La page officielle sur les permissions de Claude Code décrit les mécanismes de décision, mais une permission prioritaire n’est pas synonyme d’immutabilité. Une règle peut être prioritaire dans la fusion des paramètres tout en restant stockée dans un fichier que le processus peut réécrire.

Cette distinction est importante pour les projets audio, vidéo ou design. Un Agent peut avoir besoin d’écrire des rendus, des fichiers intermédiaires ou des métadonnées dans un dossier de travail, mais cela ne justifie pas l’accès au répertoire qui définit les hooks, les Skills et les permissions de la session suivante.

Paramètres de projet et stratégie durable

Les paramètres de projet sont utiles pour partager une convention de dépôt ou tester une nouvelle règle. Ils sont moins adaptés à la protection d’une politique qui doit survivre à l’Agent. Le problème n’est pas seulement le fichier principal : il faut cartographier tout ce qui peut influencer la prochaine session.

Une première revue doit couvrir :

  • .claude/settings.json et les variantes locales utilisées par l’équipe ;
  • les hooks appelés avant ou après une commande ;
  • les Skills ajoutés au dépôt ;
  • les scripts que Bash peut invoquer ;
  • les fichiers de configuration chargés par les outils de compilation, de test ou de déploiement ;
  • les chemins situés en dehors du dépôt mais accessibles depuis le même processus.

Le bon compromis consiste à laisser dans le dépôt les réglages fonctionnels : formatage, commandes de test, conventions de travail ou chemins de sortie non sensibles. Les règles de sécurité doivent suivre une autre logique. Une interdiction d’écriture dans la politique elle-même, une exigence d’échec fermé et une interdiction de sortie sans sandbox ne devraient pas dépendre d’un fichier que l’Agent peut éditer.

La configuration utilisateur peut convenir à un poste personnel, mais elle ne garantit pas à elle seule l’homogénéité d’une équipe. Un développeur peut avoir une politique locale différente, un dépôt peut introduire une règle inattendue et un script de démarrage peut lancer Claude Code depuis un autre répertoire. La stratégie doit donc être livrée par un canal que le projet ne peut pas réécrire.

Pour une vérification de poste, le guide de diagnostic de configuration est plus fiable qu’une lecture isolée de settings.json. L’objectif est de voir la politique effectivement chargée, pas seulement celle que l’équipe pense avoir publiée.

Fusion des niveaux et extension silencieuse

La présence d’un fichier managed ne suffit pas à conclure que l’ensemble des permissions est verrouillé. Les paramètres gérés, utilisateur, projet et locaux participent à la configuration effective selon leur priorité et leur mode de fusion. Les tableaux tels que ceux liés à l’écriture peuvent créer une extension de portée plutôt qu’un remplacement complet.

C’est le risque d’extension silencieuse : la règle semble restrictive dans un fichier, mais un autre niveau ajoute un chemin autorisé. La lecture du seul fichier du dépôt donne alors une image incomplète.

La méthode de contrôle doit suivre trois vérifications distinctes :

  • /status pour identifier l’état général et la source des réglages visibles ;
  • /permissions pour examiner les autorisations réellement appliquées ;
  • /doctor pour repérer les problèmes de configuration et de chargement.

Ces commandes ne remplacent pas une revue de contenu. Elles empêchent toutefois de déduire la frontière finale à partir d’un unique objet JSON. La documentation officielle de configuration et hiérarchie des réglages doit être relue à chaque évolution importante de Claude Code, surtout lorsque les champs de sécurité changent.

Pour un contrôle d’équipe, le test utile est négatif : modifier volontairement un fichier de stratégie fictif depuis le projet et vérifier que l’action est refusée, puis vérifier que la session suivante utilise encore la même politique. Le test ne doit jamais employer une clé réelle, un fichier système ou un dépôt de production.

Le mot managed settings désigne ici une couche de livraison protégée, pas une promesse absolue d’isolation. Si le poste autorise une exécution explicitement hors sandbox, ou si le lanceur ignore la politique gérée, la stratégie de fichier peut rester correcte tout en laissant l’environnement exposé.

Échec du sandbox et fausse continuité

Une configuration de protection peut échouer de trois façons différentes.

La première est l’échec d’initialisation : le sandbox ne se crée pas, parce qu’une dépendance manque ou que le profil n’est pas compatible avec l’environnement macOS. La deuxième est le retour à un flux ordinaire avec les permissions habituelles. La troisième est l’exécution explicitement non sandboxée, souvent utilisée pour débloquer une commande qui ne fonctionne pas dans l’environnement restreint.

Ces cas n’ont pas la même gravité. Dans le premier, l’exécution peut s’arrêter. Dans le deuxième, elle peut continuer avec une protection réduite. Dans le troisième, le comportement dépend directement de la règle qui autorise la sortie. Un fichier .claude intact ne prouve donc pas que la tâche a toujours été isolée.

La documentation officielle sur le sandboxing de Claude Code confirme que le sandbox natif vise principalement Bash et ses processus enfants. Il ne faut pas lui attribuer automatiquement un contrôle sur les actions internes de Claude Code, sur tous les outils Edit et Write, ou sur chaque chemin accessible au processus principal.

Pour une tâche sans supervision, la combinaison attendue est la suivante :

  • exiger l’arrêt si le sandbox n’est pas disponible ;
  • désactiver les sorties non sandboxées lorsqu’elles ne sont pas indispensables ;
  • réduire les exceptions de commandes à un besoin documenté ;
  • tester l’échec avant de lancer le dépôt réel ;
  • journaliser la politique effectivement activée ;
  • conserver un mécanisme de retour à une session manuelle.

Les noms exacts des champs, leurs valeurs par défaut et leur disponibilité doivent être vérifiés dans la version de la documentation utilisée au moment du déploiement. Le champ failIfUnavailable est explicitement mentionné dans la documentation officielle fournie pour ce sujet ; il ne faut pas inventer une variante de nom ou supposer qu’une option locale produit le même résultat.

Attention. Une politique qui refuse l’écriture ne protège pas forcément la confidentialité. La lecture des secrets, la résolution DNS, la sortie réseau et l’accès à un agent SSH sont des surfaces distinctes. La défense contre la modification de .claude doit être testée séparément de l’isolation réseau.

SBPL et protection du processus complet

SBPL, ou Sandbox Profile Language, intervient à un niveau différent. Au lieu de demander à Claude Code de respecter une règle, le lanceur démarre le processus dans une politique macOS qui refuse certaines opérations. Cette politique peut couvrir le processus principal et ses enfants, ce qui répond au problème de portée du Bash Sandbox.

Le dépôt public Sandbox Runtime d’Anthropic documente l’utilisation de sandbox-exec et de politiques personnalisées sur macOS. Cette information confirme l’implémentation publique, mais ne transforme pas sandbox-exec en interface durable : la page de manuel macOS actuelle le marque comme obsolète. Il reste appelable dans les environnements concernés, mais son statut impose un plan de migration vers une solution moderne fondée sur la virtualisation ou sur un runtime maintenu.

Un profil de laboratoire peut protéger uniquement un répertoire temporaire et un fichier fictif. Le but est de vérifier le refus, pas de tester une clé d’API ou un dépôt réel :

(version 1)

(deny default)

(allow process*)
(allow file-read*
    (subpath "/tmp/claude-sbpl-lab"))
(allow file-write*
    (subpath "/tmp/claude-sbpl-lab"))

Ce profil est volontairement minimal. Il ne donne pas automatiquement à Claude Code l’accès au projet, au trousseau, aux fichiers personnels ou au réseau. Il peut donc empêcher le lancement normal de la commande si des autorisations complémentaires sont nécessaires. C’est précisément pourquoi la validation doit se faire sur un environnement jetable.

Un lanceur réversible peut ressembler à ceci :

claude_sbpl_lab() {
  sandbox-exec -f "$HOME/.config/claude/lab.sb" claude "$@"
}

L’alias ne doit pas remplacer le lanceur habituel sans test de sortie. Le contrôle doit suivre une séquence claire :

  • créer uniquement /tmp/claude-sbpl-lab ;
  • y placer un fichier sans valeur sensible ;
  • lancer la fonction avec une demande d’écriture dans ce répertoire ;
  • tenter une écriture dans .claude d’un dépôt de test ;
  • vérifier le refus ;
  • quitter le processus ;
  • supprimer le profil et les fichiers temporaires.

Cette expérience distingue Seatbelt, le mécanisme de confinement macOS, de Sandbox Runtime, la couche qui prépare et applique les profils, et du Bash Sandbox intégré à Claude Code. Elle ne prouve pas la compatibilité de chaque version future. Elle démontre seulement la frontière choisie dans cet environnement précis.

Apple décrit également les opérations de sandbox dans la page de manuel générale de sandbox. Pour une plateforme appelée à durer, la virtualisation de macOS ou un Mac réservé à l’Agent est plus défendable qu’une dépendance non maintenue à sandbox-exec.

Choix d’environnement selon le risque

Le choix ne porte pas uniquement sur la puissance de la machine. Il concerne l’emplacement de la stratégie, le mode de livraison, la récupération après erreur et l’exclusivité de l’environnement.

Situation Stratégie de fichiers Protection complémentaire Décision
Développement supervisé Réglages de projet pour les fonctions, interdictions locales pour les chemins sensibles Bash Sandbox et contrôle manuel Acceptable si l’Agent ne travaille pas seul
Travail partagé en équipe Règles critiques hors du dépôt, livrées par managed settings Vérification avec /status, /permissions et /doctor Préférable pour empêcher l’affaiblissement par un projet
Agent sans supervision Politique hors de portée de l’Agent Échec fermé, absence de sortie non sandboxée et journalisation Requis avant une exécution prolongée
Tâche à fort impact Stratégie protégée et environnement séparé SBPL réversible ou Mac indépendant, avec plan de migration Choisir l’isolement plutôt qu’une simple permission
Besoin de récupération rapide Copie versionnée de la politique et dépôt jetable Restauration testée avant l’exécution Indispensable lorsque l’Agent modifie beaucoup de fichiers

La première ligne convient à un développeur qui observe les changements et peut arrêter la session. Elle ne convient pas à un pipeline qui continue pendant la nuit. Dans ce cas, le projet ne doit plus être le propriétaire effectif de la politique.

La troisième et la quatrième lignes ne signifient pas qu’un Mac indépendant rend la configuration inutile. L’environnement séparé limite la portée d’une erreur et simplifie la restauration, mais les permissions, les secrets et le réseau doivent encore être contrôlés. Pour un travail audio ou vidéo, cette séparation permet par exemple de laisser l’Agent générer des rendus intermédiaires dans un espace dédié sans exposer les bibliothèques originales ni les réglages de production.

La prochaine étape peut être préparée dans un environnement de test accessible depuis la console ProxyMac, puis documentée avec les règles de confidentialité de ProxyMac. Le point important n’est pas de déplacer automatiquement chaque projet : il faut d’abord identifier les fichiers de stratégie, les tâches sans supervision et les répertoires réellement nécessaires.

FAQ

Claude Code peut-il modifier son propre fichier settings.json ?

Oui, si le processus dispose d’un accès en écriture au répertoire qui contient ce fichier, notamment .claude. La priorité d’un paramètre n’en fait pas un fichier immuable. Pour une protection réelle, le fichier doit être placé hors de la zone contrôlée par l’Agent, puis vérifié avec /status, /permissions et /doctor. Les tâches autonomes nécessitent en plus un échec fermé et une politique livrée séparément.

Comment empêcher Claude Code d’écrire dans le dossier .claude ?

Retirez .claude des chemins autorisés en écriture et utilisez une règle denyWrite conforme aux champs documentés pour la version déployée. Contrôlez ensuite la politique effective, car une autre couche peut ajouter un chemin. Pour une exécution sans supervision, refusez aussi la poursuite lorsque le sandbox est indisponible et évitez les mécanismes de sortie non sandboxée qui ne sont pas indispensables.

Les managed settings sont-ils plus sûrs que les paramètres de projet ?

Pour une règle qui ne doit pas être affaiblie par le dépôt ou par une session individuelle, les managed settings sont le choix le plus solide parmi les couches de configuration, puisque la documentation officielle leur attribue la priorité la plus élevée. Ils ne remplacent toutefois pas l’isolement : une exécution hors sandbox, un lanceur mal configuré ou une permission trop large peut encore exposer l’environnement.

SBPL peut-il limiter l’ensemble du processus Claude Code ?

Oui, un profil SBPL appliqué par le lanceur peut viser Claude Code et ses sous-processus, contrairement au Bash Sandbox qui cible principalement Bash et ses enfants. Il peut donc refuser l’écriture dans le projet ou dans le dossier de stratégie. sandbox-exec est néanmoins obsolète selon la documentation macOS ; le profil doit rester réversible et accompagné d’un projet de migration vers une isolation maintenue.

Le point de bascule est désormais concret : un poste local avec des réglages de projet reste adapté lorsque l’Agent est observé, mais il devient une mauvaise base dès que la politique, les hooks et les secrets sont accessibles dans la même zone. Les managed settings améliorent la livraison d’équipe, sans résoudre seuls la séparation du processus. SBPL ajoute une barrière plus large, mais dépend d’un mécanisme macOS obsolète. Un Mac indépendant offre enfin une récupération plus claire, au prix d’une préparation et d’un contrôle supplémentaires.

Pour une équipe qui doit faire fonctionner Claude Code longtemps, la démarche la plus sûre consiste à inventorier les fichiers de stratégie, le niveau d’autonomie et les seuls chemins d’écriture nécessaires, puis à valider cette séparation dans un environnement Mac réservé. La location d’un Mac ProxyMac peut alors être envisagée comme environnement de test ou d’exécution isolé, plutôt que comme un simple remplacement de poste : elle évite de mélanger le dépôt de production, les réglages de sécurité et les essais d’un Agent encore en cours de validation.

FAQ

Claude Code peut-il modifier son propre fichier settings.json ?+
Oui, si le processus dispose d’un accès en écriture au répertoire qui contient ce fichier, notamment .claude. Le niveau de priorité d’un paramètre ne transforme pas le fichier en objet immuable. Pour une protection réelle, le fichier doit être placé hors de la zone contrôlée par l’Agent, puis vérifié avec les commandes de diagnostic et, si nécessaire, protégé par managed settings ou par une politique SBPL.
Comment empêcher Claude Code d’écrire dans le dossier .claude ?+
Commencez par retirer .claude des chemins autorisés en écriture et ajoutez une règle denyWrite adaptée à la configuration officiellement prise en charge. Vérifiez ensuite la politique réellement chargée avec /status, /permissions et /doctor. Pour une tâche autonome, cette mesure doit être complétée par une configuration protégée hors du projet et par un comportement d’échec fermé lorsque le sandbox n’est pas disponible.
Les managed settings sont-ils plus sûrs que les paramètres de projet ?+
Ils sont plus adaptés à une règle qui ne doit pas être affaiblie par le dépôt ou par une session individuelle, car la documentation officielle leur attribue la priorité la plus élevée. Ils ne remplacent toutefois pas une séparation d’environnement. Une erreur de livraison, un contournement autorisé ou une exécution hors sandbox peut encore modifier d’autres fichiers ; la vérification opérationnelle reste indispensable.
SBPL peut-il limiter l’ensemble du processus Claude Code ?+
Oui, un profil SBPL lancé à l’extérieur de Claude Code peut s’appliquer au processus principal et à ses sous-processus, alors que le Bash Sandbox vise principalement Bash et ses enfants. Cette approche permet de refuser l’écriture dans le projet ou dans un répertoire de stratégie. sandbox-exec est toutefois marqué comme obsolète par Apple : utilisez cet outil pour un contrôle ciblé et réversible, pas comme fondation durable sans plan de migration.

Un Mac distant pour vos environnements de développement sécurisés

Avec ProxyMac, vous disposez d’un Mac distant prêt à l’emploi pour développer, tester et exécuter vos agents avec davantage de contrôle.
Isolez vos tâches sensibles dans un environnement dédié afin de limiter les risques liés aux modifications non autorisées de vos fichiers de configuration.