
Eine lokale Sandbox für Ihre KI-Agenten
CodeRunner hilft dir, deine KI-Agenten und deren Aktionen in einer Sandbox zu isolieren.
Hauptanwendungsfall: Führe den Code von KI-Agenten in einer Sandbox mit explizit ausgewählten Host-Mounts und Netzwerkzugriff aus. Isolation reduziert Risiken; sie verhindert nicht jeden Datenverlust oder jede Datenexfiltration.
Für cloud-verwaltete VMs für Agenten haben wir Folgendes gestartet – InstaVM – Sofort verfügbare Computer für KI-Agenten
Voraussetzungen: Mac mit macOS und Apple Silicon (M1/M2/M3/M4), Python 3.10+
Der Installer erzeugt das Sandbox-Token in ~/.coderunner/api-token (oder speichert
das von dir exportierte CODERUNNER_API_TOKEN). Clients senden es als
Authorization: Bearer <token>; cat ~/.coderunner/api-token gibt es aus. Nur
GET /health ist öffentlich, und ein fehlendes oder schwaches Token führt zu einem Fail-Closed-Verhalten. Der Claude
Desktop-Proxy und die Beispiele lesen das Token aus dieser Datei, wenn die Variable
nicht gesetzt ist. Siehe Authentifizierung und Netzwerkgrenzen.
git clone https://github.com/instavm/coderunner.git
cd coderunner
chmod +x install.sh
./install.sh
Halten Sie die Sandbox an, wenn Sie fertig sind:
container stop coderunner
Setzen Sie dieselbe Sandbox später fort und bewahren Sie dabei ihr Dateisystem. Der Zustand des Python-Kernels ist flüchtig und übersteht einen Neustart der VM oder des Servers nicht:
container start coderunner
Um mit einer sauberen Sandbox von vorn zu beginnen, löschen Sie den Container und führen Sie den Installer erneut aus:
container delete coderunner && ./install.sh
CPU- und Speicherlimits können über Installer-Optionen oder die Umgebungsvariablen CODERUNNER_CPUS und CODERUNNER_MEMORY festgelegt werden:
./install.sh --cpus 4 --memory 8g
Zusätzliche Host-Verzeichnisse müssen unter /workspace eingebunden werden. Sie sind standardmäßig schreibgeschützt; fügen Sie :rw nur hinzu, wenn die Sandbox in den Host schreiben muss:
./install.sh \
--mount "$HOME/projects/api:/workspace/api" \
--mount "$HOME/projects/output:/workspace/output:rw"
Zusätzliche Mounts sind standardmäßig keine. Ressourcen- und Mount-Einstellungen sind festgelegt, wenn der Container erstellt wird; löschen Sie den Container, bevor Sie sie ändern.
Standardmäßig hat Code, der in der Sandbox ausgeführt wird, uneingeschränkten Netzwerkzugriff. Um ihn in einem host-only-Netzwerk ohne Internetzugang auszuführen:
CODERUNNER_NETWORK=none ./install.sh
In diesem Modus ist der MCP-Server unter http://127.0.0.1:8222/mcp verfügbar. Die Einstellung wird beim Erstellen des Containers festgelegt; der Installer weigert sich, einen Container mit einem anderen Netzwerkmodus fortzusetzen.
Claude Code führt Befehle auf deiner Maschine aus, als du, wobei Berechtigungsabfragen die einzige Grenze darstellen. Wenn man es stattdessen auf die Tools von CodeRunner richtet, wird der von ihm geschriebene Code in der VM ausgeführt: Er kann nur auf die Ordner zugreifen, die du unter /workspace eingebunden hast, auf das von dir erlaubte Netzwerk und auf das eigene Dateisystem der Sandbox – ganz gleich, wozu er angewiesen wurde. Verwende die Sandbox für Code, der nicht vertrauenswürdige Eingaben verarbeitet oder den du nicht von Hand ausführen würdest, sowie für mehrere Agents, die keinen Zustand teilen dürfen (benannte Sitzungen). Sie schützt nichts, was du im Lese-/Schreibmodus einbindest.
./install.sh (falls noch nicht geschehen)
container exec -it coderunner /bin/bash
root@coderunner:/app# npm install -g @anthropic-ai/claude-code
Der MCP-Server ist verfügbar unter: http://coderunner.local:8222/mcp
Der Installer erstellt ~/.coderunner/venv für den Claude-Desktop-Proxy. Für die anderen Python-Beispiele installiere deren Abhängigkeiten in deiner eigenen virtuellen Umgebung:
pip install -r examples/requirements.txt



Kopieren Sie die Beispielkonfiguration:
cd examples
cp claude_desktop/claude_desktop_config.example.json claude_desktop/claude_desktop_config.json
Bearbeiten Sie die Konfigurationsdatei und ersetzen Sie die Platzhalterpfade:
/path/to/your/python durch $HOME/.coderunner/venv/bin/python unter Verwendung des vollständigen Pfads zu Ihrem Home-Verzeichnis/path/to/coderunner durch den tatsächlichen Pfad zu Ihrem geklonten RepositoryBeispiel nach der Bearbeitung:
{
"mcpServers": {
"coderunner": {
"command": "/Users/yourname/.coderunner/venv/bin/python",
"args": ["/Users/yourname/coderunner/examples/claude_desktop/mcpproxy.py"]
}
}
}
Claude Desktop-Konfiguration aktualisieren:
CodeRunner in Claude verwenden: Code, den Claude schreibt, wird jetzt in der Sandbox ausgeführt.
Wenn das Tool im Tool-Menü des Chats als „Disabled" angezeigt wird, obwohl der Server als laufend aufgeführt ist: Claude
Desktop vollständig beenden (Cmd-Q) und erneut öffnen, sicherstellen, dass command der venv-Python ist, den der Installer ausgegeben hat (er
enthält fastmcp), und ~/Library/Logs/Claude/mcp-server-coderunner.log auf den Fehler des Proxys prüfen. Der Proxy
benötigt die laufende Sandbox (container list) und die Token-Datei ~/.coderunner/api-token.
Schnellstart:
# 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
Das Claude Code Plugin (claude plugin marketplace add https://github.com/instavm/coderunner-plugin) ist älter als das Token und erhält 401, bis es denselben Header sendet; verwenden Sie den obigen Befehl, bis das Plugin aktualisiert wurde.
Installationsschritte: