OpenClaude Portable — AI-агент для кода, который запускается с USB-флешки

OpenClaude Portable — это полностью портативная сборка AI-агента для программирования: скопируйте папку проекта на USB-накопитель или в любую директорию, запустите один скрипт — и агент работает, не оставляя на хост-машине ни файла. В основе лежит опенсорсный движок OpenClaude, а обёртка-лаунчер добавляет к нему самодостаточный рантайм Node.js, прокси для ускорения локальных моделей и веб-дашборд. Вся настройка сводится к одному файлу START.bat (Windows) или start.sh (Linux/macOS).

Формула проекта звучит так: «Plug in. Launch. Code» — воткнул флешку, запустил, работаешь. Проект набрал более 1,3 тысячи звёзд на GitHub, распространяется по лицензии MIT, у авторов есть видео с демо и настройкой.

Зачем это нужно

Сценарий у проекта вполне практический: рабочий компьютер, на который нельзя ничего устанавливать; чужая машина; терминал без прав администратора; учебный класс. Если AI-агент живёт целиком на флешке, достаточно иметь порт USB — и привычное окружение с историей сессий, ключами API и настройками всегда с собой.

Ключевые особенности из README:

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

На Windows достаточно запустить:

.\START.bat

При первом запуске скрипт сам скачает Node.js (~25 МБ) и движок OpenClaude (~5 МБ), после чего проведёт через выбор провайдера. Все последующие запуски пропускают настройку и сразу показывают меню. На Linux и macOS:

chmod +x start.sh
./start.sh

Интернет нужен только при первичной настройке. Дальше сетевые вызовы требуются лишь для обращения к API выбранного провайдера — а в режиме Ollama можно работать полностью офлайн.

Главное меню выглядит так:

1) Launch AI       — Normal Mode      (asks before writing files or running commands)
2) Limitless Mode  — Auto-executes    (fully autonomous, no approval prompts)
3) Open Dashboard  — Web UI at http://localhost:3000
4) Change Provider — Switch model or API key
5) Setup Offline   — Download local Ollama models

Если не нажать ни одну клавишу за 10 секунд, автоматически выбирается Normal Mode — агент сначала спрашивает разрешение перед записью файлов и запуском команд.

Структура проекта

Всё, что нужно агенту, лежит внутри одной папки:

OpenClaude-Multi-Platform/
│
├── START.bat                  Windows entry point — handles everything
├── start.sh                   Linux/macOS entry point
├── RESUME.bat                 Resume a previous session by ID (Windows)
│
├── data/                      All persistent data (shared across platforms)
│   ├── ai_settings.env        Active provider, model, and API key
│   ├── openclaude/            Session history and agent memory
│   ├── ollama/                Local Ollama binary and model storage
│   └── proxy.log              Speed proxy activity log
│
├── engine/                    Node.js runtime + OpenClaude npm package
│
├── tools/                     Helper scripts
│   ├── local-proxy.js         System-prompt trimming proxy for local models
│   ├── change_provider.sh     Switch AI provider or API key
│   └── open_dashboard.sh      Launch web dashboard
│
└── dashboard/                 Web dashboard UI
    ├── server.mjs             Dashboard Node.js server
    └── index.html             Chat interface

Девять провайдеров: от бесплатных тарифов до полного офлайна

Отдельная сила проекта — гибкость в выборе модели. Есть бесплатные варианты для экспериментов, платные API для серьёзной работы и локальные модели для конфиденциальных задач:

Поддержка LM Studio и произвольных OpenAI-совместимых эндпоинтов устроена одинаково: лаунчер спрашивает base URL (обычно заканчивается на /v1), ключ API и имя модели, которую при возможности подтягивает автоматически через /models. Конфигурация сохраняется в переменные окружения вроде OPENAI_BASE_URL и OPENAI_MODEL, так что подобрать бэкенд можно практически любой.

Speed-прокси: главная инженерная находка

Локальная модель на CPU — это медленно, и главная причина не в самом инференсе, а в огромных системных промптах, которыми агентные харнесы «кормят» модель. Встроенный speed-прокси (tools/local-proxy.js) перехватывает каждый запрос к Ollama и сокращает системный промпт OpenClaude примерно с 10 000 токенов до 300.

Результат по данным проекта: время до первого токена падает с 60–120 секунд до 5–20 секунд на чистом CPU. Активность прокси пишется тихо в data/proxy.log, не засоряя терминал.

Для CPU-инференса авторы рекомендуют компактные модели:

Практический совет: если узкое место — скорость чтения USB 2.0, скопируйте папку data/ollama/ на локальный SSD.

Безопасность и приватность

Zero Footprint здесь реализован буквально: переменные XDG_CONFIG_HOME, XDG_DATA_HOME и CLAUDE_CONFIG_DIR перенаправляются в папку data/, так что хост-система остаётся чистой. Остальные пункты:

• Без телеметрии — данные уходят только к выбранному AI-провайдеру;
• Ключи API хранятся исключительно в data/ai_settings.env на вашем накопителе;
• Approval Mode — в Normal Mode агент спрашивает подтверждение перед каждой записью файла и каждой shell-командой;
• Limitless Mode — полная автономия по вашему явному выбору, а не по умолчанию.

Системные требования

• Windows: 10 или новее — Node.js идёт в комплекте;
• Linux / macOS: нужен только curl (предустановлен почти везде);
• Диск: ~150 МБ под Node.js и движок, локальные модели Ollama — ещё от 800 МБ до 8 ГБ в зависимости от модели.

В README есть подробный раздел troubleshooting: от ошибок скачивания Node.js до конфликтов портов (11435 для прокси, 3000 для дашборда) и проблем с медленной установкой на USB-носителях — авторы советуют для первого запуска использовать USB 3.x или ставить на внутренний диск, а потом копировать готовую папку на флешку.

Для кого подходит

OpenClaude Portable стоит попробовать, если вы:

1. Работаете на машинах, куда нельзя ничего ставить — корпоративные ограничения, учебные классы, клиентские окружения;
2. Хотите агент с собой — история сессий, память и ключи живут на одном накопителе и переезжают между компьютерами;
3. Экспериментируете с локальными моделями — связка speed-прокси и Ollama делает агент на CPU хотя бы отзывчивым;
4. Ищете бесплатный вход в агентный кодинг — NVIDIA NIM, OpenRouter и Gemini дают бесплатные квоты, а Ollama вообще не требует сети.

Проект — хорошая иллюстрация того, куда движется экосистема AI-агентов: если движок опенсорсный, а зависимости самодостаточны, то сама идея «установки» софта становится опциональной. Агент для кода, который живёт в кармане, — уже не концепт, а работающий инструмент.

Ссылка на проект: https://github.com/techjarves/OpenClaude-Portable