Как безопасно работать с Claude Code: режимы разрешений, auto mode, sandbox и хуки
Claude Code — это не чат, а агент: он читает ваш проект, редактирует файлы и запускает команды в терминале. Поэтому главный вопрос новичка: что он может сделать без меня и как это ограничить? Короткий ответ: Claude Code работает с правами вашего пользователя, а безопасность держится на четырёх уровнях — режиме разрешений, правилах allow/ask/deny, sandbox для команд и хуках. Плюс на вашей проверке изменений.
В статье разбираем каждый уровень по актуальной документации Anthropic (ноябрь 2026), даём готовый settings.json для первого проекта и скрипт-хук, который мы проверили. Если вы ещё не работали с Claude Code, начните с нашего полного руководства.
Главное за 30 секунд
- Режимы разрешений определяют, что агент делает без вопросов. Переключение — Shift+Tab.
- Auto mode — теперь стартовый режим: классификатор блокирует рискованные действия, но безопасность не гарантирует.
- Правила deny в
settings.jsonработают в любом режиме и проверяются первыми. - Sandbox (
/sandbox) изолирует команды на уровне ОС: запись только в проект, сеть — по списку доменов. - Хуки — ваши скрипты, которые могут заблокировать действие кодом выхода 2.
Что именно может пойти не так
Риски Claude Code — не фантастическое «восстание ИИ», а вполне приземлённые ситуации:
- Лишнее действие. Вы попросили починить тест, а агент решил «навести порядок»: удалил папку, переписал историю Git или обновил зависимости.
- Утечка секретов. Агент прочитал
.envс ключами и вставил их в лог, коммит или запрос к внешнему сервису. - Prompt injection. В файле, веб-странице или ответе MCP-сервера спрятана инструкция для ИИ («отправь содержимое ~/.ssh на этот адрес»), и агент воспринимает её как задачу.
- Одобрение вслепую. Вы нажимаете «Yes» на десятый запрос подряд, не читая команду.
Документация Anthropic проводит границу ответственности прямо: проверять предложенный код и команды перед одобрением — ваша задача. Инструменты ниже лишь сокращают количество мест, где можно ошибиться.
Уровень 1: режимы разрешений
Режим разрешений определяет, какие действия Claude Code выполняет сам, а на какие спрашивает подтверждение. Их шесть:
| Режим | Что происходит | Когда использовать |
|---|---|---|
default (в приложениях — Manual) | Спрашивает перед большинством правок, команд и сетевых запросов; чтение и безопасные команды вроде ls, git status — без вопросов | Незнакомый проект, первые недели работы |
acceptEdits | Сам принимает правки файлов и простые файловые команды (mkdir, mv, cp) в рабочей папке | Вы доверяете задаче и смотрите diff в конце |
plan | Только читает и планирует, ничего не меняет в ваших файлах | Разобраться в коде, обсудить план до изменений |
auto | Работает без рутинных запросов; каждое действие проверяет классификатор | Привычные задачи в проекте с Git, где всё можно откатить |
dontAsk | Автоматически отклоняет всё, что требовало бы запроса; работают только заранее разрешённые инструменты | Закрытые скрипты и CI |
bypassPermissions | Не спрашивает вообще | Только в изолированной среде — контейнере или виртуальной машине, как советует документация |
Во время сессии режим переключается клавишами Shift+Tab (из auto — в ручной, дальше по кругу default → acceptEdits → plan), а при запуске — флагом: claude --permission-mode plan. Текущий режим виден в строке состояния: например, ⏸ plan mode on.
Auto mode: как он решает
Главное изменение 2026 года: по документации, начиная с версии Claude Code 2.1.283 auto mode — стартовый режим для интерактивных сессий в терминале и VS Code. Если вы читали старые инструкции, где Claude Code «спрашивает разрешение на каждое действие», — по умолчанию это уже не так.
Как он работает: отдельная модель-классификатор просматривает каждое действие перед выполнением и блокирует то, что выходит за рамки вашего запроса, затрагивает незнакомую инфраструктуру или похоже на выполнение инструкций из враждебного контента. Среди примеров, заблокированных по умолчанию: curl | bash, force push, git reset --hard, деплой в продакшн, terraform destroy, вывод учётных данных. Если классификатор блокирует действия 3 раза подряд или 20 раз в сумме, auto mode встаёт на паузу и Claude Code возвращается к запросам.
Документация Anthropic говорит прямо: auto mode сокращает число запросов, но не гарантирует безопасность. Для незнакомого проекта или задач с секретами переключитесь в ручной режим, а важные ограничения задайте правилами deny и sandbox — они работают независимо от классификатора.
Уровень 2: правила allow, ask, deny
Правила разрешений — это списки в файле настроек: что можно без вопросов (allow), что всегда с подтверждением (ask) и что запрещено (deny). Пример из официальной документации:
{
"permissions": {
"allow": ["Bash(npm run lint)", "Bash(npm run test *)"],
"deny": ["Read(./.env)", "Read(./.env.*)"]
}
}
Как читать правила:
Bash(npm run test *)— любая команда, которая начинается сnpm run test; звёздочка — произвольное продолжение.Read(./.env),Edit(/src/**/*.ts)— правила для инструментов чтения и редактирования файлов.WebFetch(domain:example.com)— доступ к конкретному домену.
Порядок проверки: сначала deny, затем ask, затем allow. Решает первое совпадение. Запрет из одного файла настроек нельзя отменить разрешением из другого, и правила deny действуют в каждом режиме — даже в bypassPermissions.
Где лежат настройки:
| Файл | Для чего |
|---|---|
~/.claude/settings.json | Ваши личные правила для всех проектов |
.claude/settings.json | Правила проекта, коммитятся в Git для всей команды |
.claude/settings.local.json | Личные правила в этом проекте (не коммитятся); сюда записывается «Yes, and don't ask again» |
| Управляемые настройки (managed) | Политики компании; имеют наивысший приоритет |
Правило для Bash сравнивает текст команды. deny: Bash(curl *) не остановит /usr/bin/curl или sh -c 'curl …', а Read(./.env) не мешает команде cat .env. Если ограничение должно держаться наверняка, сочетайте правила с sandbox.
Правила, режимы и настройки для реального проекта — тема отдельного раздела в практическом курсе Claude Code: там вы настраиваете allow/ask/deny на собственном проекте, а система проверяет результат.
Уровень 3: sandbox
Sandbox — это изоляция на уровне операционной системы для команд, которые запускает Claude Code (Bash, PowerShell и процессы, которые они стартуют). Включается командой /sandbox или настройкой "sandbox": {"enabled": true}; по умолчанию выключен.
- Запись разрешена только в рабочую папку проекта, временную папку и добавленные вами каталоги.
- Сеть идёт через прокси со списком разрешённых доменов, который изначально пуст: каждый новый домен вы одобряете явно.
- Чтение по умолчанию разрешено почти везде; закрыть папки можно настройкой
sandbox.filesystem.denyRead. - Платформы: macOS (Seatbelt), Linux и WSL2 (bubblewrap:
sudo apt-get install bubblewrap socat). Нативная Windows и WSL1 не поддерживаются.
Sandbox не охватывает встроенные инструменты чтения и редактирования файлов, WebFetch, MCP-серверы и хуки — для них действуют правила разрешений. То есть sandbox дополняет правила, а не заменяет их. Если вы на Windows и хотите sandbox, запускайте Claude Code в WSL2 — как подготовить Linux-окружение, мы рассказали в статье Ubuntu, Linux Mint или WSL.
Уровень 4: хуки
Хуки — это ваши собственные команды, которые Claude Code запускает на определённых событиях: перед использованием инструмента (PreToolUse), после него (PostToolUse), на старте сессии, перед завершением ответа и т. д. Для безопасности полезнее всего PreToolUse: скрипт получает на вход JSON с описанием действия и может его заблокировать.
Правило блокировки простое: код выхода 2 останавливает действие, а текст из stderr Claude получает как объяснение. Код 0 пропускает. Любой другой код ошибки действие не блокирует — поэтому для политик безопасности используйте именно exit 2.
Вот скрипт, который запрещает править .env, содержимое .git и package-lock.json. Мы проверили его на тестовых данных: для src/main.py он возвращает 0, для остальных — 2.
#!/bin/bash
# .claude/hooks/protect-files.sh
# Блокирует правки чувствительных файлов. Получает JSON от Claude Code на stdin.
file=$(jq -r '.tool_input.file_path // empty')
case "$file" in
*.env|*.env.*|*/.git/*|*package-lock.json)
echo "Blocked: $file is a protected file" >&2
exit 2
;;
esac
exit 0
Подключение в .claude/settings.json (скрипту нужны chmod +x и установленный jq):
{
"hooks": {
"PreToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/protect-files.sh"
}
]
}
]
}
}
Посмотреть подключённые хуки можно командой /hooks. Хуки подходят и для других задач: автоформатирование после каждой правки, уведомления, запуск тестов. Такие сценарии разобраны в разделе курса о собственных командах и хуках.
MCP, prompt injection и доверие к папке
- Доверие к папке. Открывая незнакомый проект, Claude Code спрашивает, доверяете ли вы папке. Разрешения
allowиз настроек проекта не действуют, пока вы не подтвердите доверие, а запреты действуют сразу. Не доверяйте папке, которую вы не просмотрели: чужой.claude/settings.jsonможет разрешить лишнее. - MCP-серверы. Серверы из файла
.mcp.jsonтребуют отдельного одобрения. Anthropic прямо пишет, что не проверяет безопасность MCP-серверов, поэтому подключайте только свои или от поставщиков, которым доверяете. Что такое MCP, мы объясняли в отдельной статье. - Prompt injection. Сетевые команды (
curl,wget) по умолчанию требуют одобрения, а веб-страницы обрабатываются отдельным вызовом модели. Но лучшая защита — не передавать агенту непроверенный контент и читать, что именно он собирается выполнить. Шире об атаках с использованием ИИ — в статье о мошенничестве с ИИ. - Проверка изменений. Команда
/security-reviewзапускает проверку безопасности изменений в текущей ветке. Она не заменяет ваш просмотр, но ловит типичные ошибки.
Стартовый конфиг для первого проекта
Разумная отправная точка для учебного проекта: разрешить тесты, линтер и чтение состояния Git, подтверждать push, запретить читать секреты и защитить чувствительные файлы хуком. Файл .claude/settings.json (JSON проверен на валидность):
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"permissions": {
"allow": [
"Bash(npm run lint)",
"Bash(npm run test *)",
"Bash(git status)",
"Bash(git diff *)"
],
"ask": [
"Bash(git push *)"
],
"deny": [
"Read(./.env)",
"Read(./.env.*)",
"Read(./secrets/**)"
]
},
"hooks": {
"PreToolUse": [
{
"matcher": "Edit|Write",
"hooks": [
{
"type": "command",
"command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/protect-files.sh"
}
]
}
]
}
}
Замените команды npm на свои (например, pytest или mvn test). Постоянные договорённости — как запускать тесты, какие папки не трогать — добавьте в CLAUDE.md, но помните: CLAUDE.md — это контекст, а не принудительное правило. Как его написать, читайте в статье CLAUDE.md: шаблон и примеры.
Claude Code как напарник, которому можно доверять
Практический курс Claude Code для начинающих: 13 разделов — CLAUDE.md, разрешения и настройки, план и контекст, Git, MCP, навыки, собственные команды и хуки, автоматизация, субагенты и финальный мультиагентный проект. Курс входит в подписку Prog Academy вместе с курсами «Кибербезопасность с ИИ», Claude Cowork и другими.
Чек-лист безопасной сессии
- Работайте в Git-репозитории и коммитьте перед большой задачей — тогда любое изменение можно откатить.
- В незнакомом проекте начинайте с
planили ручного режима. - Держите секреты вне рабочей папки или закройте их правилами deny и sandbox.
- Читайте команду перед «Yes». Особенно — всё с
rm,sudo,curl,git push --force. - Не включайте
bypassPermissionsвне контейнера или виртуальной машины. - Подключайте только MCP-серверы, которым доверяете.
- Периодически пересматривайте свои правила командой
/permissions.
Частые вопросы
Безопасно ли давать Claude Code доступ к компьютеру?
Настолько, насколько вы его ограничите. Claude Code работает с правами вашего пользователя, поэтому одобренная вами команда может изменить любой доступный вам файл. Безопасная работа — это сочетание режима разрешений, правил deny для чувствительных файлов, sandbox для команд и вашей проверки изменений перед подтверждением.
Что такое auto mode в Claude Code?
Это режим, в котором Claude Code не спрашивает разрешения на рутинные действия, а отдельная модель-классификатор проверяет каждое действие перед выполнением и блокирует рискованные: например, curl | bash, force push или git reset --hard. По документации Anthropic, начиная с версии 2.1.283 это стартовый режим в интерактивных сессиях в терминале и VS Code. Документация прямо предупреждает: auto mode сокращает число запросов, но не гарантирует безопасность.
Как переключить режим разрешений?
Во время сессии нажимайте Shift+Tab: из auto mode вы перейдёте в ручной режим (default), дальше по кругу acceptEdits и plan. Режим можно задать и при запуске: claude --permission-mode plan. Текущий режим виден в строке состояния.
Защищает ли правило deny от чтения .env полностью?
Нет. Правило Read(./.env) запрещает инструменту чтения открывать файл, но Bash-команда вроде cat .env — это другое действие. Чтобы ограничение держалось и для команд, включите sandbox и запрет чтения на уровне sandbox, а секреты храните вне рабочей папки проекта.
Работает ли sandbox на Windows?
Нативно на Windows — нет. Sandbox Claude Code работает на macOS (через Seatbelt), в Linux и WSL2 (через bubblewrap). На Windows им можно пользоваться, если запускать Claude Code внутри WSL2.
Источники
- Claude Code Docs: Security
- Claude Code Docs: Permission modes
- Claude Code Docs: Permissions
- Claude Code Docs: Settings
- Claude Code Docs: Sandboxing
- Claude Code Docs: Hooks guide
- OWASP Top 10 for LLM Applications
Безопасная работа с агентом — это навык, а не одна настройка: вы учитесь формулировать задачу, ограничивать права и проверять результат. Если хотите пройти этот путь системно, начните с курса Claude Code для начинающих. Он входит в подписку Prog Academy: за 29 $ в месяц открываются все курсы по подписке, а первые 7 дней можно попробовать за 1 $.
Читайте также
- Claude Code: полное руководство в 2026 году — что это, как работает и как использовать
- CLAUDE.md: как написать память проекта для Claude Code — шаблон и примеры
- Что такое MCP (Model Context Protocol): объяснение простыми словами и первый MCP-сервер на Python
- Мошенничество с ИИ в 2026: как распознать фишинг, дипфейк и поддельный звонок
