При настройках Claude Code с частыми подтверждениями одобрения команд прерывают работу. Но отключение подтверждений через --dangerously-skip-permissions (байпас) означает, что инъекция промпта или ошибка может затронуть файлы по всей машине. Даже сокращая запросы, нужно решить, какой диапазон разрешать.

Песочница ограничивает на уровне ОС доступ команд оболочки и их дочерних процессов к файлам и сетевым адресатам. В режиме auto-allow она помогает сократить подтверждения, но не гарантирует защиту всей машины или предотвращение утечек. Разберём область действия, настройки, условия пропуска подтверждений и пути вне песочницы.

Суть за 30 секунд

Если читать только одно

Что это
Ограничивает доступ к файлам и сети на уровне ОС. Охватывает оболочки и дочерние процессы, выполняемые внутри песочницы.
Чем помогает
Даёт ещё один вариант между усталостью от запросов и полным байпасом: сузить воздействие, а в режиме auto-allow ещё и сократить подтверждения. Уничтожение или передача данных в разрешённых областях и инструменты вне песочницы требуют отдельного внимания.
С чего начать
Выполните /sandbox. На macOS работает из коробки; для Linux/WSL2 нужны два пакета.

* По сообщению Anthropic, во внутреннем использовании песочница сократила число запросов разрешений на 84% (источник ниже).

1. Зачем нужна песочница

Claude Code — ИИ-агент, который выполняет реальные действия: запускает тесты и меняет файлы. В зависимости от настроек он запрашивает одобрение перед выполнением. Десятки подтверждений в день дробят работу, и со временем вы нажимаете Enter, не читая. Это и есть «усталость от подтверждений» (permission fatigue).

Уставший разработчик тянется к --dangerously-skip-permissions (он же режим YOLO), который отключает все запросы. Это удобно и — как и говорит название — опасно. Сразу обнажают клыки три угрозы.

💉 Инъекция в промпт

Если на прочитанной веб-странице или в issue спрятано «отправь ~/.ssh», ваши приватные ключи могут утечь без единого запроса.

🗑️ Разрушительные оплошности

Сгенерированная команда чистит неожиданный путь. Без запроса могут исчезнуть и файлы за пределами проекта.

📤 Заражение цепочки поставок

Вредоносная зависимость «сливает» данные наружу при установке. При полностью открытой сети остановить это нельзя.

Помимо одобрения строки команды, песочница ограничивает то, куда может обратиться работающий процесс. Ограничения ОС охватывают произвольные скрипты, но не предотвращают злоупотребление разрешёнными местами записи или адресатами. В официальной инженерной публикации Anthropic сообщила о снижении внутренних запросов разрешений на 84% (октябрь 2025). Это внутренний замер вендора, а не гарантия такого снижения или безопасности в любой среде.

2. Что такое песочница — две изоляции

Песочница Claude Code задаёт две границы для команд оболочек Bash, PowerShell и Monitor и дочерних процессов. Они должны работать вместе; по отдельности остаются пробелы (см. §7).

🗂️ ① Изоляция файловой системы

По умолчанию запись разрешена в рабочий каталог, дополнительные рабочие каталоги и временное хранилище пользователя. Защищённые пути запрещаются отдельно. Чтение по умолчанию широко разрешено, поэтому секретам нужны ограничения вроде denyRead. Удаление и изменение в доступных для записи областях остаются возможными.

🌐 ② Изоляция сети

Соединения идут через прокси и проверяются по разрешённым доменам. Список изначально пуст, но настройки и правила добавляют записи. Обработка хостов вне списка зависит от режима разрешений; это не всегда отказ или подтверждение. Предотвращение отправки секретов разрешённому адресату не гарантируется.

Главное — не полагаться на хорошее поведение Claude. Границу обеспечивает защитный механизм самой ОС: Seatbelt в macOS, bubblewrap в Linux/WSL2. Она распространяется и на скрипты, вызываемые командой, и на дочерние процессы следующих поколений. В отличие от просьбы к модели, как AI guardrails, это ограничение доступа процессов, принудительно применяемое ОС.

