Как установить OpenCode: open-source AI-агент для кода в терминале

OpenCode -- это открытый AI-агент для программирования, который работает прямо в терминале. Он занял лидирующую позицию среди open-source инструментов для написания кода с помощью AI: к апрелю 2026 года OpenCode набрал 147 тысяч звезд на GitHub и 6,5 миллиона активных разработчиков в месяц. Для сравнения -- Claude Code набирал такую же аудиторию почти вдвое дольше.

Инструмент написан на языке Go и предоставляет удобный текстовый интерфейс (TUI) прямо в вашем терминале. Вы видите чат с AI, список файлов проекта и историю сессий -- всё в одном окне, без необходимости переключаться между браузером и редактором. OpenCode работает в трех режимах: интерактивный TUI, одиночные команды для скриптов и безголовый сервер с API для автоматизации.

OpenCode подходит широкому кругу специалистов. Опытным разработчикам, которые ценят терминал и не хотят переходить на дорогие платные редакторы вроде Cursor или Windsurf. Студентам и начинающим программистам, которым нужен мощный AI-помощник без ежемесячной подписки. DevOps и системным администраторам, работающим удаленно через SSH. Всем, кто хочет использовать несколько AI-моделей в одном инструменте и не быть привязанным к конкретному провайдеру.

Принципиальное отличие OpenCode от платных альтернатив -- полная свобода выбора модели. Cursor привязан к своему API. Windsurf работает преимущественно через собственные серверы. OpenCode поддерживает 75 или более провайдеров и моделей через интеграцию с Models.dev: OpenAI GPT-5, Google Gemini 3, Anthropic Claude, Mistral, локальные модели через Ollama и многие другие. Вы сами выбираете, чем платить и кому доверять свой код.

В январе 2026 года GitHub официально объявил о партнерстве с OpenCode: все платные подписчики GitHub Copilot получили возможность использовать OpenCode с аутентификацией через GitHub без дополнительной настройки. Это дало проекту огромный импульс и фактически сделало его частью официальной экосистемы разработки на GitHub. Партнерство также означает, что OpenCode интегрирован с GitHub Actions и может автоматически запускаться в рамках CI/CD workflows для проверки кода, написания тестов и документации.

OpenCode устанавливается несколькими способами в зависимости от вашей операционной системы и предпочтений. Все способы бесплатны.

Самый простой способ -- через скрипт установки. Откройте терминал и выполните команду: curl -fsSL https://opencode.ai/install | bash. Скрипт автоматически определит вашу операционную систему, скачает нужный бинарный файл и установит его в /usr/local/bin. После этого команда opencode будет доступна глобально. Работает на macOS и Linux.

Установка через npm подходит для тех, у кого уже установлен Node.js: npm install -g opencode-ai. После установки проверьте версию командой opencode --version.

На macOS через Homebrew: brew install opencode-ai/tap/opencode. Homebrew автоматически установит зависимости и обновит OpenCode при выходе новых версий командой brew upgrade opencode.

На Windows через Scoop: scoop install opencode. Или через Chocolatey: choco install opencode. Для пользователей Windows также доступна установка через PowerShell с официального скрипта установки с сайта opencode.ai/download.

После установки нужно настроить хотя бы один AI-провайдер. Запустите opencode и в появившемся интерфейсе нажмите Ctrl+S или откройте настройки командой /settings. Введите API-ключ для нужного провайдера: OPENAI_API_KEY, ANTHROPIC_API_KEY или GOOGLE_AI_API_KEY. Если у вас есть GitHub Copilot -- просто нажмите кнопку входа через GitHub и авторизуйтесь без ручного ввода ключей.

После установки перейдите в папку с вашим проектом и запустите opencode. Вы увидите текстовый интерфейс с тремя панелями: слева -- дерево файлов проекта, в центре -- чат с AI, справа -- список открытых сессий и история.

Попробуйте первый запрос: напишите в чате explain this codebase и нажмите Enter. OpenCode автоматически считает структуру вашего проекта, проанализирует основные файлы и расскажет, как устроен код. Это занимает от 10 до 30 секунд в зависимости от размера проекта и выбранной модели.

Ключевое отличие от обычных AI-чатов -- OpenCode имеет полный доступ к файловой системе вашего проекта. Он может не только отвечать на вопросы, но и непосредственно создавать, редактировать и удалять файлы. Когда AI предлагает изменения в код, вы видите дифф с подсветкой изменений и можете одобрить или отклонить их нажатием одной клавиши.

Переключение между агентами. OpenCode имеет два встроенных агента: build (полный доступ к файлам, выполнение команд) и plan (только чтение, анализ кода). Переключение -- клавиша Tab. Начинайте с plan когда хотите разобраться в коде, и переходите в build когда готовы к изменениям.

Несколько полезных первых задач. Попросите OpenCode написать unit-тесты для конкретного файла: write unit tests for src/api/users.py using pytest. Или исправить ошибку: fix the bug in line 45 of main.go where the connection timeout is not handled. Или объяснить незнакомый код: explain what this regex does and when it might fail. Модель читает файлы, понимает контекст и дает ответы применительно к вашему реальному коду.

Для работы над большими задачами используйте режим одиночных команд: opencode ask "what are the main security vulnerabilities in this project" --output report.md. Это запускает OpenCode без интерфейса, выполняет запрос и сохраняет результат в файл. Удобно для автоматизации и использования в CI/CD пайплайнах.

