`/sandbox` în Claude Code CLI

Configurare și Securitate Claude Code 2.1+

Pornește și configurează sandbox-ul care limitează fișierele și domeniile de rețea accesibile comenzilor shell rulate de Claude.

Sintaxă & invocare

/sandbox

Ce face `/sandbox`

Sandbox-ul este o limită impusă de sistemul de operare în jurul comenzilor shell pe care le rulează Claude (Bash, PowerShell, Monitor) și al proceselor pornite de ele. Implicit este oprit. Funcționează pe macOS, Linux și WSL2; pe Windows nativ comenzile rulează fără sandbox.

/sandbox deschide un panou cu trei tab-uri: Mode (auto-allow, în care comenzile din sandbox rulează fără confirmare, sau regular permissions, care păstrează cererile obișnuite), Overrides (dacă o comandă eșuată în sandbox poate fi reîncercată în afara lui, adică setarea allowUnsandboxedCommands) și Config (setările rezolvate). Pe Linux apare și tab-ul Dependencies când lipsesc pachete precum bubblewrap sau socat.

Alegerea se salvează în .claude/settings.local.json și se aplică proiectului curent; pentru toate proiectele setezi sandbox.enabled la true în ~/.claude/settings.json. Sandbox-ul acoperă doar comenzile shell: tool-urile Read, Edit, WebFetch, hook-urile și serverele MCP locale rulează în afara lui. Nu este un mod de permisiuni.

Sintaxă și opțiuni

Opțiune / Parametru	Descriere
`Mode`	Alegi între auto-allow și regular permissions.
`Overrides`	Permiți sau interzici reîncercarea comenzilor în afara sandbox-ului (`allowUnsandboxedCommands`).
`Config`	Afișează setările de sandbox rezolvate, inclusiv căile protejate.
`Dependencies`	Apare pe Linux când lipsește o dependență și arată ce trebuie instalat.

Exemple practice de terminal

Exemplul 1: Activarea sandbox-ului în proiectul curent

> /sandbox

Exemplul 2: O sesiune cu sandbox, fără reîncercări în afara lui

--settings schimbă sandbox-ul doar pentru această sesiune, fără să scrie în fișierele de setări.

claude --settings '{"sandbox": {"enabled": true, "allowUnsandboxedCommands": false}}'

Greșeli frecvente și bune practici

Testezi sandbox-ul tastând comanda cu !. Comenzile introduse de tine la promptul ! rulează de obicei în afara lui; cere-i lui Claude să ruleze testul.
Presupui că nimic nu rulează dacă sandbox-ul nu poate porni. Implicit, dacă lipsește o dependență sau platforma nu e suportată, Claude Code rulează comenzile fără sandbox; setează sandbox.failIfUnavailable la true ca să oprească pornirea.
Instalezi pe Linux pachetele lipsă și nu repornești Claude Code. Verificarea dependențelor rulează la pornire.

Ce face /sandbox