Sandbox dla komend Bash
Sandbox uruchamia polecenia powłoki wewnątrz granicy izolacji, a procesy rozpoczęte przez te polecenia również pozostają w tej granicy. Domyślnie jest wyłączony; możesz go włączyć poleceniem /sandbox w sesji albo ustawieniem sandbox.enabled na true. Nie zastępuje trybu uprawnień: ogranicza dostęp polecenia Bash po uruchomieniu, natomiast tryb uprawnień decyduje, czy wywołanie narzędzia zostanie wykonane i czy pojawi się monit.
Po uruchomieniu /sandbox wybierz kartę Mode, aby zdecydować, czy polecenia w piaskownicy mają być zatwierdzane automatycznie, czy nadal mają wymagać standardowych monitów. Karta Overrides określa, czy polecenia, które nie działają w piaskownicy, mogą zostać ponowione poza nią. Karta Config pokazuje rozwiązane ustawienia piaskownicy, a na Linuksie może pojawić się też karta Dependencies, gdy brakuje opcjonalnego filtra seccomp.
Następnie poproś Claude o uruchomienie polecenia, na przykład kompilacji lub testów; domyślnie polecenia w piaskownicy mogą zapisywać w katalogu roboczym, katalogu tymczasowym użytkownika i dodanych katalogach. Przy pierwszej próbie użycia nowej domeny sieciowej Claude Code prosi o zgodę, a w trybie auto podaje wymagane hosty w samym poleceniu do sprawdzenia przez klasyfikator. W trybie auto-allow polecenia Bash są zatwierdzane dlatego, że ogranicza je granica piaskownicy; tryb auto niezależnie używa klasyfikatora do oceny działań.
Ważna pułapka: jeśli piaskownica nie może wystartować z powodu brakującej zależności lub nieobsługiwanej platformy, Claude Code domyślnie uruchamia polecenia bez izolacji. Aby wyłączyć ponawianie poleceń poza piaskownicą, ustaw allowUnsandboxedCommands na false; wtedy polecenia Claude są izolowane, chyba że pasują do wpisu excludedCommands. Polecenia wpisywane samodzielnie przy monicie trybu powłoki ! działają poza piaskownicą, z wyjątkiem opisanych w ustawieniach sesji działających w tle lub sesji Linuksa z CLAUDE_CODE_SUBPROCESS_ENV_SCRUB.
/sandbox
/sandbox.sudo apt-get install bubblewrap socat /sandbox
Zastosowanie w praktyce
Użyj /sandbox, gdy chcesz ograniczyć dostęp poleceń Bash bez zmiany tego, czy narzędzie wymaga zatwierdzenia przez tryb uprawnień. Wybierz auto-allow, jeśli polecenia mają działać bez monitów w granicy piaskownicy, albo regular permissions, jeśli chcesz zachować standardowe monity. Przy budowaniu projektu lub uruchamianiu testów sprawdź, czy wymagane katalogi zapisu i domeny sieciowe są dozwolone. W środowisku, które wymaga obowiązkowej izolacji, ustaw sandbox.failIfUnavailable na true, aby Claude Code kończył działanie przy starcie zamiast uruchamiać polecenia bez piaskownicy.
/sandbox pokaże tylko kartę Dependencies, brakuje wymaganej zależności; zainstaluj ją, uruchom ponownie Claude Code i ponownie otwórz panel. Nie traktuj wpisania polecenia przy monicie ! jako testu piaskownicy, bo zwykle działa ono poza nią.