Security

2026 Claude Code: может ли Agent изменить конфигурацию? Защита SBPL

2026 Claude Code: может ли Agent изменить конфигурацию? Защита SBPL

Файл .claude/settings.json изменён самим Agent, и после этого следующая сессия получила более широкие разрешения.

Победитель зависит от режима работы: для контролируемой личной задачи достаточно запретить запись и включить остановку при недоступной песочнице; для команды и автономного запуска политика должна находиться в защищённых managed settings, а высокорисковый Agent — работать внутри отдельного Mac. Именно так решается задача защиты конфигурации Claude Code, а не простым добавлением ещё одного правила в проектный JSON.

Эта статья предназначена разработчикам, которые хранят .claude/settings.json в репозитории и разрешают Claude Code изменять файлы. Она также нужна DevSecOps-инженерам и руководителям платформ, которым требуется сохранить командные ограничения при длительном или безнадзорном запуске терминального Agent на удалённом Mac.

Последнее обновление: 15 сентября 2026 года. Поля конфигурации и границы применения сверены с официальными материалами Claude Code, документацией Anthropic Sandbox Runtime и актуальным описанием macOS sandbox-exec.

Конфигурация Agent и политика находятся в одной зоне записи

Типичный сбой выглядит не как «песочница исчезла», а гораздо прозаичнее: рабочий каталог разрешён для записи, в нём лежит .claude/settings.json, а Agent получает задачу изменить код. Технически изменение файла настроек становится обычной операцией записи в разрешённую директорию.

Может ли Claude Code изменить собственный settings.json?

Да, если действующие разрешения позволяют инструментам Claude Code записывать в каталог, где находится этот файл. Это не означает, что текущая версия обязательно делает такую запись или что речь идёт о подтверждённой уязвимости. Это модель угроз: конфигурационный файл доступен тому же процессу и тем же инструментам, которые он должен ограничивать.

Здесь важно разделять четыре уровня:

  • встроенные инструменты Edit и Write меняют файлы через сам Claude Code;
  • Bash запускает команды и дочерние процессы;
  • официальный Bash Sandbox в первую очередь ограничивает Bash и его потомков;
  • внешняя политика macOS может ограничить весь процесс Claude Code, включая его собственные операции записи.

Документация по разрешениям Claude Code описывает deny-правила и области их действия, но наличие правила в проектном файле не делает сам файл неизменяемым. Приоритет «настройка применяется раньше другой» также не равен файловой защите.

Поэтому в threat model следует считать .claude, Hooks, Skills и связанные файлы частью поверхности атаки. Изменение hook может повлиять на последующие действия. Изменение skill — на инструкции следующего запуска. Даже если секреты лежат за пределами проекта, подмена разрешений способна ослабить будущую проверку.

Проектные настройки удобнее, но не являются последней линией

Проектный уровень подходит для совместной разработки. Команда может хранить там разрешённые команды, правила форматирования и поведение, которое должно воспроизводиться у разных участников. Локальные настройки удобны для эксперимента одного разработчика.

Но эти уровни нельзя использовать как единственный барьер в unattended-задаче:

  • файл проекта обычно находится в рабочей директории;
  • рабочая директория часто должна быть доступна для записи;
  • hooks и skills могут менять последующий контекст выполнения;
  • восстановление изменённого JSON не гарантирует, что Agent не успел выполнить команду до отката;
  • правила в одном файле не показывают итоговую политику после объединения нескольких источников.

Как запретить Claude Code записывать в каталог .claude?

Сначала каталог исключают из разрешённой области записи через denyWrite или эквивалентную настройку, затем проверяют фактически применённую конфигурацию. Важно запретить не только .claude/settings.json, но и весь каталог, если рядом находятся hooks, skills или дополнительные policy-файлы.

Бизнес-настройки, которые должны меняться вместе с репозиторием, можно оставить в проекте. Ограничения, определяющие саму границу безопасности, должны находиться вне области записи Agent. К ним относятся запрет выхода из песочницы, обязательная остановка при её недоступности и запрет запуска без изоляции.

Официальное описание конфигурации Claude Code следует использовать как справочник по поддерживаемым уровням и именам полей. Поля нельзя переносить между версиями по памяти: перед публикацией policy-файла нужно сверить текущую схему.

Быстрая проверка перед запуском

  1. Определить корень рабочей директории и все пути, откуда Claude Code читает настройки.
  2. Найти .claude, hooks, skills и локальные policy-файлы.
  3. Исключить эти пути из записи Agent.
  4. Убедиться, что разрешённые каталоги не содержат симлинк, ведущий к конфигурации.
  5. Отдельно проверить команды, которые могут менять права, перемещать файлы или создавать новые настройки.
  6. Сохранить вывод диагностики до начала автономной задачи.

Объединение настроек может незаметно расширить политику

