OpenCode — бесплатный open-source AI-агент для кодинга, который главным образом ценится за то, что работает из коробки: бесплатные модели уже внутри, регистрация и API-ключи не нужны, и он доступен в России без VPN и прокси. Для знакомства с агентским кодингом это едва ли не лучшая точка входа (что такое агентный кодинг вообще — в статье «Что такое агентный кодинг»). Ниже — чем он хорош, как поставить за две минуты и что делать, когда закончатся бесплатные лимиты.
Почему OpenCode — хороший первый агент
- Бесплатные модели сразу, без регистрации и ключей. Через встроенную платформу Zen доступны бесплатные модели — DeepSeek V4 Flash, MiMo-V2.5 и другие — и они работают без подписки: установил, открыл, выбрал модель — работаешь. Подписки Zen и Go — опциональные надстройки, для старта не нужны. Если захотите пользоваться Zen как провайдером (более широкий список моделей), понадобится ключ — он выдаётся на opencode.ai/auth и подключается командой
/connect. - Работает в России без VPN. Claude, Cursor, OpenRouter и ряд других сервисов в РФ напрямую недоступны. OpenCode — работает, это проверено на практике: реальный опыт использования с лимитами и плюсами-минусами — в статье «Как стать вайбкодером».
- Open source. Репозиторий anomalyco/opencode: порядка 193 000 звёзд (август 2026), 900+ контрибьюторов, около 7,5 млн разработчиков в месяц.
- Приватность по умолчанию. OpenCode не хранит ваш код и контекст на своей стороне — заявлено как принцип работы.
- Не привязан к редактору. Один движок доступен в трёх интерфейсах: терминал, десктоп-приложение и веб-версия, плюс расширения для IDE.
Три интерфейса: что выбрать новичку
| Интерфейс | Что это | Кому подходит |
|---|---|---|
| Терминал (TUI) | полноэкранный интерфейс в терминале | тем, кто живёт в консоли; самый «каноничный» вариант |
| Десктоп-приложение | отдельная программа для macOS, Windows, Linux (beta) | большинству новичков — ничего дополнительно ставить не нужно |
| Веб-версия | тот же агент в браузере | когда не хочется ставить ничего вообще |
Новичку проще начать с десктоп-приложения или веб-версии, а терминал оставить на потом — он никуда не денется.
Установка: все способы
| Способ | Команда / что делать | Когда удобно |
|---|---|---|
| install-скрипт | curl -fsSL https://opencode.ai/install \| bash |
рекомендуемый; macOS, Linux, WSL |
| npm | npm install -g opencode-ai |
если Node.js уже установлен |
| bun | bun install -g opencode-ai |
если используете bun |
| Homebrew | brew install anomalyco/tap/opencode |
macOS с Homebrew; свежая версия из официального tap |
| бинарник | скачать с GitHub Releases | когда не хочется менеджеров пакетов |
| десктоп-приложение | скачать с opencode.ai | проще всего для новичков |
| веб-версия | открыть в браузере, ничего не ставить | когда установка вообще не нужна |
Проверить установку в терминале:
opencode --version
Если команда не найдена — перезапустите терминал (PATH обновится после установки).
Windows
Самый простой путь — десктоп-приложение (скачивается с сайта, работает в Windows напрямую) или веб-версия в браузере. Для терминального варианта OpenCode ставят внутрь WSL, как и другие Linux-инструменты: установка WSL, затем тот же install-скрипт внутри WSL. Держите проект на файловой системе Linux (не в /mnt/c/...), иначе работа с файлами будет заметно медленнее. Подробности — в документации OpenCode на Windows (WSL).
Первый запуск: модели уже внутри
- Запустите OpenCode (десктоп, терминал или веб).
- Выберите бесплатную модель — например DeepSeek V4 Flash.
- Пишите задачу обычными словами, можно по-русски: «сделай простую тудушку на Python», «объясни, что делает этот модуль», «сверстай страницу по этому описанию».
В терминальной версии пригодятся команды: /init — агент изучит проект и создаст файл-конвенций AGENTS.md; режимы Build (сразу вносит изменения) и Plan (сначала показывает план); /undo — откат последнего изменения.
Лимиты бесплатных моделей (честно)
Бесплатные модели не безграничны, и это нормально:
- Ориентировочно ~200 запросов или ~50 млн токенов за несколько часов, плюс суточный лимит. Ограничение временное (обычно 3–8 часов) и общее на все бесплатные модели — переключаться между ними смысла нет.
- Цифры периодически меняются — актуальные условия в документации OpenCode Zen, раздел про лимиты.
- Если упёрлись в лимит, варианты: подождать; включить VPN (по опыту, для иностранных IP лимиты выше); оформить подписку OpenCode Go — $5 за первый месяц, далее $10/мес, токены на популярные открытые модели, включая DeepSeek V4 Flash; или подключить свой провайдер.
Для первого знакомства бесплатных лимитов хватает с запасом: типичные «попробовать, что это такое» задачи — это десятки запросов, а не сотни.
Подключение своих моделей (для тех, кому мало)
Если бесплатных моделей не хватает или хочется флагманских — OpenCode подключает и их: Claude, GPT, Gemini и ещё 75+ провайдеров (включая локальные модели через Ollama и подобное). Настроить можно через меню провайдеров в интерфейсе, переменные окружения (ANTHROPIC_API_KEY, OPENAI_API_KEY и т.п.) или файл конфига opencode.json. Детали — в документации: Providers и Config. Для стартовой статьи это не обязательно: из коробки всё уже работает.
Типичные проблемы
- Обрывы соединения из РФ — если OpenCode периодически «отваливается» с ошибками соединения, настройте прокси через переменную окружения
HTTPS_PROXY; детали — в документации Network. command not found: opencode— перезапустите терминал; при установке через npm проверьте, что глобальная папка npm в PATH.- Упёрся в лимит — подождите несколько часов, включите VPN или оформите OpenCode Go (см. раздел про лимиты).
- Медленно в WSL — проект лежит в
/mnt/c/; перенесите в домашнюю папку WSL. - Терминал «не тянет» TUI — используйте современный терминал (WezTerm, Ghostty, Alacritty, Kitty) или переходите на десктоп/веб-версию.
Итог
OpenCode — пожалуй, самый простой способ начать с агентного кодинга: бесплатные модели из коробки, никакой регистрации и ключей, работает в России без VPN, open source. Установка — две минуты; дальше — маленькая задача, и всё станет понятно.
Дальше по серии: файлы-конвенции AGENTS.md, MCP-серверы, пошаговые гайды по другим агентам. Начало — в статье «Что такое агентный кодинг», а реальный опыт использования с лимитами и подводными камнями — на spryt.ru.