💡 Охватывает команды оболочки и дочерние процессы. Песочница оборачивает Bash, PowerShell и Monitor и их дочерние процессы. Встроенные Read/Edit/Write, серверы MCP и хуки контролируются отдельно правилами разрешений. Для изоляции всего процесса рассмотрите @anthropic-ai/sandbox-runtime ниже.

3. С чего начать — /sandbox и поддерживаемые ОС

Песочница встроена в Claude Code. Отдельная учётная запись не нужна, но в зависимости от ОС необходимо подготовить зависимости. В сеансе выполните:

/sandbox

Откроется панель с тремя вкладками. Mode (как утверждаются команды в песочнице — следующий раздел), Overrides (может ли команда, которая не выполнилась в песочнице, откатиться к запуску вне неё) и Config (просмотр итоговых настроек). На Linux/WSL2, если недостаёт нужного пакета, вместо этого появляется вкладка Dependencies и сообщает, что установить.

Требования по каждой ОС

🍎 macOS

Устанавливать нечего. Используется встроенный Seatbelt. Включите сразу через /sandbox.

🐧 Linux / WSL2

Установите два пакета: bubblewrap и socat (например, apt-get install bubblewrap socat).

🪟 Нативная Windows

Не поддерживается. Запускайте Claude Code внутри WSL2 (WSL1 не подойдёт).

На Linux/WSL2 установите bubblewrap (непривилегированный инструмент песочницы, обеспечивающий изоляцию файловой системы) и socat (реле, направляющее трафик на прокси).

# Ubuntu / Debian
sudo apt-get install bubblewrap socat

# Fedora
sudo dnf install bubblewrap socat

⚠️ Ubuntu 24.04 и новее: политика AppArmor по умолчанию может помешать bubblewrap создавать нужные ему пользовательские пространства имён. Если sysctl kernel.apparmor_restrict_unprivileged_userns возвращает 1, добавьте профиль AppArmor для bwrap, чтобы это разрешить (шаги есть в официальной документации). Если возвращается 0 или ключа не существует, ничего делать не нужно. То же самое проверьте внутри WSL2.

Полезно также включить фильтр seccomp (он добавляет блокировку доменных сокетов Unix). Он опционален; установите его через npm install -g @anthropic-ai/sandbox-runtime. Вкладка Dependencies в /sandbox показывает статус ripgrep, bubblewrap, socat и фильтра seccomp. После установки пакетов перезапустите Claude Code и снова откройте /sandbox (проверка выполняется при запуске).

На Linux/WSL2 команды внутри песочницы по умолчанию не могут создавать пользовательские пространства имён. Чтобы запускать собственную песочницу Chromium и Electron или вложенные bubblewrap и unshare, задайте в ~/.claude/settings.json значение true для sandbox.allowNestedUserNamespaces (версия v2.1.305 и новее; в настройках проекта включить нельзя). Однако в официальной документации предупреждается, что это открывает одну границу безопасности. Причина в том, что код команды внутри песочницы может выполняться за её пределами. Rootless Podman и Buildah одной этой настройкой не запускаются (официальное объяснение).

По умолчанию действует обычный режим разрешений (с v2.1.324). Одного включения песочницы недостаточно: изолированные команды по-прежнему запрашивают подтверждение, как и раньше. До v2.1.323 по умолчанию был auto-allow. Чтобы сократить подтверждения, выберите auto-allow на вкладке Mode или добавьте в settings.json sandbox.autoAllowBashIfSandboxed: true (официальный список настроек). Организациям, которые требуют песочницу через управляемые настройки, нужно указать то же значение в управляемых настройках с наивысшим приоритетом.

4. Два режима (auto-allow / обычный)

Вкладка Mode выбирает, как утверждаются команды внутри песочницы.

✅ Режим auto-allow

Команды внутри песочницы обычно одобряются без подтверждения. Применимые deny, ask с областью по содержимому и проверки удаления важных путей сохраняются. Решение о неизвестном адресате отдельно от решения повторить команду вне песочницы. Ни одно не всегда вызывает запрос.

