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

CodeRunner помогает изолировать ваших ИИ-агентов и их действия внутри песочницы.

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

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

Предварительные требования: 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

Остановка и возобновление

Остановите песочницу, когда закончите работу:

container stop coderunner

Позже возобновите работу той же песочницы, сохранив загрузки, ядра и установленные пакеты:

container start coderunner

Чтобы начать заново с чистой песочницей, удалите контейнер и снова запустите установщик:

container delete coderunner && ./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):

pip install -r examples/requirements.txt

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

Настройка Claude Desktop для использования CodeRunner в качестве MCP-сервера:

demo1

demo2

demo4

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

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

Отредактируйте файл конфигурации и замените пути-заглушки:
- Замените /path/to/your/python на ваш реальный путь к Python (например, /usr/bin/python3 или /opt/homebrew/bin/python3)
- Замените /path/to/coderunner на фактический путь к вашему клонированному репозиторию
Пример после редактирования:
```
{
  "mcpServers": {
    "coderunner": {
      "command": "/opt/homebrew/bin/python3",
      "args": ["/Users/yourname/coderunner/examples/claude_desktop/mcpproxy.py"]
    }
  }
}
```
Обновите конфигурацию Claude Desktop:
- Откройте Claude Desktop
- Перейдите в Settings → Developer
- Добавьте конфигурацию MCP-сервера
- Перезапустите Claude Desktop
Начните использовать CodeRunner в Claude: Теперь вы можете попросить Claude выполнить код, и он будет безопасно выполняться в песочнице!

2. Claude Code CLI

Использование CodeRunner с Claude Code CLI для терминальной ИИ-помощи:

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

# 1. Install and start CodeRunner (one-time setup)
git clone https://github.com/instavm/coderunner.git
cd coderunner
sudo ./install.sh

# 2. Install the Claude Code plugin
claude plugin marketplace add https://github.com/instavm/coderunner-plugin
claude plugin install instavm-coderunner

# 3. Reconnect to MCP servers
/mcp

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

Перейдите в Plugin Marketplace:
Добавьте репозиторий InstaVM:
Выполняйте 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

Настройка OpenCode для использования CodeRunner в качестве MCP-сервера:

Пример OpenCode

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

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

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

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

4. Python-агенты OpenAI

Использование CodeRunner с библиотекой Python-агентов OpenAI:

demo3

Укажите ваш ключ OpenAI API:

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

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

python examples/openai_agents/openai_client.py

Начинайте кодить: Вводите запросы вроде «напиши python-код для генерации 100 простых чисел» и наблюдайте, как он безопасно выполняется в песочнице!

5. Gemini-CLI

Gemini CLI недавно запущен компанией Google.

~/.gemini/settings.json

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

gemini1

gemini2

6. Kiro от Amazon

Kiro недавно запущен компанией Amazon.

~/.kiro/settings/mcp.json

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

kiro

coderunner

Популярное