
AIエージェントのためのローカルサンドボックス
CodeRunnerは、AIエージェントとそのアクションをサンドボックス内で隔離するのに役立ちます。
主なユースケース: 明示的に選択したホストマウントとネットワークアクセスを備えたサンドボックス内で、AIエージェントのコードを実行します。隔離はリスクを軽減しますが、すべてのデータ損失や外部流出を防ぐものではありません。
エージェント向けのクラウド管理VMとして、InstaVM - AIエージェント向けのインスタントコンピュータをリリースしました。
前提条件: macOSとApple Silicon(M1/M2/M3/M4)を搭載したMac、Python 3.10以上
インストーラーはサンドボックストークンを~/.coderunner/api-tokenに生成します(または、エクスポートしたCODERUNNER_API_TOKENを保存します)。クライアントはこれをAuthorization: Bearer <token>として送信します。cat ~/.coderunner/api-tokenで表示できます。公開されているのはGET /healthのみであり、トークンが欠落しているか弱い場合はフェイルクローズします。Claude Desktopプロキシとサンプルは、変数が設定されていない場合にこのファイルからトークンを読み取ります。詳細は認証とネットワーク境界を参照してください。
git clone https://github.com/instavm/coderunner.git
cd coderunner
chmod +x install.sh
./install.sh
作業が終わったらサンドボックスを停止します:
container stop coderunner
同じサンドボックスを後で再開し、そのファイルシステムを保持します。Pythonカーネルの状態は揮発性であり、VMやサーバーの再起動後には保持されません:
container start coderunner
クリーンなサンドボックスで最初からやり直すには、コンテナを削除してインストーラーを再度実行します:
container delete coderunner && ./install.sh
CPU とメモリの制限は、インストーラーのオプション、または CODERUNNER_CPUS と CODERUNNER_MEMORY 環境変数で設定できます:
./install.sh --cpus 4 --memory 8g
追加のホストディレクトリは /workspace 配下にマウントする必要があります。デフォルトでは読み取り専用です。サンドボックスがホストに書き込む必要がある場合にのみ :rw を追加してください:
./install.sh \
--mount "$HOME/projects/api:/workspace/api" \
--mount "$HOME/projects/output:/workspace/output:rw"
追加マウントはデフォルトでなしです。リソースとマウントの設定はコンテナ作成時に固定されます。変更する場合はコンテナを削除してから行ってください。
デフォルトでは、サンドボックス内で実行されるコードは無制限のネットワークアクセスを持ちます。インターネットアクセスのないホストオンリーネットワークで実行するには:
CODERUNNER_NETWORK=none ./install.sh
このモードでは、MCP サーバーは http://127.0.0.1:8222/mcp で利用できます。この設定はコンテナ作成時に固定され、インストーラーは異なるネットワークモードのコンテナの再開を拒否します。
Claude Code は、あなたのマシン上で、あなたとしてコマンドを実行し、権限プロンプトだけが境界となります。代わりに CodeRunner のツールを指定すると、書き込んだコードは VM 内で実行されます。何を指示されても、アクセスできるのは /workspace 以下にマウントしたフォルダ、許可したネットワーク、そしてサンドボックス自身のファイルシステムのみです。信頼できない入力を扱うコードや、手動で実行したくないコード、状態を共有してはならない複数のエージェント(名前付きセッション)にはサンドボックスを使用してください。読み書き可能でマウントしたものは何も保護しません。
./install.sh(まだ実行していない場合)
container exec -it coderunner /bin/bash
root@coderunner:/app# npm install -g @anthropic-ai/claude-code
MCP サーバーは次の場所で利用可能になります: http://coderunner.local:8222/mcp
インストーラーは Claude Desktop プロキシ用に ~/.coderunner/venv を作成します。その他の Python の例では、依存関係を自身の virtualenv にインストールしてください:
pip install -r examples/requirements.txt



設定例をコピーします:
cd examples
cp claude_desktop/claude_desktop_config.example.json claude_desktop/claude_desktop_config.json
設定ファイルを編集し、プレースホルダーのパスを置き換えます:
/path/to/your/python を $HOME/.coderunner/venv/bin/python に置き換えます(ホームディレクトリへのフルパスを使用)/path/to/coderunner をクローンしたリポジトリの実際のパスに置き換えます編集後の例:
{
"mcpServers": {
"coderunner": {
"command": "/Users/yourname/.coderunner/venv/bin/python",
"args": ["/Users/yourname/coderunner/examples/claude_desktop/mcpproxy.py"]
}
}
}
Claude Desktop の設定を更新します:
Claude で CodeRunner の使用を開始します: Claude が書いたコードはサンドボックス内で実行されるようになります。
サーバーが実行中として表示されているにもかかわらず、チャットのツールメニューでツールが「Disabled」と表示される場合: Claude
Desktop を完全に終了し (Cmd-Q)、再度開いてください。command がインストーラーが表示した venv の python
(fastmcp を含むもの) であることを確認し、プロキシのエラーについては ~/Library/Logs/Claude/mcp-server-coderunner.log を
確認してください。プロキシにはサンドボックスが実行中であること (container list) と、トークンファイル ~/.coderunner/api-token が
必要です。
クイックスタート:
# 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
Claude Code プラグイン(claude plugin marketplace add https://github.com/instavm/coderunner-plugin)はトークンより前に存在するため、同じヘッダーを送信するまで 401 が返されます。プラグインが更新されるまでは上記のコマンドを使用してください。
インストール手順:
プラグインマーケットプレイスに移動します:

InstaVM リポジトリを追加します:

Claude Code で Python コードを実行します:

これで完了です!Claude Code はすべての CodeRunner ツールにアクセスできるようになりました:
返された session_id を execute_python_code に渡すことで、エージェント間で状態を分離したままにできます。最大 5 つの名前付きセッションを同時に実行できます。
詳細情報: 詳細なドキュメントについてはプラグインリポジトリを参照してください。

~/.config/opencode/opencode.json を作成または編集します:
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"coderunner": {
"type": "remote",
"url": "http://coderunner.local:8222/mcp",
"headers": { "Authorization": "Bearer <contents of ~/.coderunner/api-token>" },
"enabled": true
}
}
}
設定を保存した後:

export OPENAI_API_KEY="your-openai-api-key-here"