Claudebox — MCP-сервер для Claude Code: что делает и как установить
Запускает Claude Code внутри контейнера Docker и открывает доступ к агенту по MCP и HTTP. Позволяет отдавать команды через консоль, скрипты, Telegram или планировщик cron.
Открыть на GitHubЧто делает Claudebox
Сервер упаковывает среду Claude Code в Docker-контейнер на базе рантайма aicodebox. Обёртка монтирует рабочую папку и держит ключи SSH, восстанавливая прошлую сессию по умолчанию. В зависимости от задачи доступен базовый контейнер или сборка с набором компиляторов и утилит для Go, Python, Node.js и баз данных.
Агентом управляют через консоль, команды claudebox -p, запросы к HTTP /run либо MCP. Исполняемый файл Claude Code не зашит в опубликованный образ. При первом старте скрипт скачивает его через npm, поэтому нужен доступ в сеть. Для авторизации передают ANTHROPIC_API_KEY или OAuth-токен в переменной CLAUDE_CODE_OAUTH_TOKEN.
Контейнер не изолирует недоверенный код. Стандартная обёртка подключает сокет Docker хоста, работает через сеть хоста и даёт Claude права sudo без пароля.
Какие задачи решает
- Запустить Claude Code в постоянном Docker-контейнере с сохранением SSH-ключей
- Подключить Claude Code как инструмент к другим агентам через потоковый MCP-сервер
- Запускать пакетные проверки репозитория со структурированным выводом в JSON или NDJSON
- Организовать регулярное выполнение задач по расписанию с помощью встроенного режима cron
Примеры запросов агенту
- Выполни ревью кодовой базы через
claudeboxс выводом в формате JSON:claudebox -p "review this codebase" --output-format json - Объясни архитектуру текущего проекта через
claudebox -p "explain this codebase" - Проинспектируй рабочую директорию без продолжения предыдущей сессии:
claudebox --no-continue
Как установить Claudebox
Установка
Команды запуска нет в реестре MCP — смотрите README репозитория
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Claudebox
Как установить Claudebox в Claude Code?
Для стандартной сборки выполните curl -fsSL https://raw.githubusercontent.com/psyb0t/docker-claudebox/master/install.sh | bash. Если требуется полный набор инструментов разработки, используйте export CLAUDEBOX_FULL=1 && curl -fsSL https://raw.githubusercontent.com/psyb0t/docker-claudebox/master/install.sh | bash.
Что делает Claudebox?
Сервер запускает Claude Code внутри Docker и предоставляет доступ к нему по протоколам MCP и HTTP, а также через терминал и Telegram. Он сохраняет состояние сессий, монтирует текущий каталог и перенаправляет ключи SSH.
Изолирует ли контейнер Claudebox ненадёжный код?
Нет, Claudebox не предназначен для изоляции небезопасного кода. Обёртка монтирует сокет Docker с хоста, использует сеть хоста и предоставляет агенту доступ к sudo без пароля.