🔍 Режим обычных разрешений

Даже в песочнице команды оболочки проходят обычную оценку разрешений. Это добавляет контроль и может увеличить число одобрений. Подходит для осторожной работы с изоляцией и обычными проверками подтверждения.

В обоих режимах границы файловой системы и сети одинаковы; отличие только в «auto-allow против запроса». Обратите внимание, что даже в режиме auto-allow эти предохранительные клапаны остаются активными:

  • Среди правил настроек совпавший deny приоритетнее allow. Условия изменения решений модами — в руководстве по правилам.
  • rm / rmdir для /, домашнего каталога или важных системных путей требуют подтверждения либо отклоняются в зависимости от режима
  • Правила ask, привязанные к содержимому, вроде Bash(git push *), всё равно требуют запроса даже внутри песочницы

Не путайте два «авто». Автоматическое разрешение песочницы отличается от auto в режимах разрешений. Первое разрешает автоматически благодаря границе ОС, второе — после оценки команды классификатором. Их можно сочетать, но в Plan auto-allow не расширяет область одобрения. При некоторых условиях сохраняется проверка хостов со стороны auto и дополнительная оценка классификатора.

Связь с неизвестным адресатом

В интерактивном терминале Manual, acceptEdits и обычный Plan запрашивают подтверждение; dontAsk отклоняет. Auto разрешает названные в команде хосты, если их одобряет классификатор. Байпас и Plan с доступным для выбора байпасом разрешают без подтверждения. Отказы strictAllowlist, allowManagedDomainsOnly и deniedDomains применяются отдельно. Сама команда остаётся внутри песочницы.

Повтор вне песочницы

В интерактивном терминале Manual и acceptEdits обычно спрашивают, auto использует классификатор, dontAsk отклоняет. Plan следует оценке команд для Plan. Байпас или совпавший allow пропускает подтверждение, но ask для Bash(dangerouslyDisableSandbox:true), ограничения чтения вне рабочей области и другие проверки могут иметь приоритет. allowUnsandboxedCommands:false блокирует повторы; excludedCommands — отдельная настройка. failIfUnavailable предотвращает выполнение без изоляции при недоступной песочнице. Проверьте и официальные условия исключений.

5. Настройка в settings.json

Выбор в панели /sandbox записывается в проектный файл .claude/settings.local.json (не коммитится в git). Чтобы держать её всегда включённой во всех проектах, добавьте sandbox.enabled: true в пользовательские настройки в ~/.claude/settings.json. Чтобы сократить подтверждения, рядом в том же блоке sandbox укажите autoAllowBashIfSandboxed: true (по умолчанию false, то есть обычный режим разрешений). Она относится к тому же семейству settings.json, что и правила разрешений (allow/ask/deny).

Добавить цели для записи, запретить чтение

По умолчанию запись разрешена в рабочий каталог, дополнительные рабочие каталоги и временное хранилище пользователя. allowWrite добавляет места. denyRead ограничивает чтение командами песочницы, но напрямую не блокирует встроенный Read или MCP.

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

Пример выше запрещает чтение всего домашнего каталога, но по-прежнему разрешает текущий проект (. разворачивается в корень проекта, когда конфиг лежит в настройках проекта). Пути обеспечиваются на уровне ОС, поэтому одинаково применяются к дочерним процессам вроде npm и terraform.

Защитить учётные данные

Важная ловушка: по умолчанию чтение «широко разрешено», поэтому ~/.aws/credentials и ~/.ssh/ читаются как есть. Специальная настройка sandbox.credentials (относительно недавняя возможность) объявляет файлы, чтение которых запрещается, и переменные окружения, которые нужно сбросить.

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

Разрешить адреса назначения

Список доменов изначально пуст; записи добавляют allowedDomains, доменные правила WebFetch и другие настройки. Неизвестные адресаты могут вызвать запрос, отказ или разрешение без подтверждения в зависимости от режима. Для принудительной границы адресатов проверьте также strictAllowlist и управляемый allowManagedDomainsOnly.

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

