Skip to content
KitploitKITPLOIT
ToolsExploitsBlog
Log in
Submit
ToolsExploitsBlog
Submit

Hacking, PenTest, and Cybersecurity Tools for Your Security Arsenal!

Kitploit is a directory of hacking, cybersecurity, and pentesting tools. Discover the latest project updates to find vulnerabilities, analyze systems, automate testing, and strengthen your security.

FeedsContactPrivacy© 2026 Kitploit

Tool Directory

Categories

View all categories
Loading categories
coderunner — A local sandbox for your AI agents | Kitploit
Tools/GitHubGitHub/instavm/coderunner
Container SecurityDynamic Analysis (Sandboxing)Security VirtualizationDevSecOpsAI Security
GitHubinstavm/coderunner

coderunner

A local sandbox for your AI agents

View Repository
882414910 days agoReviewed by Kitploit
Share
Website

Start License

CodeRunner: A local sandbox for your AI agents

CodeRunner helps you sandbox your AI agents and its actions inside a sandbox.

Key use case: Run AI agent code in a sandbox with explicitly chosen host mounts and network access. Isolation reduces risk; it does not prevent all data loss or exfiltration.

For cloud managed VMs for agents, we have launched - InstaVM - Instant computers for AI agents

Quick Start

Prerequisites: Mac with macOS and Apple Silicon (M1/M2/M3/M4), Python 3.10+

Credentials

The installer generates the sandbox token in ~/.coderunner/api-token (or saves the CODERUNNER_API_TOKEN you exported). Clients send it as Authorization: Bearer <token>; cat ~/.coderunner/api-token prints it. Only GET /health is public, and a missing or weak token fails closed. The Claude Desktop proxy and the examples read the token from that file when the variable is not set. See authentication and network boundaries.

git clone https://github.com/instavm/coderunner.git
cd coderunner
chmod +x install.sh
./install.sh

Stop and resume

Stop the sandbox when you are done:

container stop coderunner

Resume the same sandbox later, preserving its filesystem. Python kernel state is volatile and does not survive a VM or server restart:

container start coderunner

To start over with a clean sandbox, delete the container and run the installer again:

container delete coderunner && ./install.sh

Resource limits and workspace mounts

CPU and memory limits can be set with installer options or the CODERUNNER_CPUS and CODERUNNER_MEMORY environment variables:

./install.sh --cpus 4 --memory 8g

Additional host directories must be mounted under /workspace. They are read-only by default; add :rw only when the sandbox needs to write to the host:

./install.sh \
  --mount "$HOME/projects/api:/workspace/api" \
  --mount "$HOME/projects/output:/workspace/output:rw"

Extra mounts default to none. Resource and mount settings are fixed when the container is created; delete the container before changing them.

Disable outbound network access

By default, code running in the sandbox has unrestricted network access. To run it on a host-only network with no internet access:

CODERUNNER_NETWORK=none ./install.sh

In this mode, the MCP server is available at http://127.0.0.1:8222/mcp. The setting is fixed when the container is created; the installer refuses to resume a container with a different network mode.

With Claude Code

Claude Code runs commands on your machine, as you, with permission prompts as the only boundary. Pointing it at CodeRunner's tools instead runs the code it writes in the VM: it can only touch the folders you mounted under /workspace, the network you allowed, and the sandbox's own filesystem, whatever it was told to do. Use the sandbox for code that handles untrusted input or that you would not run by hand, and for several agents that must not share state (named sessions). It does not protect anything you mount read-write.

Run Claude Code inside a Sandbox

./install.sh (if not already done)

container exec -it coderunner /bin/bash

root@coderunner:/app# npm install -g @anthropic-ai/claude-code

image

Other Integration Options

MCP server will be available at: http://coderunner.local:8222/mcp

The installer creates ~/.coderunner/venv for the Claude Desktop proxy. For the other Python examples, install their dependencies in your own virtualenv:

pip install -r examples/requirements.txt

1. Claude Desktop Integration

Configure Claude Desktop to use CodeRunner as an MCP server:

demo1

demo2

demo4

  1. Copy the example configuration:

    cd examples
    cp claude_desktop/claude_desktop_config.example.json claude_desktop/claude_desktop_config.json
    
  2. Edit the configuration file and replace the placeholder paths:

    • Replace /path/to/your/python with $HOME/.coderunner/venv/bin/python using the full path to your home directory
    • Replace /path/to/coderunner with the actual path to your cloned repository

    Example after editing:

    {
      "mcpServers": {
        "coderunner": {
          "command": "/Users/yourname/.coderunner/venv/bin/python",
          "args": ["/Users/yourname/coderunner/examples/claude_desktop/mcpproxy.py"]
        }
      }
    }
    
  3. Update Claude Desktop configuration:

    • Open Claude Desktop
    • Go to Settings → Developer
    • Add the MCP server configuration
    • Restart Claude Desktop
  4. Start using CodeRunner in Claude: Code Claude writes now runs in the sandbox.

    If the tool shows as "Disabled" in the chat's tool menu although the server is listed as running: quit Claude Desktop fully (Cmd-Q) and open it again, make sure command is the venv python the installer printed (it has fastmcp), and read ~/Library/Logs/Claude/mcp-server-coderunner.log for the proxy's error. The proxy needs the sandbox running (container list) and the token file ~/.coderunner/api-token.

2. Claude Code CLI

Use CodeRunner with Claude Code CLI for terminal-based AI assistance:

Quick Start:

# 1. Install and start CodeRunner (one-time setup; run as yourself, it asks for sudo when it needs it)
git clone https://github.com/instavm/coderunner.git
cd coderunner
./install.sh

# 2. Add the sandbox with its token (the installer prints this command)
claude mcp add --transport http coderunner http://coderunner.local:8222/mcp \
  --header "Authorization: Bearer $(cat ~/.coderunner/api-token)"

# 3. Reconnect to MCP servers
/mcp

The Claude Code plugin (claude plugin marketplace add https://github.com/instavm/coderunner-plugin) predates the token and gets 401 until it sends the same header; use the command above until the plugin is updated.

Installation Steps:

  1. Navigate to Plugin Marketplace:

    Navigate to Plugin Marketplace

  2. Add the InstaVM repository:

    Add InstaVM Repository

  3. Execute Python code with Claude Code:

    Execute Python Code

Download Tool

Most Popular

View all →

Discover the most used tools by our community.

No popularity data yet.

Explore all tools

Browse our collection of tools

View all tools →