Управление сессиями. OpenCode хранит историю разговоров локально в базе SQLite. Вы можете вернуться к любой предыдущей сессии командой /sessions, выбрать нужную и продолжить работу с того же места. Это особенно удобно при работе над долгосрочными задачами, когда нужно возвращаться к проекту через несколько дней и не терять контекст разговора с AI. Каждая сессия привязана к директории проекта, что позволяет держать разные проекты в разных контекстах.

75 или более AI-провайдеров через Models.dev. Это главное преимущество OpenCode перед всеми конкурентами. Вы подключаете любую модель: GPT-5.5 Instant от OpenAI, Gemini 3.1 Pro от Google, Claude Opus 4.7 от Anthropic, Mistral, DeepSeek V4, локальные модели через Ollama. Переключение между моделями -- одна команда в чате: /model. Если одна модель справляется хуже -- попробуйте другую без смены инструмента и без дополнительных подписок.

Поддержка MCP (Model Context Protocol). OpenCode интегрируется с экосистемой MCP, которая к марту 2026 года превысила 97 миллионов установок. Вы подключаете внешние инструменты как расширения: браузер для веб-скрейпинга, базы данных для прямых SQL-запросов, системы мониторинга для анализа логов. Конфигурация MCP-серверов -- через файл ~/.config/opencode/config.json.

LSP-интеграция (Language Server Protocol). OpenCode понимает структуру кода на уровне языкового сервера: символы, типы, ошибки компиляции, зависимости между функциями. Это дает AI более точный контекст, чем простое чтение файлов. Результат -- меньше галлюцинаций и более точные предложения по рефакторингу.

Безголовый режим и API. OpenCode запускается как локальный HTTP-сервер командой opencode --server. Это позволяет взаимодействовать с ним через REST API из любого приложения или скрипта. Например, вы можете автоматически запускать OpenCode для код-ревью при каждом коммите в Git, используя хук pre-commit.

Приватность по умолчанию. OpenCode не хранит ваш код и контекст сессий на своих серверах -- весь контекст остается у вас локально и передается только выбранному AI-провайдеру при каждом запросе. Это важно для работы с конфиденциальным корпоративным кодом. Сравните с Cursor, который передает метаданные о вашем коде на собственные серверы для обучения моделей.

Архитектура клиент-сервер. OpenCode может работать на удаленном сервере, а вы управляете им с локального компьютера или даже с мобильного устройства. Это особенно полезно для DevOps: запустите OpenCode на рабочем сервере через SSH и работайте с кодом прямо там, без необходимости скачивать репозиторий локально.

OpenCode сам по себе полностью бесплатный и открытый -- лицензия MIT. Скачивайте, модифицируйте, используйте в коммерческих проектах без ограничений. Вы платите только за использование AI-моделей, к которым подключаете OpenCode.

Через GitHub Copilot (от около 10 долларов в месяц на момент написания): если у вас есть активная подписка GitHub Copilot Individual или Business, вы автоматически получаете доступ к OpenCode с лимитами Copilot. Это самый экономичный вариант для разработчиков, которые уже платят за Copilot.

Через OpenAI API (pay-per-use): GPT-5.5 Instant стоит около 0,075 доллара за 1 миллион входящих токенов и около 0,30 доллара за 1 миллион исходящих на момент написания. Интенсивная работа на несколько часов обходится в 1-3 доллара при использовании базовой модели.

Через Anthropic API: Claude Opus 4.7 стоит около 5 долларов за 1 миллион входящих и 25 долларов за 1 миллион исходящих токенов -- это дорогой вариант для постоянной работы. Более экономично -- Claude Haiku, который в 20 раз дешевле при сопоставимом качестве для большинства задач кодирования.

Полностью бесплатный вариант: используйте OpenCode с локальными моделями через Ollama. Установите Ollama, скачайте Qwen3 или Llama 4 Scout, подключите к OpenCode через OLLAMA_API_KEY. Качество будет ниже топовых облачных моделей, но для простых задач вполне достаточно. Стоимость -- только электричество.

Важное ограничение: Anthropic в январе 2026 года временно ограничила использование Claude-моделей в OpenCode из-за нарушений условий использования некоторыми пользователями. На момент написания статус ограничений нужно уточнять на официальном сайте opencode.ai. Для надежности используйте OpenAI или Google модели как основной вариант.

OpenCode как программа устанавливается и работает без VPN в России -- это открытый исходный код, доступный на GitHub и через пакетные менеджеры. Сайт opencode.ai также, как правило, доступен без дополнительных инструментов.

VPN нужен только для подключения к отдельным AI-провайдерам. OpenAI API недоступен из России напрямую -- для использования GPT-моделей нужен VPN. Anthropic API также имеет региональные ограничения. Google AI API (Gemini) доступен в России через Google Cloud Platform при наличии корпоративного аккаунта.

Наилучший вариант для пользователей из России без VPN -- подключить OpenCode к локальным моделям через Ollama. Установите Ollama (ollama.com -- доступен в России), скачайте Qwen3 или DeepSeek-R1, подключите к OpenCode. Это полностью локальное решение без зависимости от зарубежных серверов и без необходимости VPN.

Если нужны лучшие облачные модели -- используйте VPN с серверами в США или Европе для OpenAI API. После получения API-ключа на platform.openai.com вы можете использовать его в OpenCode и без постоянно включенного VPN: ключ уже сохранен, и запросы к API идут напрямую от вашей машины.

Этот материал подготовлен командой AI-агентов AravanaAI и проверен главным редактором.