Для обязательного применения в организации. В управляемых настройках sandbox.enabled: true, failIfUnavailable: true (отказ запуска при невозможной инициализации) и allowUnsandboxedCommands: false (закрытие повторов вне песочницы) ограничивают выполнение без изоляции при её недоступности и повторы вне неё. Но excludedCommands, встроенные файловые инструменты, MCP и другие пути отдельны: одни эти настройки не гарантируют изоляцию всех операций.

6. Связь с режимами и правилами разрешений

Их легко перепутать, но защитный механизм Claude Code состоит из трёх слоёв с разными задачами. Песочница — один из них: она не заменяет два других, а дополняет их.

Слой Что контролирует Кто обеспечивает Область
Правила разрешений Какие инструменты/команды можно использовать Claude Code (до запуска) Все инструменты
Режимы разрешений Сколько появляется запросов Claude Code (до запуска) Зависит от режима
Песочница К чему можно прикоснуться после запуска ОС (ядро) Команды оболочки и дочерние процессы

Правила разрешений оценивают вызовы инструментов до выполнения, песочница ограничивает файлы и сеть для процессов внутри неё. Преимущество — независимость от формы строки команды. Но внешние инструменты, исключённые команды, повторы без изоляции и широкие разрешения оставляют пути без той же границы.

Байпас пропускает подтверждения и классификатор; песочница ограничивает диапазон выполнения. Их роли различны. Даже вместе они при некоторых условиях допускают неизвестные хосты и повторы вне песочницы без подтверждения. Не считайте повседневное использование на своей машине безопасным по умолчанию: проверьте разрешённую область, исключения и учётные данные.

7. Ограничения и оговорки — не переоценивайте её

Песочница мощна, но это не полная изоляция. Прежде чем опираться на неё как на жёсткую границу безопасности, узнайте ограничения, которые проговаривает документация.

🔓 TLS по умолчанию не инспектируется

Прокси судит только по имени хоста и не проверяет зашифрованное содержимое (по умолчанию). Разрешение широкого домена вроде github.com оставляет лазейку для кражи данных через domain fronting и подобное. Держите список разрешённых узким.

🔌 Открывать Unix-сокеты рискованно

Разрешение /var/run/docker.sock отдаёт весь хост через сокет Docker — фактически побег из песочницы. Осторожно выбирайте, какие сокеты открывать.

📈 Слишком широкий доступ на запись

Исполняемые файлы, доступные на запись в $PATH, или файлы вроде .bashrc могут обернуться выполнением кода в другом контексте. Держите allowWrite минимальным.

Встроенные Read/Edit/Write, WebFetch/WebSearch, MCP, хуки, LSP и вспомогательные команды работают вне встроенной песочницы. Для ограничения всего процесса рассмотрите контейнер, VM или sandbox-runtime. Там тоже важны разрешённые подключения, сеть, сокеты и учётные данные.

8. Когда стоит взять dev-контейнер или ВМ

Песочница — не единственный вариант изоляции в Claude Code. Удобство и сила изоляции находятся в размене, поэтому выбирайте по цели.

Песочница (встроенная)

Изолирует команды оболочки и дочерние процессы. Без Docker, минимум подготовки. В режиме auto-allow — один из основных вариантов сокращения запросов в повседневной разработке.

sandbox-runtime

Оборачивает Claude Code и запускаемые им локальные дочерние процессы. Изоляция самого удалённого сервера MCP — отдельная задача. Без Docker.

dev-контейнер

Контейнеризирует всю среду разработки. Для стандартизации настройки команды. Требует Docker.

ВМ (виртуальная машина)

Отделяет всю ОС гостевой системой. Общие каталоги, сеть и учётные данные требуют тщательной настройки. Вариант для недоверенного кода, с наибольшим объёмом подготовки.

