CodeRunner: локальная песочница для AI-агентов

CodeRunner изолирует AI-агентов и их действия внутри защищённой песочницы.

Основной сценарий использования: запуск нескольких экземпляров Claude Code или других AI-агентов в песочнице без риска потери данных или их утечки.

Быстрый старт

Требования: Mac с macOS и Apple Silicon (M1/M2/M3/M4), Python 3.10+

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

Запуск Claude Code внутри песочницы

./install.sh (если ещё не выполнено)

container exec -it coderunner /bin/bash

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

Другие варианты интеграции

MCP-сервер будет доступен по адресу: http://coderunner.local:8222/mcp

Установка необходимых пакетов (используйте virtualenv и укажите путь к Python):

1. Интеграция с Claude Desktop

1. Скопируйте пример конфигурации:

   bashКопировать

   cd examples
   cp claude_desktop/claude_desktop_config.example.json claude_desktop/claude_desktop_config.json

2. Отредактируйте файл конфигурации и замените placeholder-пути:

   • Замените /path/to/your/python на реальный путь к Python (например, /usr/bin/python3 или /opt/homebrew/bin/python3)
   • Замените /path/to/coderunner на реальный путь к склонированному репозиторию

   Пример после редактирования:

   jsonКопировать

   {
     "mcpServers": {
       "coderunner": {
         "command": "/opt/homebrew/bin/python3",
         "args": ["/Users/yourname/coderunner/examples/claude_desktop/mcpproxy.py"]
       }
     }
   }

3. Обновите конфигурацию Claude Desktop:

   • Откройте Claude Desktop
   • Перейдите в Settings → Developer
   • Добавьте конфигурацию MCP-сервера
   • Перезапустите Claude Desktop

4. Начните использовать CodeRunner в Claude: Теперь можно просить Claude выполнять код — он будет запускаться безопасно в песочнице!

2. Claude Code CLI

Быстрый старт:

# 1. Установите и запустите CodeRunner (однократная настройка)
git clone https://github.com/instavm/coderunner.git
cd coderunner
sudo ./install.sh

# 2. Установите плагин Claude Code
claude plugin marketplace add https://github.com/instavm/coderunner-plugin
claude plugin install instavm-coderunner

# 3. Переподключитесь к MCP-серверам
/mcp

Шаги установки:

1. Перейдите в Plugin Marketplace:

   

2. Добавьте репозиторий InstaVM:

   

3. Выполните Python-код с помощью Claude Code:

   

Готово! Claude Code теперь имеет доступ ко всем инструментам CodeRunner:

• execute_python_code — запуск Python-кода в постоянном Jupyter-ядре
• navigate_and_get_all_visible_text — веб-скрапинг с помощью Playwright
• list_skills — список доступных навыков (docx, xlsx, pptx, pdf, обработка изображений и др.)
• get_skill_info — документация по конкретному навыку
• get_skill_file — чтение файлов навыков и примеров

Подробнее: см. репозиторий плагина.

3. Конфигурация OpenCode

Создайте или отредактируйте ~/.config/opencode/opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "coderunner": {
      "type": "remote",
      "url": "http://coderunner.local:8222/mcp",
      "enabled": true
    }
  }
}

После сохранения конфигурации:

1. Перезапустите OpenCode
2. Инструменты CodeRunner станут доступны автоматически
3. Начните выполнять Python-код с полным доступом к изолированной среде

4. Python OpenAI Agents

1. Задайте ваш OpenAI API key:

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

2. Запустите клиент:

   python examples/openai_agents/openai_client.py

3. Начните работу: Вводите запросы вроде «write python code to generate 100 prime numbers» и наблюдайте за безопасным выполнением в песочнице!

5. Gemini CLI

Gemini CLI — недавно выпущен Google.

{
  "theme": "Default",
  "selectedAuthType": "oauth-personal",
  "mcpServers": {
    "coderunner": {
      "httpUrl": "http://coderunner.local:8222/mcp"
    }
  }
}

6. Kiro от Amazon

Kiro — недавно выпущен Amazon.

{
  "mcpServers": {
    "coderunner": {
      "command": "/path/to/venv/bin/python",
      "args": [
        "/path/to/coderunner/examples/claude_desktop/mcpproxy.py"
      ],
      "disabled": false,
      "autoApprove": [
        "execute_python_code"
      ]
    }
  }
}

7. Coderunner-UI (офлайн AI-рабочее пространство)

Coderunner-UI — собственный офлайн-интерфейс проекта.