При сравнении managed settings, пользовательских, проектных и локальных настроек нельзя смотреть только на один JSON. Официальная модель конфигурации назначает managed settings самый высокий приоритет, но итог зависит от того, как конкретные поля объединяются.

Это особенно важно для массивов. allowWrite может не вести себя как простая замена всего предыдущего списка. Если значения объединяются между областями, локальное разрешение способно добавить путь, который отсутствует в командном файле. Для защиты конфигурации это означает: «в managed-файле нет опасного пути» ещё не доказывает, что итоговая политика его не содержит.

Что безопаснее: managed settings или проектные настройки?

Для обязательной командной политики безопаснее managed settings, если файл действительно размещён в области, недоступной Agent для записи. Проектный уровень лучше для совместимых с репозиторием рабочих правил, но он остаётся частью окружения, которое задача может изменять.

Проверка должна проходить в самом Claude Code:

  • /status показывает активное состояние и применяемый контекст;
  • /permissions помогает увидеть разрешения, которые реально участвуют в запуске;
  • /doctor выявляет проблемы конфигурации и окружения.

Названия команд и их вывод нужно сверять с официальной диагностикой конфигурации, особенно после обновления Claude Code. Файл, который выглядит строгим при ручном чтении, не заменяет проверку итоговой политики.

Плюсы проектной настройки:

  • легко версионировать;
  • удобно обсуждать в pull request;
  • подходит для обычного контролируемого рабочего процесса.

Минусы:

  • Agent может иметь право её изменить;
  • локальный слой способен добавить разрешение;
  • восстановление из Git не предотвращает уже выполненную операцию.

Плюсы managed settings:

  • policy можно вынести за пределы репозитория;
  • командные ограничения не зависят от конкретной ветки;
  • проще централизованно проверять обязательные поля.

Минусы:

  • требуется отдельный канал доставки;
  • неверный путь или формат может остановить работу команды;
  • managed settings всё равно должны быть защищены правами операционной системы.

Недоступная песочница и продолжение работы — разные риски

Слово «sandbox» скрывает несколько разных сценариев. Нельзя считать, что отсутствие изменения policy-файла автоматически доказывает безопасное выполнение задачи.

Нужно разделять:

  1. Сбой инициализации. Runtime не смог создать нужную изоляцию. Причина может быть связана с окружением, правами или несовместимостью.
  2. Откат к обычному режиму. Команда продолжает выполняться с менее строгой защитой.
  3. Явный запуск без песочницы. Пользователь, скрипт или настройка разрешают выполнение вне sandbox.

Для критичной задачи предпочтителен fail-closed: если песочница недоступна, Agent останавливается. В официальной документации managed settings для этого предусмотрены failIfUnavailable и allowUnsandboxedCommands; актуальные значения и область действия этих полей необходимо проверять перед каждым изменением policy.

Важно: «конфигурационный файл не был изменён» — это только результат одной проверки. Для аудита нужно подтвердить и путь записи, и состояние Sandbox Runtime, и отсутствие разрешённого обхода.

Нельзя бездумно добавлять исключения ради удобства. Исключённая команда может стать выходом из модели защиты, если она запускает оболочку, меняет разрешения или обращается к внешнему процессу. В документации по sandboxing Claude Code следует отдельно сверять, что именно ограничивает официальный Bash Sandbox и какие операции остаются за его пределами.

Пошаговая проверка для запуска:

  1. Включить запрет записи в каталог policy и связанные каталоги.
  2. Установить остановку при недоступной песочнице.
  3. Убедиться, что выполнение без sandbox не разрешено политикой.
  4. Запустить безопасную тестовую задачу в фиктивном каталоге.
  5. Искусственно проверить отказ: временно сделать runtime недоступным в тестовой среде.
  6. Убедиться, что задача остановилась, а не продолжилась с обычными правами.
  7. Проверить /status, /permissions и /doctor.
  8. Только после этого подключать настоящий репозиторий.

SBPL защищает процесс шире, чем встроенная песочница Bash

SBPL — это язык профилей Sandbox Profile Language. Его принципиальное отличие от официального Bash Sandbox — точка применения. Bash Sandbox ориентирован на Bash и дочерние процессы. Профиль SBPL, применённый снаружи при запуске, может ограничить сам процесс Claude Code и его потомков.

Может ли SBPL ограничить запись всего процесса Claude Code?

Да, такой подход предназначен именно для более широкой границы: можно запретить запись в каталог с policy и рабочую область за пределами тестового дерева, оставив доступ только к временной директории и заранее созданному фиктивному файлу. Но это не превращает sandbox-exec в современный универсальный API.

Apple пометила sandbox-exec как deprecated. При этом актуальная справочная страница показывает, что команда всё ещё вызывается в поддерживаемых окружениях macOS. Эти утверждения нельзя смешивать: «работает сейчас» не означает «получает долгосрочную поддержку». Для описания синтаксиса полезны текущая справка sandbox-exec и справка macOS Sandbox.

