Enterprise-бастион для кода: Claude работает над проектом без доступа к файлам и шеллу | Григорий Добряков

Григорий Добряков

Howto · разбор

Разбор 18 GitHub · open source

Enterprise-бастион для кода: Claude работает над проектом без доступа к файлам и шеллу

Штатные инструменты файлов и шелла для агента — это ровно тот вектор утечки, который безопасность не согласует. Enterprise code bastion убирает их совсем (--tools "") и пропускает каждое действие через фильтрующий MCP-посредник, исполняющий команды в изолированном контейнере: Claude рассуждает и решает, но напрямую к коду, секретам и инфраструктуре не ходит.

CISO CTO Head of AI Architect

Проблема

Крупная организация не может дать AI-инструменту неконтролируемый доступ к исходному коду, секретам и инфраструктуре. Но при этом хочет, чтобы Claude разбирался в проекте и выполнял в нём реальную работу. Наивная схема даёт агенту штатные инструменты файлов и шелла — а это ровно тот доступ, который безопасность не согласует: ничто не мешает агенту прочитать секрет, записать за пределами задачи или запустить деструктивную команду на хосте.

Методика

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

  1. 1. Единица работы — «проект + задача». Есть каталог projects/ и каталог tasks/. Под каждую пару стартует выделенный Docker-контейнер, куда монтируется только этот проект в /workspace. Сессии не видят друг друга.
  2. 2. Claude без инструментов. Claude Code запускается с --tools "" — штатные чтение, запись файлов и запуск команд отключены. Сам по себе агент не может ни прочитать, ни изменить, ни выполнить ничего в системе.
  3. 3. Доступ только через MCP. Вместо штатных инструментов Claude обращается к MCP-серверу по HTTP (FastMCP, stateless, порт 17847). Сессия резолвится по IDP_SESSION_ID, сервер ищет её в sessions.csv и работает с её контейнером. Доступные инструменты: ping, echo, secureBash.
  4. 4. Изолированное исполнение. Команда выполняется через docker exec внутри контейнера сессии, а не на хосте, с таймаутом (IDP_EXEC_TIMEOUT, дефолт 300s). Результат — stdout / stderr / exit_code — возвращается Claude.
  5. 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-аудитории переоценка несуществующего контроля хуже, чем его отсутствие.

Для кого и почему

Это модель безопасности для AI-над-кодом там, где должна согласовать безопасность: изоляция, наименьшие привилегии, единственный узкий путь, полный аудит. Не туториал «как запустить агента» — архитектурный разговор о границе между «дать агенту достаточно, чтобы он был полезен» и «оставить его физически неспособным действовать за рамками разрешённого». Артефакт показывает скелет честно: Claude рассуждает и решает, но без инструментов и прямого доступа — а незакрытые места (gate, закалка контейнера, auth) названы там, где их и будет искать инженер по безопасности.

Об авторе

Григорий Добряков — fractional / interim eng + AI leadership

Пустить AI-агентов к кодовой базе — безопасно?

Изоляция, наименьшие привилегии, фильтрация каждой операции и аудит для AI-над-кодом — с рабочим артефактом, а не презентацией политик.

Обсудить fractional-аудит Написать мне

Другие разборы

Серия инженерных разборов: реальная задача → методология → рабочий артефакт → честный разбор того, где это ломается.

К серии →