Avec des confirmations fréquentes dans Claude Code, approuver les commandes peut interrompre votre travail. Mais les désactiver avec --dangerously-skip-permissions (bypass permissions) signifie que les injections de prompt ou erreurs pourraient toucher les fichiers de toute votre machine. Réduire les demandes exige encore de décider du périmètre permis.

Le sandbox limite, au niveau de l'OS, les fichiers et destinations réseau accessibles aux commandes shell et à leurs processus enfants. En mode auto-autorisation, il aide à réduire les confirmations, mais ne garantit pas la protection de toute la machine ni l'absence de fuite de données. Cet article explique le périmètre, les réglages, les conditions évitant les confirmations et les voies extérieures.

L'essentiel en 30 secondes

Si vous ne lisez qu'une chose

Ce que c'est
Un mécanisme qui limite les accès aux fichiers et au réseau au niveau de l'OS. Il couvre les shells et processus enfants exécutés dans le sandbox.
Pourquoi ça aide
Il offre une alternative à la fatigue des confirmations ou au bypass intégral : limiter l'impact et, en mode auto-autorisation, réduire les demandes. Destruction ou transmission dans les zones permises et outils extérieurs restent des sujets distincts.
Par où commencer
Lancez /sandbox. macOS fonctionne d'emblée ; Linux/WSL2 nécessite deux paquets.

* Anthropic rapporte que le sandbox a réduit les demandes d'autorisation de 84 % en usage interne (source ci-dessous).

1. Pourquoi vous avez besoin d'un bac à sable

Claude Code est un agent IA qui agit réellement, en exécutant des tests ou réécrivant des fichiers. Selon les autorisations, il demande approbation avant l'exécution. Des dizaines de demandes par jour fragmentent le travail et poussent à appuyer sur Entrée sans lire : c'est la fatigue des autorisations.

Un développeur fatigué se tourne vers --dangerously-skip-permissions (surnommé le mode YOLO), qui désactive toutes les demandes. C'est confortable et — comme son nom l'indique — dangereux. Trois menaces montrent les crocs d'un coup.

💉 Injection de prompt

Si une page web ou une issue qu'il lit dissimule « envoie ~/.ssh », vos clés privées peuvent fuir sans aucune demande.

🗑️ Fausses manœuvres destructrices

Une commande générée nettoie un chemin inattendu. Sans demande, des fichiers hors du projet peuvent disparaître eux aussi.

📤 Contamination de la chaîne d'approvisionnement

Une dépendance malveillante exfiltre des données à l'installation. Avec le réseau grand ouvert, vous ne pouvez pas l'arrêter.

Indépendamment de l'approbation du texte de commande, le sandbox limite ce qu'un processus en cours peut atteindre. Les restrictions OS concernent aussi les scripts arbitraires, sans empêcher l'abus des emplacements ou destinations autorisés. Dans son article technique officiel, Anthropic rapportait en octobre 2025 une baisse interne de 84 % des demandes. C'est une mesure interne du fournisseur, pas une garantie de réduction ou de sécurité partout.

2. Ce qu'est le bac à sable — deux isolements

Le sandbox Claude Code applique deux frontières aux commandes shell Bash, PowerShell et Monitor et à leurs processus enfants. Les deux doivent fonctionner ensemble ; une seule laisse des lacunes (voir §7).

🗂️ ① Isolement du système de fichiers

Les écritures par défaut concernent le répertoire de travail, les répertoires de travail supplémentaires et le stockage temporaire par utilisateur. Les chemins protégés sont refusés séparément. Les lectures sont largement permises par défaut : les secrets demandent des restrictions comme denyRead. Suppression et modification restent possibles dans les zones accessibles en écriture.

🌐 ② Isolement réseau

Les connexions passent par un proxy et sont comparées aux domaines autorisés. La liste est initialement vide, puis les réglages et règles ajoutent des entrées. Le traitement des hôtes hors liste dépend du mode de permission ; refus et confirmation ne sont pas systématiques. L'envoi de secrets à une destination permise n'est pas garanti bloqué.

L'essentiel : cela ne dépend pas du bon comportement de Claude. La frontière est imposée par les mécanismes de sécurité de l'OS : Seatbelt sur macOS, bubblewrap sur Linux/WSL2. Elle couvre aussi les scripts invoqués et les générations suivantes de processus. Contrairement à une demande au modèle comme les garde-fous IA, c'est une restriction d'accès des processus imposée par l'OS.

