Skip to content
KitploitKITPLOIT
ツールブログ
Log in
提出
ツールブログ
提出

ハッキング、侵入テスト、サイバーセキュリティツールをあなたのセキュリティアーセナルに!

Kitploitはハッキング、サイバーセキュリティ、ペネトレーションテストのツールディレクトリです。最新のプロジェクトアップデートを見つけて、脆弱性の発見、システム分析、テストの自動化、セキュリティの強化を行いましょう。

フィードお問い合わせプライバシー© 2026 Kitploit

ツールディレクトリ

カテゴリ

すべてのカテゴリを見る
Loading categories
coderunner — AIエージェントのためのローカルサンドボックス | Kitploit
ツール/GitHubGitHub/instavm/coderunner
コンテナセキュリティ動的分析 (サンドボックス)セキュリティ仮想化DevSecOpsAIセキュリティ
GitHubinstavm/coderunner

coderunner

AIエージェントのためのローカルサンドボックス

リポジトリを見る
882414910日前Kitploit レビュー済み
共有
ウェブサイト

Start License

CodeRunner: 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 を使用する場合

Claude Code は、あなたのマシン上で、あなたとしてコマンドを実行し、権限プロンプトだけが境界となります。代わりに CodeRunner のツールを指定すると、書き込んだコードは VM 内で実行されます。何を指示されても、アクセスできるのは /workspace 以下にマウントしたフォルダ、許可したネットワーク、そしてサンドボックス自身のファイルシステムのみです。信頼できない入力を扱うコードや、手動で実行したくないコード、状態を共有してはならない複数のエージェント(名前付きセッション)にはサンドボックスを使用してください。読み書き可能でマウントしたものは何も保護しません。

サンドボックス内で Claude Code を実行する

./install.sh(まだ実行していない場合)

container exec -it coderunner /bin/bash

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

image

その他の統合オプション

MCP サーバーは次の場所で利用可能になります: http://coderunner.local:8222/mcp

インストーラーは Claude Desktop プロキシ用に ~/.coderunner/venv を作成します。その他の Python の例では、依存関係を自身の virtualenv にインストールしてください:

pip install -r examples/requirements.txt

1. Claude Desktop との統合

CodeRunner を MCP サーバーとして使用するように Claude Desktop を設定します:

demo1

demo2

demo4

  1. 設定例をコピーします:

    cd examples
    cp claude_desktop/claude_desktop_config.example.json claude_desktop/claude_desktop_config.json
    
  2. 設定ファイルを編集し、プレースホルダーのパスを置き換えます:

    • /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"]
        }
      }
    }
    
  3. Claude Desktop の設定を更新します:

    • Claude Desktop を開きます
    • Settings → Developer に移動します
    • MCP サーバーの設定を追加します
    • Claude Desktop を再起動します
  4. Claude で CodeRunner の使用を開始します: Claude が書いたコードはサンドボックス内で実行されるようになります。

    サーバーが実行中として表示されているにもかかわらず、チャットのツールメニューでツールが「Disabled」と表示される場合: Claude Desktop を完全に終了し (Cmd-Q)、再度開いてください。command がインストーラーが表示した venv の python (fastmcp を含むもの) であることを確認し、プロキシのエラーについては ~/Library/Logs/Claude/mcp-server-coderunner.log を 確認してください。プロキシにはサンドボックスが実行中であること (container list) と、トークンファイル ~/.coderunner/api-token が 必要です。

2. Claude Code CLI

ターミナルベースの AI 支援のために CodeRunner を Claude Code CLI で使用します:

クイックスタート:

# 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 が返されます。プラグインが更新されるまでは上記のコマンドを使用してください。

インストール手順:

  1. プラグインマーケットプレイスに移動します:

    プラグインマーケットプレイスに移動

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

    InstaVM リポジトリを追加

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

    Python コードを実行

これで完了です!Claude Code はすべての CodeRunner ツールにアクセスできるようになりました:

  • execute_python_code - 永続的な Jupyter カーネルで Python コードを実行
  • start_python_session - 名前付きセッション用に分離されたカーネルを予約
  • list_python_sessions - アクティブな名前付きセッションを一覧表示
  • stop_python_session - セッションを停止し、そのカーネル状態を破棄
  • navigate_and_get_all_visible_text - Playwright による Web スクレイピング
  • list_skills - 利用可能なスキルを一覧表示(docx、xlsx、pptx、pdf、画像処理など)
  • get_skill_info - 特定のスキルのドキュメントを取得
  • get_skill_file - スキルファイルとサンプルを読み取り

返された session_id を execute_python_code に渡すことで、エージェント間で状態を分離したままにできます。最大 5 つの名前付きセッションを同時に実行できます。

詳細情報: 詳細なドキュメントについてはプラグインリポジトリを参照してください。

3. OpenCode の設定

CodeRunner を MCP サーバーとして使用するように OpenCode を設定します:

OpenCode の例

~/.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
    }
  }
}

設定を保存した後:

  1. OpenCode を再起動します
  2. CodeRunner ツールが自動的に利用可能になります
  3. サンドボックス環境へのフルアクセスを備えた Python コードの実行を開始します

4. Python OpenAI Agents

OpenAI の Python agents ライブラリで CodeRunner を使用する:

demo3

  1. OpenAI API キーを設定します:
    export OPENAI_API_KEY="your-openai-api-key-here"
    
ツールをダウンロード

人気

すべて見る →

コミュニティで最も使われているツールを見つけましょう。

まだ人気データがありません。

すべてのツールを探索

ツールコレクションを閲覧

すべてのツールを見る →