Anthropic Sandbox Runtime также использует на macOS sandbox-exec и собственные профили; это подтверждается его официальным репозиторием. При обновлении Runtime реализацию нужно перепроверять: собственноручный SBPL и встроенный механизм Claude Code — разные слои.

Безопасный учебный профиль

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

(version 1)
(deny default)

(import "system.sb")

(allow process-exec
  (literal "/bin/sh")
  (literal "/bin/echo"))

(allow file-read*
  (subpath "/tmp/claude-sbpl-demo"))

(allow file-write*
  (literal "/tmp/claude-sbpl-demo/result.txt"))

(allow file-read-metadata
  (subpath "/tmp/claude-sbpl-demo"))

Профиль нужно сохранить вне каталога, доступного Agent, например в отдельном временном месте, затем запускать только тестовую команду:

mkdir -p /tmp/claude-sbpl-demo
printf 'test\n' > /tmp/claude-sbpl-demo/result.txt
sandbox-exec -f /secure/path/claude-demo.sb /bin/sh -c 'echo ok >> /tmp/claude-sbpl-demo/result.txt'

После этого следует проверить отрицательные сценарии:

sandbox-exec -f /secure/path/claude-demo.sb /bin/sh -c 'echo blocked >> /tmp/outside.txt'

Проверка считается успешной только при ожидаемом отказе в записи за пределами фиктивного пути. Этот пример не доказывает совместимость со всеми версиями macOS и не защищает реальный Claude Code автоматически. Для обратимости запуск лучше оформить отдельным alias или скриптом, который можно удалить без изменения проекта:

alias claude-locked='sandbox-exec -f "$HOME/.secure/claude-demo.sb" claude'

В рабочем окружении нужно отдельно разрешать нужные исполняемые файлы, домашний каталог, сокеты и сетевые операции. Чем больше исключений, тем слабее профиль. Если необходимы сложные системные разрешения, долгосрочной альтернативой становится отдельная виртуализированная среда на базе современных механизмов macOS, а не расширение устаревающего вызова до бесконечности.

Выбор среды зависит от того, кто восстанавливает policy

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

Вариант Где находится критичная политика Восстановление Когда выбирать Основной недостаток
Проектные настройки В репозитории Git и ручная проверка Контролируемая личная разработка Agent может иметь доступ к файлу
Managed settings В защищённом командном источнике Централизованная доставка Командные задачи и обязательные ограничения Нужна корректная доставка и системные права
SBPL вокруг процесса Вне рабочей директории Перезапуск с профилем Проверка всего процесса и его потомков sandbox-exec deprecated, профиль требует сопровождения
Отдельный Mac Policy и код разделены по среде Снимок, пересоздание или ручной recovery-процесс Длительный или автономный высокорисковый запуск Среду нужно администрировать отдельно

Для личной сессии, где разработчик подтверждает команды, проектная policy может оставаться рабочим вариантом. Но denyWrite для .claude и отказ при недоступной песочнице всё равно должны быть проверены.

Для команды managed settings становятся разумным минимумом. Проектный JSON при этом не исчезает: в нём остаются бизнес-правила, а обязательные границы выносятся выше и защищаются операционной системой.

Для unattended Agent лучше не полагаться на один SBPL-файл. Нужны отдельный Mac, независимый канал восстановления, журнал запуска и ограниченная область данных. При миграции следует заранее определить, какие файлы можно пересоздать, кто имеет доступ к консоли и как отключается задача при нарушении policy.

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

Слабое место текущего подхода — проектный JSON можно случайно включить в область записи, Sandbox Runtime может завершиться ошибкой, а sandbox-exec не является перспективным интерфейсом. В отдельной среде эти проблемы не исчезают, но становятся локальными: policy можно вынести из репозитория, Mac — пересоздать, а рабочие данные — отделить от постоянной инфраструктуры.

Если требуется длительная проверка Claude Code в изолированной среде, аренда Mac у ProxyMac может быть практичнее, чем попытка превратить общий ноутбук в постоянный стенд. При выборе следует сначала зафиксировать три параметра: где лежит policy, есть ли безнадзорный запуск и какие каталоги Agent разрешено изменять. После этого имеет смысл сравнить доступные варианты в условиях аренды Mac, а не покупать среду, если задача ограничена временной валидацией. Для постоянной тяжёлой нагрузки или обязательных физических интерфейсов отдельный собственный Mac всё ещё может быть честно лучшим решением.

Изолированная среда для Claude Code на отдельном Mac

ProxyMac предоставляет удалённый Mac для запуска Claude Code и других агентных задач отдельно от вашего основного компьютера.
Подключайтесь к macOS удалённо и контролируйте рабочее окружение, файлы и права выполнения.