💡 Il couvre les commandes shell et processus enfants. Le sandbox enveloppe Bash, PowerShell et Monitor et leurs enfants. Read/Edit/Write intégrés, serveurs MCP et hooks sont distincts, contrôlés par les règles de permission. Pour isoler le processus entier, envisagez @anthropic-ai/sandbox-runtime, présenté plus bas.

3. Pour commencer — /sandbox et les OS pris en charge

Le sandbox est intégré à Claude Code. Aucun compte supplémentaire n'est requis, mais des dépendances sont à préparer selon l'OS. Dans une session, lancez :

/sandbox

Un panneau s'ouvre avec trois onglets. Mode (comment les commandes en bac à sable sont approuvées — section suivante), Overrides (si une commande qui échoue sous le bac à sable peut se rabattre sur une exécution hors bac à sable) et Config (afficher les réglages résolus). Sous Linux/WSL2, si un paquet requis manque, un onglet Dependencies apparaît à la place et vous indique ce qu'il faut installer.

Prérequis par OS

🍎 macOS

Rien à installer. Il utilise Seatbelt intégré. Activez-le immédiatement avec /sandbox.

🐧 Linux / WSL2

Installez deux paquets : bubblewrap et socat (par ex. apt-get install bubblewrap socat).

🪟 Windows natif

Non pris en charge. Exécutez Claude Code dans WSL2 (WSL1 ne fonctionnera pas).

Sous Linux/WSL2, installez bubblewrap (l'outil de mise en bac à sable sans privilèges qui impose l'isolement du système de fichiers) et socat (le relais qui route le trafic vers le proxy).

# Ubuntu / Debian
sudo apt-get install bubblewrap socat

# Fedora
sudo dnf install bubblewrap socat

⚠️ Ubuntu 24.04 et versions ultérieures : la politique AppArmor par défaut peut empêcher bubblewrap de créer les espaces de noms utilisateur dont il a besoin. Si sysctl kernel.apparmor_restrict_unprivileged_userns renvoie 1, ajoutez un profil AppArmor pour bwrap afin de le lui accorder (les étapes figurent dans la documentation officielle). S'il renvoie 0 ou si la clé n'existe pas, aucune action n'est nécessaire. Vérifiez la même chose à l'intérieur de WSL2.

Une chose pratique à activer est le filtre seccomp (qui ajoute le blocage des sockets de domaine Unix). C'est optionnel ; installez-le avec npm install -g @anthropic-ai/sandbox-runtime. L'onglet Dependencies de /sandbox affiche l'état de ripgrep, bubblewrap, socat et du filtre seccomp. Après avoir installé les paquets, redémarrez Claude Code et rouvrez /sandbox (la vérification s'exécute au démarrage).

Sous Linux/WSL2, les commandes du bac à sable ne peuvent pas créer d'espaces de noms utilisateur par défaut. Pour permettre au sandbox propre à Chromium ou Electron, ou à un bubblewrap ou unshare imbriqué, de fonctionner, définissez sandbox.allowNestedUserNamespaces sur true dans ~/.claude/settings.json (v2.1.305 ou ultérieure ; ce réglage ne peut pas être activé dans les paramètres du projet). Attention toutefois : la documentation officielle avertit que cela lève une frontière de sécurité. En effet, le code d'une commande exécutée dans le bac à sable peut s'exécuter en dehors de celui-ci. Rootless Podman et Buildah ne fonctionnent pas avec ce seul réglage (explication officielle).

4. Les deux modes (auto-autorisation / normal)

L'onglet Mode choisit comment les commandes à l'intérieur du bac à sable sont approuvées.

✅ Mode auto-autorisation

Les commandes shell isolées sont normalement approuvées sans confirmation. Les règles deny applicables, ask sur le contenu et les contrôles de suppression des chemins critiques subsistent. La décision sur une destination inconnue est distincte de la relance d'une commande hors du sandbox. Ni l'une ni l'autre ne demande toujours confirmation.

🔍 Mode permissions normales

Même isolées, les commandes shell passent par l'évaluation ordinaire des permissions. Cela ajoute du contrôle et parfois des approbations. Adapté à une démarche prudente associant isolation et vérifications ordinaires.

