OpenHands — это open-source платформа для software engineering agents: GUI, CLI, SDK и варианты под команды. Документация — docs.openhands.dev (также docs.all-hands.dev), продукт — openhands.dev. Локально обычно крутится через Docker/`uv`, UI на http://localhost:3000. Ниже — как пользоваться новичку без путаницы с Cline и Claude Code.
Соседи: Cline, Claude Code, Aider, Continue.dev, Amp. Pillar — n8n.
Для кого OpenHands
Берите OpenHands, если нужен отдельный agent-runtime с GUI/CLI и контролем над моделью и sandbox. Если хотите агента внутри VS Code без Docker — чаще Cline. Если дом — терминал Anthropic — Claude Code. Если JetBrains — Junie.
| Путь | Что ставите | Деньги (мягко) | Кому |
|---|---|---|---|
| Local GUI (`openhands serve`) | uv + Docker | $0 за софт; платите LLM | Соло / обучение агенту |
| Docker image | docker run :1.8 (пример доки) | $0 за софт; платите LLM | Быстрый подъём UI :3000 |
| OpenHands Cloud / LLM provider | аккаунт app.all-hands.dev | credits / refill (условия в кабинете) | Без своей возни с ключами моделей |
Источники: docs.openhands.dev (local-setup), openhands.dev, блог all-hands.dev про LLM provider (срез фактов август 2026). В доке: минимум около 4 ГБ RAM. Точные суммы cloud credits и promo меняются — смотрите кабинет, ₽ не выдумываем.
Как пользоваться: маршрут на 1 вечер
- Поставьте Docker (Mac/Linux/Windows+WSL2 по доке).
- Установите OpenHands через uv (рекомендованный путь доки):
uv tool install openhands --python 3.12. - Запустите GUI:
openhands serve(опции--mount-cwd,--gpu— по доке). - Откройте
http://localhost:3000и в Settings выберите LLM Provider + Model + API Key. - Дайте узкую задачу с критерием готово и путями репо (лучше с mount кода в sandbox по гайду доки).
- Поставьте spending limits у провайдера — агент легко уходит в длинные циклы.
# Рекомендованный старт (по docs.openhands.dev)
uv tool install openhands --python 3.12
openhands serve --mount-cwd
# Промпт в GUI (пример):
В смонтированном репо найди auth middleware.
Минимальный патч: логировать failed JWT без смены API.
Покажи diff. Не добавляй новые зависимости без спроса.Альтернатива без uv — docker run из local-setup (в актуальной доке пример с docker.openhands.dev/openhands/openhands:1.8, порт 3000, volume на docker.sock и ~/.openhands). Теги образов обновляются — копируйте команду из доки, не из памяти.
Типичные ошибки
- Ждать «бесплатный GPT-4 внутри» без API key / Cloud credits.
- Поднимать Docker на слабом железе ниже ориентира ~4 ГБ RAM.
- Давать агенту prod secrets без изоляции sandbox.
- Путать OpenHands (платформа) с одним конкретным LLM.
- Фиксировать в статье устаревший tag образа вместо команды из текущей доки.
FAQ: OpenHands
Что такое OpenHands?
OpenHands — open-source платформа software engineering agents: GUI, CLI, SDK и варианты для команд. Документация — docs.openhands.dev / docs.all-hands.dev, сайт — openhands.dev, GitHub — github.com/All-Hands-AI/OpenHands.
Сколько стоит OpenHands?
Локальный open-source runtime сам по себе без фиксированной подписки на расширение: вы платите LLM-провайдеру (Anthropic/OpenAI/Google/свой ключ) или берёте OpenHands LLM provider / Cloud credits. В блоге all-hands.dev упоминались стартовые cloud credits для новых пользователей — сумма и условия меняются, сверяйте app.all-hands.dev. ₽ и «вечный $X/мес» не фиксируем.
Как установить OpenHands локально?
По docs: Mac/Linux/Windows+WSL, Docker, рекомендуется от 4 ГБ RAM. Рекомендуемый путь: uv tool install openhands —python 3.12, затем openhands serve (GUI). Альтернатива — docker run на порту 3000 (в доке пример с образом openhands:1.8). UI: http://localhost:3000.
Чем OpenHands отличается от Cline и Claude Code?
OpenHands — полноценная agent-платформа (GUI/CLI/SDK/sandbox), часто через Docker. Cline — VS Code agent-extension. Claude Code — CLI-агент Anthropic. Выбор зависит от того, нужен ли вам отдельный GUI/sandbox или агент внутри уже привычного редактора.
Нужен ли API key?
Да для большинства cloud-моделей: в Settings выбираете LLM Provider/Model и вводите ключ (OpenHands Cloud key, Anthropic, OpenAI, Google и др.). Для local LLM без auth-proxy в доке допускается placeholder key.
Кому имеет смысл OpenHands?
Тем, кто хочет open-source agent с GUI/CLI и контролем над провайдером/sandbox. Если нужен агент строго внутри JetBrains/VS Code без Docker — чаще Junie, Cline или Continue.
Вывод
OpenHands — open-source agent-платформа с GUI/CLI: Docker/`uv` → localhost:3000 → ключ модели → узкая задача. Рядом по стеку: Cline (VS Code), Claude Code (CLI), Junie (JetBrains).
Хотите нейросети под свои задачи, а не «для всех»?
Когда базовых гайдов уже мало, помогает разбор под вашу работу. Наставничество, курсы и подписка Артём Денисов — все форматы на странице обучения. Тех-pillar — n8n для начинающих.