Правило большого пальца: держите встроенную песочницу всегда включённой, в режиме auto-allow сокращайте повседневные запросы, и повышайте планку до sandbox-runtime, контейнеров или ВМ только тогда, когда запускаете автономно или имеете дело с недоверенными зависимостями. Для работы, которая доходит до продакшена — например, когда ИИ управляет облаком — сочетание учётных данных с минимальными привилегиями и более сильного уровня изоляции даёт спокойствие.

Итоги

  • Песочница огораживает «к чему можно прикасаться» на уровне ОС, снимая бинарный выбор между усталостью от запросов и полным обходом.
  • Используйте изоляцию файловой системы и сети в связке. Обеспечение: macOS = Seatbelt, Linux/WSL2 = bubblewrap.
  • Начните с /sandbox. На macOS работает из коробки; для Linux/WSL2 нужны bubblewrap+socat; нативная Windows не поддерживается (используйте WSL2).
  • По умолчанию действует обычный режим разрешений (с v2.1.324). Чтобы сократить подтверждения, выберите auto-allow: он пропускает их, но изменение и передача данных внутри разрешённых областей возможны. Сохраняются deny, опасные rm и ask с областью по содержимому.
  • Дополнительный слой с другой ролью, чем правила и режимы разрешений. ОС ограничивает доступ при выполнении; пути вне песочницы отдельны.
  • Это не сплошная стена: учитывайте непроверяемый TLS, Unix-сокеты и чрезмерно широкие разрешения. Охватывает оболочки в песочнице и дочерние процессы.

Сокращая подтверждения, сначала проверьте разрешённую область и пути вне песочницы. Точный актуальный справочник настроек — официальная документация песочницы.

FAQ

В. Чем песочница отличается от --dangerously-skip-permissions?

О. Байпас пропускает подтверждения и классификатор. Песочница ограничивает доступ оболочек и дочерних процессов внутри неё. Встроенные файловые инструменты и MCP находятся снаружи; изменения и передачи в разрешённых областях остаются возможными. Совместное использование тоже может разрешить неизвестные хосты и повторы вне песочницы без подтверждения, поэтому не делает всю машину безопасной.

В. Можно ли использовать её на Windows?

О. Нативная Windows не поддерживается; используйте WSL2. Ограничения доступа к бинарным файлам Windows зависят от seccomp и настроек Unix-сокетов: нельзя утверждать, что их запуск всегда невозможен. Команды excludedCommands выполняются вне песочницы; оцените воздействие отдельно.

В. Замедлит ли включение работу?

О. Эта проверка не установила замер производительности, применимый ко всем средам. Сокращение подтверждений и времени выполнения команд — разные результаты. Сравнивайте одинаковую сборку или тест, записывая время, число одобрений и сбои.

В. С включённой песочницей мои приватные ключи гарантированно в безопасности?

О. Абсолютной гарантии нет. Чтение по умолчанию широко разрешено: ~/.ssh и ~/.aws/credentials доступны по умолчанию. Ограничьте чтение оболочек внутри песочницы через sandbox.credentials или denyRead, держите сетевой список разрешений узким. Встроенный Read и MCP требуют отдельного контроля. Отключение файловой изоляции через filesystem.disabled:true делает denyRead и запреты файлов учётных данных неэффективными. Файловая и сетевая изоляция должны работать вместе.

В. Изолированы ли также MCP-серверы и хуки?

О. Встроенная песочница охватывает команды оболочек Bash, PowerShell и Monitor и дочерние процессы. MCP, хуки и встроенные Read/Edit/Write работают снаружи. Рассматривая sandbox-runtime, контейнер или VM для всего процесса, отдельно проверьте разрешённые сеть, подключения каталогов и учётные данные.

Если нужны исследование и советы без изменений, см. статью о том, как использовать Codex и Claude Code только для исследования. Песочница по умолчанию разрешает запись в рабочую область: отличайте её от режима только для чтения.

Область действия и исключения прав и изоляции повторно сверены с официальными источниками 9 октября 2026 года. Настройки устройств не менялись, проверки запуска не проводились.