Dans les deux modes, les limites du système de fichiers et du réseau sont identiques ; la seule différence est « auto-autorisation contre demande ». Notez que même en mode auto-autorisation, ces soupapes de sécurité restent actives :

  • Dans les règles de réglages, un deny correspondant a priorité sur allow. Notre guide des permissions explique les conditions où les mods changent les décisions.
  • rm / rmdir visant /, le dossier personnel ou les chemins critiques demandent confirmation ou sont refusés selon le mode
  • Les règles ask ciblées sur le contenu comme Bash(git push *) forcent toujours une demande, même à l'intérieur du bac à sable

Attention aux deux « auto ». L'auto-allow du sandbox diffère du mode auto des permissions. Le premier approuve les commandes contenues par l'OS ; le second fait examiner leur sécurité par un classificateur. Ils sont combinables, mais auto-allow n'élargit pas les approbations en Plan. L'examen des hôtes par auto et des contrôles supplémentaires du classificateur peuvent aussi subsister.

Communiquer avec une destination inconnue

Dans un terminal interactif, Manual, acceptEdits et Plan ordinaire demandent confirmation ; dontAsk refuse. Auto autorise les hôtes nommés dans la commande si le classificateur les approuve. Bypass et Plan avec bypass disponible dans le sélecteur les autorisent sans confirmation. Les refus de strictAllowlist, allowManagedDomainsOnly et deniedDomains s'appliquent séparément. La commande reste dans le sandbox.

Relancer hors du sandbox

Dans un terminal interactif, Manual et acceptEdits demandent normalement confirmation, auto utilise le classificateur et dontAsk refuse. Plan suit sa propre évaluation des commandes. Bypass ou un allow correspondant évite la confirmation, mais ask pour Bash(dangerouslyDisableSandbox:true), les restrictions de lecture hors de l'espace de travail ou d'autres contrôles peuvent avoir priorité. allowUnsandboxedCommands:false bloque les relances ; excludedCommands est distinct. failIfUnavailable empêche l'exécution sans isolation si le sandbox est indisponible. Consultez aussi les exceptions officielles.

Par défaut, le mode permissions normales s'applique (à partir de v2.1.324). Avec le sandbox activé seul, les commandes isolées demandent toujours confirmation. Jusqu'à v2.1.323, l'auto-autorisation était le réglage par défaut. Pour réduire les confirmations, choisissez l'auto-autorisation dans l'onglet Mode, ou ajoutez sandbox.autoAllowBashIfSandboxed: true dans settings.json (liste officielle des réglages). Les organisations qui imposent le sandbox placent la même valeur dans les réglages administrés de priorité la plus élevée.

5. Le configurer dans settings.json

Les choix faits dans le panneau /sandbox sont écrits dans le .claude/settings.local.json du projet (non versionné dans git). Pour le garder toujours actif sur tous les projets, placez sandbox.enabled: true dans vos réglages utilisateur à ~/.claude/settings.json. Pour réduire les confirmations, ajoutez aussi autoAllowBashIfSandboxed: true dans le même bloc sandbox (la valeur par défaut est false, soit le mode permissions normales). Il appartient à la même famille settings.json que les règles de permission (allow/ask/deny).

Ajouter des cibles d'écriture, refuser des lectures

Les écritures par défaut concernent le répertoire de travail, les répertoires supplémentaires et le stockage temporaire par utilisateur. allowWrite ajoute des emplacements. denyRead limite la lecture des commandes isolées ; il ne bloque pas directement Read intégré ou MCP.

{
  "sandbox": {
    "enabled": true,
    "filesystem": {
      "allowWrite": ["~/.kube", "/tmp/build"],
      "denyRead": ["~/"],
      "allowRead": ["."]
    }
  }
}

L'exemple ci-dessus refuse les lectures de tout le répertoire personnel tout en autorisant le projet en cours (. se résout à la racine du projet lorsque la configuration réside dans les réglages du projet). Les chemins sont imposés au niveau de l'OS, donc ils s'appliquent également aux processus enfants comme npm et terraform.

Protéger les identifiants

Un piège important : la valeur par défaut pour les lectures est « largement autorisée », donc ~/.aws/credentials et ~/.ssh/ sont lisibles tels quels. Le réglage dédié sandbox.credentials (une fonctionnalité relativement récente) déclare les fichiers dont la lecture est à refuser et les variables d'environnement à supprimer.

{
  "sandbox": {
    "enabled": true,
    "credentials": {
      "files": [
        { "path": "~/.aws/credentials", "mode": "deny" },
        { "path": "~/.ssh", "mode": "deny" }
      ],
      "envVars": [
        { "name": "GITHUB_TOKEN", "mode": "deny" }
      ]
    }
  }
}

