Enterprise-бастион для кода: Claude работает над проектом без доступа к файлам и шеллу
Штатные инструменты файлов и шелла для агента — это ровно тот вектор утечки, который безопасность не согласует. Enterprise code bastion убирает их совсем (--tools "") и пропускает каждое действие через фильтрующий MCP-посредник, исполняющий команды в изолированном контейнере: Claude рассуждает и решает, но напрямую к коду, секретам и инфраструктуре не ходит.
Проблема
Крупная организация не может дать AI-инструменту неконтролируемый доступ к исходному коду, секретам и инфраструктуре. Но при этом хочет, чтобы Claude разбирался в проекте и выполнял в нём реальную работу. Наивная схема даёт агенту штатные инструменты файлов и шелла — а это ровно тот доступ, который безопасность не согласует: ничто не мешает агенту прочитать секрет, записать за пределами задачи или запустить деструктивную команду на хосте.
Методика
Ограничивать агента не промптом, а архитектурой. Убрать штатные инструменты полностью и пропустить любое взаимодействие через посредника, который исполняет команды в песочнице.
-
1. Единица работы — «проект + задача». Есть каталог
projects/и каталогtasks/. Под каждую пару стартует выделенный Docker-контейнер, куда монтируется только этот проект в/workspace. Сессии не видят друг друга. -
2. Claude без инструментов. Claude Code запускается
с
--tools ""— штатные чтение, запись файлов и запуск команд отключены. Сам по себе агент не может ни прочитать, ни изменить, ни выполнить ничего в системе. -
3. Доступ только через MCP. Вместо штатных
инструментов Claude обращается к MCP-серверу по HTTP (FastMCP, stateless, порт
17847). Сессия резолвится поIDP_SESSION_ID, сервер ищет её вsessions.csvи работает с её контейнером. Доступные инструменты:ping,echo,secureBash. -
4. Изолированное исполнение. Команда выполняется
через
docker execвнутри контейнера сессии, а не на хосте, с таймаутом (IDP_EXEC_TIMEOUT, дефолт300s). Результат —stdout/stderr/exit_code— возвращается Claude. -
5. Полный аудит. Все запросы к MCP пишутся в
logs/mcp.log(JSON Lines, тело обрезается на16 КБ) — след для разбора и комплаенса.
Старт сессии — реальная команда docker run
из лаунчера, и в ней важно, чего нет:
# scripts/start_session.py — как поднимается контейнер сессии
cmd = ["docker", "run", "-d", "--name", session_id, # session_id = idp-<uuid>
"-v", f"{project_path}:/workspace", "-w", "/workspace",
"-e", f"IDP_SESSION_ID={session_id}",
image, "sleep", "infinity"] # image = ubuntu:22.04 (демо)
Плюс лаунчер закрывает path traversal до
docker run — имя проекта не
может выскочить за projects/:
if not project or project in (".", "..") or "/" in project or "\\" in project:
sys.exit(f"Invalid project name: {project!r}")
project_path = (PROJECTS_DIR / project).resolve()
if not str(project_path).startswith(str(projects_root) + os.sep):
sys.exit(f"Invalid project path: {project!r}")
Запуск Claude — обратите внимание на
--tools "":
./scripts/start_session.py demo demo-001 # → idp-<uuid>, контейнер, запись в sessions.csv
eval "$(./scripts/claude_command.py demo demo-001)"
# сгенерированная команда:
IDP_SESSION_ID=idp-aae519cd... \
claude --append-system-prompt "<правила guard'а>" \
-p "<текст задачи из tasks/demo-001.md>" \
--tools "" # штатные tools off; остаётся только MCP (secureBash, ...)
Артефакт
github.com/dobryakov/enterprise-code-bastion
(Python, Docker, MCP-over-HTTP). Рабочий скелет бастиона: лаунчер сессий с path-guard,
сборщик команды, FastMCP-сервер с
secureBash и
docker exec,
аудит-middleware, CSV-реестр сессий. Это инспектируемый артефакт — и ровно поэтому
честно назвать, что в нём есть, а чего пока нет (см. ниже).
Где ломается
Честный разбор здесь важнее методики: для CISO-аудитории переоценка несуществующего контроля хуже, чем его отсутствие.
-
Командного gate в артефакте нет — это самое важное.
secureBashисполняет произвольный bash: путь короткий и без фильтра —secureBash → run_bash_in_container → docker exec session_id bash -lc command. Никакого allowlist, никакой LLM-проверки в коде нет. Фильтрующий слой — это задуманный следующий компонент, а не реализованный. Как решаю: порядок сборки осознанный — сначала изоляция и периметр (контейнер,--tools "", единственный путь через MCP, аудит), потом gate, потому что фильтр без изоляции бесполезен, а изоляция без фильтра уже сужает blast radius до контейнера. Production-gate — это два слоя: детерминированный allowlist (что вообще можно) как жёсткая граница, и LLM-классификатор (уместно ли в рамках задачи) как мягкий поверх него. LLM как единственный арбитр недопустим — у него своя поверхность prompt-injection. -
Демо-контейнер не закалён.
ubuntu:22.04,docker runбез--user,--cap-drop,--read-only,--network, лимитов памяти/CPU — то есть внутри root и полный сетевой egress. Изоляция защищает хост, но скомпрометированный контейнер сам по себе — всё ещё blast radius. Митигация в проде:--user 1000,--cap-drop=ALL,--read-only+ tmpfs,--networkс egress-allowlist (иначе агент выкачает код наружу),--memory/--cpus. Что мониторить: сетевой egress контейнеров и попытки исходящих соединений. -
MCP-эндпоинт без аутентификации. Сессия резолвится по
query-параметру
IDP_SESSION_ID— кто знает/угадает id, тот исполнит команду в чужом контейнере. В демо сервер слушает127.0.0.1, но в проде «вынесен за периметр» без auth — это дыра. Митигация: mTLS или подписанный session-токен на MCP, ротация id, привязка сессии к вызывающему. Что мониторить: обращения кsecureBashс чужим/истёкшимIDP_SESSION_IDвlogs/mcp.log. -
Плоский реестр не тянет governance.
sessions.csv— нормальный append-only журнал, но без контроля конкурентности, RBAC и «кто что согласовал». На масштабе организации нужен настоящий session store и workflow согласований. Аудит-лог к тому же обрезает тело на 16 КБ — длинный вывод в след не попадёт целиком.
Для кого и почему
Это модель безопасности для AI-над-кодом там, где должна согласовать безопасность: изоляция, наименьшие привилегии, единственный узкий путь, полный аудит. Не туториал «как запустить агента» — архитектурный разговор о границе между «дать агенту достаточно, чтобы он был полезен» и «оставить его физически неспособным действовать за рамками разрешённого». Артефакт показывает скелет честно: Claude рассуждает и решает, но без инструментов и прямого доступа — а незакрытые места (gate, закалка контейнера, auth) названы там, где их и будет искать инженер по безопасности.
Читать дальше
Об авторе
Григорий Добряков — fractional / interim eng + AI leadership
Пустить AI-агентов к кодовой базе — безопасно?
Изоляция, наименьшие привилегии, фильтрация каждой операции и аудит для AI-над-кодом — с рабочим артефактом, а не презентацией политик.
Обсудить fractional-аудит Написать мнеДругие разборы
Серия инженерных разборов: реальная задача → методология → рабочий артефакт → честный разбор того, где это ломается.
К серии →