Claude Code с Docker: Model Runner, MCP Toolkit и песочницы

Docker: локальные модели, MCP-серверы и безопасные песочницы

Claude Code стал популярным инструментом для разработчиков, включая опытных и новичков, которые хотят реализовать свои проекты без глубоких знаний программирования

Docker Model Runner: запуск языковых моделей локально

Docker Model Runner позволяет запускать языковые модели на вашем компьютере, сохраняя данные внутри вашей системы. Claude Code поддерживает интеграцию с пользовательскими API через переменную окружения ANTHROPIC_BASE_URL, что облегчает совместную работу с Docker Model Runner, который предоставляет API, совместимый с Anthropic

Использование Docker Model Runner обеспечивает контроль над данными и инфраструктурой, так как модель работает локально, а все данные остаются внутри вашей среды

По этой теме полезно отдельно посмотреть Что такое Docker — объяснение простыми словами, чтобы расширить контекст и сравнить подходы

По этой теме полезно отдельно посмотреть Docker backup — резервное копирование контейнеров и данных, чтобы расширить контекст и сравнить подходы

MCP-сервер в Docker: подключение через Docker MCP Toolkit

Протокол контекста модели (Model Context Protocol, MCP) стал стандартом для подключения агентов программирования, таких как Claude Code, к реальным инструментам: базам данных, репозиториям, браузерам и API. Docker MCP Toolkit предлагает свыше 300 готовых контейнеров MCP-серверов, позволяя быстрее и проще их развёртывание через Docker Desktop

Благодаря этому разработчики могут подключить Claude Code к доверенным средам за минуты, а не часы. Никаких проблем с зависимостями, никакой ручной настройки — только последовательный и безопасный рабочий процесс на Mac, Windows и Linux

В соответствующем руководстве показано, как:

• Настроить Claude Code и подключить его к Docker MCP Toolkit
• Настроить MCP-сервер Atlassian для интеграции с Jira
• Настроить MCP-сервер GitHub для доступа к истории репозитория и выполнения команд git
• Настроить MCP-сервер Filesystem для сканирования и чтения локальной кодовой базы
• Автоматизировать отслеживание технического долга, преобразовав 15 заметок о незавершённых задачах

в отслеживаемые тикеты Jira

Там же можно увидеть, как Claude Code запрашивает историю git, категоризирует проблемы и создаёт тикеты — всё это не выходя из среды разработки. Если вы предпочитаете видеоформат, доступен туториал о том, как добавить MCP-серверы в Claude Code с помощью

Подключение инструментов открывает широкие возможности автоматизации, однако с новыми функциями приходит ответственность за их использование

Docker Sandboxes: изолированная среда для агентов Claude Code

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

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

Такая изоляция позволяет доверять агентам, подобным Claude Code, предоставляя им автономию без риска навредить вашей системе

Типичные ошибки при настройке Claude Code с Docker

На практике я замечаю несколько повторяющихся проблем, которые стоит учесть заранее

Неправильная переменная окружения. Если ANTHROPIC_BASE_URL указывает не на локальный эндпоинт Docker Model Runner, Claude Code будет обращаться к облачному API Anthropic, игнорируя локальную модель. Проверьте значение переменной перед первым запуском

Конфликты учётных данных в MCP-серверах. Docker MCP Toolkit берёт на себя управление учётными данными, но если вы ранее настраивали MCP-серверы вручную, старые конфигурации могут конфликтовать с новыми. Рекомендую начинать с чистого состояния и добавлять серверы через интерфейс Docker Desktop

Недостаточная изоляция при ручном запуске агентов. Запуск Claude Code напрямую на хост-машине без песочницы означает, что любое автономное действие агента — удаление файлов, изменение конфигураций — затрагивает реальную систему. Docker Sandboxes решают эту проблему структурно, а не через ограничение прав агента

Игнорирование ресурсных лимитов модели. Локальные модели через Docker Model Runner потребляют оперативную память и вычислительные ресурсы. На моём опыте стоит заранее проверить, сколько памяти доступно Docker Desktop, и при необходимости скорректировать лимиты в настройках

Как проверить, что Claude Code работает корректно

После настройки стека полезно убедиться, что каждый компонент работает так, как ожидается

Для Docker Model Runner: отправьте тестовый запрос напрямую к локальному эндпоинту и убедитесь, что ответ приходит от локальной модели, а не из облака. Это можно сделать через curl или любой HTTP-клиент

Для MCP-серверов: попросите Claude Code выполнить простую задачу через каждый подключённый сервер — например, получить список открытых задач из Jira или прочитать файл из локальной файловой системы. Если инструмент отвечает корректно, интеграция работает

Для Docker Sandboxes: запустите агента с заведомо деструктивной командой в тестовой среде — например, удалением временного файла — и убедитесь, что хост-машина не затронута. Это даёт уверенность в том, что изоляция работает на практике, а не только на бумаге

Итоги: когда использовать каждый компонент Docker с Claude Code

Claude Code сам по себе полезен для работы с кодом, но в сочетании с Docker он превращается в безопасную, расширяемую и полностью контролируемую среду разработки на базе AI

Сочетая локальное выполнение моделей, безопасное подключение инструментов и изолированные среды выполнения, Docker позволяет запускать AI-агентов для написания кода с одновременной автономией и контролем — что делает их практичными для реальных рабочих процессов разработки

Если коротко, вот что даёт этот стек:

• Docker Model Runner — локальный запуск моделей с полным контролем над данными,

инфраструктурой и затратами через API-эндпоинт, совместимый с Anthropic

• Docker MCP Toolkit — подключение Claude Code к 300+ контейнеризированным

MCP-серверам для таких сервисов, как Jira, GitHub и локальные файловые системы, с развёртыванием в один клик

• Docker Sandboxes — изолированные среды, которые позволяют агентам работать

автономно, не подвергая риску хост-машину

Частые вопросы о Claude Code и Docker

Можно ли использовать Claude Code с локальными моделями без подписки на Anthropic?

Да. Если вы направляете ANTHROPIC_BASE_URL на Docker Model Runner, Claude Code будет поскольку запросы не уходят в облако

Сколько MCP-серверов можно подключить одновременно?

Docker MCP Toolkit не устанавливает жёсткого лимита на количество одновременно подключённых серверов. На практике ограничением становятся ресурсы машины, поскольку каждый сервер работает в отдельном контейнере

Что происходит с данными внутри Docker Sandbox после завершения работы агента?

Песочницы одноразовые: после завершения сессии среда уничтожается вместе со всеми изменениями, которые агент внёс внутри неё. Хост-машина при этом остаётся нетронутой

Работает ли этот стек на Windows и Linux, или только на Mac?

Runner также доступен на всех трёх платформах через Docker Desktop

Нужны ли специальные права доступа для запуска MCP-серверов через Docker Desktop?

Нет. Docker MCP Toolkit управляет учётными данными автоматически и изоляцией. Специальных системных прав сверх стандартных для Docker Desktop не требуется