Autoriser des destinations

La liste de domaines permis commence vide ; allowedDomains, règles de domaine WebFetch et autres réglages la complètent. Selon le mode, une destination inconnue peut demander confirmation, être refusée ou autorisée sans confirmation. Pour imposer une frontière, vérifiez aussi strictAllowlist et allowManagedDomainsOnly administré.

{
  "sandbox": {
    "enabled": true,
    "network": {
      "allowedDomains": ["*.github.com", "registry.npmjs.org"]
    }
  }
}

Pour l'imposer à l'organisation. Dans les réglages administrés, sandbox.enabled: true, failIfUnavailable: true (refuse de démarrer si le sandbox ne s'initialise pas) et allowUnsandboxedCommands: false (ferme la relance hors sandbox) restreignent l'exécution sans isolation quand il est indisponible et les relances extérieures. Mais excludedCommands, outils de fichiers intégrés, MCP et autres voies restent distincts ; ces réglages seuls ne garantissent pas l'isolation de toute opération.

6. Relation avec les modes et règles de permission

Ils sont faciles à confondre, mais les mécanismes de sécurité de Claude Code comportent trois couches aux rôles distincts. Le bac à sable est l'une d'elles — il ne remplace pas les deux autres ; il les complète.

Couche Ce qu'elle contrôle Imposée par Portée
Règles de permission Quels outils/commandes peuvent être utilisés Claude Code (avant l'exécution) Tous les outils
Modes de permission Combien de demandes apparaissent Claude Code (avant l'exécution) Dépend du mode
Bac à sable Ce qu'elle peut toucher une fois lancée L'OS (le noyau) Commandes shell et processus enfants

Les règles évaluent les appels d'outils avant exécution ; le sandbox restreint les accès fichiers et réseau des processus à l'intérieur. Cela ne dépend pas des variantes d'écriture des commandes. Mais outils extérieurs, commandes exclues, relances extérieures et permissions larges laissent des voies sans cette même frontière.

Bypass évite confirmations et classificateur ; le sandbox limite le périmètre d'exécution. Leurs rôles diffèrent. Même combiné au sandbox, bypass peut autoriser des hôtes inconnus et relances extérieures sans confirmation dans certains cas. Ne supposez pas votre machine quotidienne sûre ; vérifiez ensemble périmètre permis, exceptions et identifiants.

7. Limites et mises en garde — ne lui faites pas trop confiance

Le bac à sable est puissant, mais ce n'est pas un isolement complet. Avant de vous appuyer dessus comme sur une limite de sécurité stricte, connaissez les limites que la documentation détaille.

🔓 Le TLS n'est pas inspecté par défaut

Le proxy juge sur le seul nom d'hôte et n'inspecte pas le contenu chiffré (par défaut). Autoriser un domaine large comme github.com laisse la place à l'exfiltration de données via le domain fronting et autres techniques. Gardez la liste d'autorisation étroite.

🔌 Ouvrir des sockets Unix est risqué

Autoriser /var/run/docker.sock livre tout l'hôte via le socket Docker — en pratique une évasion du bac à sable. Faites attention aux sockets que vous ouvrez.

📈 Accès en écriture trop large

Des exécutables inscriptibles sur le $PATH ou des fichiers comme .bashrc peuvent se transformer en exécution de code dans un autre contexte. Gardez allowWrite minimal.

Read/Edit/Write intégrés, WebFetch/WebSearch, MCP, hooks, LSP et commandes auxiliaires fonctionnent hors du sandbox intégré. Pour restreindre le processus entier, envisagez conteneur, VM ou sandbox-runtime. Montages, réseau, sockets et identifiants autorisés comptent aussi.

8. Quand recourir aux dev containers ou aux VM

Le bac à sable n'est pas la seule option d'isolement de Claude Code. La commodité et la force de l'isolement s'opposent, alors choisissez selon l'objectif.

Bac à sable (intégré)

Isole les commandes shell et leurs enfants. Sans Docker, préparation minimale. Avec le mode auto-autorisation, une option majeure pour réduire les demandes au quotidien.

sandbox-runtime

Enveloppe Claude Code et les processus enfants locaux qu'il lance. Isoler un serveur MCP distant lui-même est distinct. Sans Docker.

dev container

Conteneurise tout l'environnement de développement. Pour standardiser la configuration d'une équipe. Nécessite Docker.

VM (machine virtuelle)

Sépare l'OS entier via un système invité. Dossiers partagés, réseau et identifiants exigent une configuration soignée. Pour du code non fiable, avec le plus d'efforts de préparation.

La règle empirique : gardez le bac à sable intégré toujours actif et passez en mode auto-autorisation pour réduire les demandes quotidiennes, et ne montez d'un cran vers sandbox-runtime, les conteneurs ou les VM que lorsque vous exécutez sans surveillance ou manipulez des dépendances non fiables. Pour un travail qui touche à la production — comme laisser l'IA piloter le cloud — associer des identifiants à moindre privilège à un palier d'isolement plus fort apporte de la tranquillité d'esprit.

Résumé

  • Le bac à sable délimite « ce qui peut être touché » au niveau de l'OS, dissolvant le binaire entre fatigue des demandes et contournement total.
  • Utilisez l'isolement du système de fichiers et l'isolement réseau ensemble. Imposition : macOS = Seatbelt, Linux/WSL2 = bubblewrap.
  • Commencez avec /sandbox. macOS fonctionne d'emblée ; Linux/WSL2 nécessite bubblewrap+socat ; Windows natif n'est pas pris en charge (utilisez WSL2).
  • Le mode par défaut est le mode permissions normales (à partir de v2.1.324). Pour réduire les confirmations, choisissez le mode auto-autorisation : même sans confirmation, modifications et transmissions dans les zones permises restent possibles. Deny, rm dangereux et ask sur le contenu subsistent.
  • Une couche complémentaire au rôle distinct des règles et modes. L'OS restreint l'accès pendant l'exécution. Les voies hors sandbox sont distinctes.
  • Ce n'est pas un mur complet : attention au TLS non inspecté, sockets Unix et permissions trop larges. Il couvre les shells isolés et leurs enfants.

Pour réduire les confirmations, vérifiez d'abord le périmètre permis et les voies extérieures. Pour la configuration exacte actuelle, utilisez les documents officiels du sandbox comme source primaire.

FAQ

Q. En quoi le bac à sable diffère-t-il de --dangerously-skip-permissions ?

R. Bypass évite confirmations et classificateur. Le sandbox limite la portée des shells isolés et leurs enfants. Outils de fichiers intégrés et MCP sont extérieurs ; modifications et transmissions permises restent possibles. La combinaison peut aussi autoriser des hôtes inconnus ou relances extérieures sans confirmation ; elle ne sécurise pas toute la machine.

Q. Puis-je l'utiliser sous Windows ?

R. Windows natif n'est pas pris en charge ; utilisez WSL2. Les restrictions d'accès aux binaires Windows dépendent de seccomp et des réglages de sockets Unix : ils ne sont pas systématiquement impossibles à lancer. excludedCommands s'exécute hors sandbox ; vérifiez son impact séparément.

Q. L'activer va-t-il ralentir les choses ?

R. Cet examen n'a établi aucune mesure de performance applicable partout. Moins de confirmations et des commandes plus rapides sont distincts. Comparez le même build ou test en notant durée, approbations et échecs.

Q. Avec le bac à sable activé, mes clés privées sont-elles garanties en sécurité ?

R. Aucune garantie absolue. Les lectures sont largement permises par défaut, donc ~/.ssh et ~/.aws/credentials sont lisibles par défaut. Limitez la lecture des shells isolés avec sandbox.credentials ou denyRead et gardez une liste réseau étroite. Read intégré et MCP exigent des contrôles séparés. filesystem.disabled:true désactive l'effet de denyRead et des refus de fichiers d'identifiants. Isolation des fichiers et réseau doivent fonctionner ensemble.

Q. Les serveurs MCP et les hooks sont-ils aussi en bac à sable ?

R. Le sandbox intégré couvre Bash, PowerShell et Monitor et leurs enfants. MCP, hooks et Read/Edit/Write intégrés sont extérieurs. Si vous envisagez sandbox-runtime, conteneurs ou VM pour envelopper tout le processus, vérifiez séparément réseau, montages et identifiants autorisés dans cet environnement.

Pour une analyse et des conseils sans modifications, consultez comment limiter Codex et Claude Code à l'analyse. Le sandbox permet les écritures dans l'espace de travail par défaut ; distinguez-le de la lecture seule.

Le périmètre et les exceptions des permissions et de l'isolation ont été revérifiés dans les sources officielles le 9 octobre 2026. Aucun réglage de l'appareil n'a été modifié et aucun essai de démarrage effectué.