Claudebox — Claude Code MCP server: what it does, how to install
Runs Claude Code inside Docker and exposes it as an agent tool over MCP and HTTP. Supports terminal prompts, automated scripts, Telegram, and cron jobs.
Open on GitHubWhat Claudebox does
The server packages Claude Code into a Docker container based on the aicodebox runtime. The wrapper mounts your current directory and preserves SSH keys, restoring the last workspace session by default. Depending on the workload, you can run a minimal image or an extended build with tools for Go, Python, Node.js, and database clients.
You interact with the agent via the terminal, one-shot claudebox -p commands, HTTP /run calls, or MCP connections. The Claude Code binary is not bundled in the published image. A fresh container installs it through npm on its initial run, so it requires network connectivity. Authentication accepts ANTHROPIC_API_KEY or CLAUDE_CODE_OAUTH_TOKEN from the shell.
The environment is not a security sandbox. By default, the wrapper connects to the host network, mounts the host's Docker socket, and grants passwordless sudo access without confirmation dialogs.
What it helps with
- Run Claude Code inside a persistent Docker environment with managed SSH keys
- Expose Claude Code capabilities to external agent systems via streamable HTTP MCP
- Execute automated codebase checks with structured output in JSON or streaming NDJSON
- Schedule recurring autonomous tasks using the built-in cron interface
Example prompts for the agent
- Review the project and produce machine-readable output:
claudebox -p "review this codebase" --output-format json - Inspect the codebase architecture using
claudebox -p "explain this codebase" - Start a clean container run without workspace history via
claudebox --no-continue
How to install Claudebox
Install
The MCP registry has no launch command for it: see the repository README
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Claudebox
How do I install Claudebox in Claude Code?
For the minimal runtime, run curl -fsSL https://raw.githubusercontent.com/psyb0t/docker-claudebox/master/install.sh | bash. To install the complete development toolchain, execute export CLAUDEBOX_FULL=1 && curl -fsSL https://raw.githubusercontent.com/psyb0t/docker-claudebox/master/install.sh | bash.
What does Claudebox do?
It wraps Claude Code into Docker and provides access over MCP, HTTP, Telegram, cron, and interactive terminal sessions. It binds your local workspace directory and retains session state between runs.
Does Claudebox isolate untrusted code safely?
No, it does not act as a security sandbox. The standard configuration connects directly to the host network, mounts the host Docker socket, and grants passwordless sudo privileges.
