# Claudebox

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed · ★ 23
- Author: psyb0t
- License: WTFPL · policy=link-only · description only; the file stays with the author
- Source: https://github.com/psyb0t/docker-claudebox
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/claudebox

## What it 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.

## Requirements
- Needs: Docker
- Works with: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- 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
- 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`

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md