OpenCode -- открытый AI-агент для разработчиков, работающий полностью в терминале. По состоянию на июнь 2026 года проект набрал более 178 тысяч звёзд на GitHub и является самым популярным open-source агентом для кодирования в мире. Более 7,5 миллиона разработчиков используют OpenCode ежемесячно. В отличие от коммерческих аналогов -- Cursor, Windsurf, Claude Code -- OpenCode бесплатен как продукт, полностью открыт под MIT-лицензией и позволяет подключить любую языковую модель: от Anthropic Claude и OpenAI GPT до локальных моделей через Ollama.

Ключевая идея: разработчик не привязан ни к одному AI-провайдеру. OpenCode поддерживает более 75 LLM-провайдеров через OpenAI-совместимый API, включая Anthropic, OpenAI, Google Gemini, xAI Grok, Mistral, Ollama и Snowflake Cortex. Это означает полный контроль над расходами: вы платите напрямую выбранному провайдеру по его тарифам, без наценки платформы.

OpenCode написан на Go, что обеспечивает быстрый запуск и минимальное потребление памяти. Терминальный интерфейс построен на TUI (Text User Interface) -- полноценный интерактивный экран прямо в консоли, без необходимости открывать браузер или отдельное приложение.

Для кого OpenCode подходит лучше всего: разработчики, работающие преимущественно в терминале и SSH; команды, которым важна прозрачность и возможность аудита кода самого агента; те, кто хочет использовать дешёвые или локальные модели без подписки; backend-разработчики на Linux и в серверных средах без графического интерфейса; разработчики, работающие с несколькими AI-провайдерами одновременно.

Чтобы выбрать инструмент осознанно, важно понять принципиальные отличия:

Общий вывод: если вам нужен GUI и инлайн-подсказки прямо в редакторе, рассмотрите Cursor или Windsurf. Если важна открытость, гибкость в выборе модели и работа в терминале -- OpenCode или Claude Code. OpenCode выигрывает у Claude Code там, где важна независимость от конкретного провайдера.

Актуальная версия на момент написания: v1.17.8 (обновление от 21 июня 2026). Требуется Node.js 20 или выше.

Через npm (рекомендуется для большинства разработчиков):

npm install -g opencode-ai
opencode --version

Через bun (быстрее на macOS и Linux, особенно при первой установке):

bun install -g opencode-ai

Через Homebrew (macOS, получает автоматические обновления через brew upgrade):

brew install opencode-ai/tap/opencode

Через winget (Windows):

winget install OpenCode.OpenCode

На Windows рекомендуется установка через WSL2 с использованием Linux-пакета -- это даёт полноценный опыт работы без ограничений Windows-терминала. Исполняемые бинарные файлы для всех платформ доступны в разделе Releases на GitHub репозитория opencode-ai/opencode.

Обновление до последней версии через npm:

npm update -g opencode-ai

После установки запустите opencode в терминале из директории вашего проекта. При первом запуске агент предложит несколько вариантов авторизации:

Конфигурация сохраняется в ~/.config/opencode/config.toml. После авторизации OpenCode показывает домашний экран с последними сессиями. Каждая сессия сохраняется автоматически и позволяет вернуться к незавершённой задаче в любой момент.

OpenCode поддерживает любой OpenAI-совместимый провайдер. Конфигурация задаётся в файле ~/.config/opencode/config.toml:

Anthropic Claude:

[provider.anthropic]
api_key = "sk-ant-..."

[model]
default = "claude-sonnet-4-6"

OpenAI:

[provider.openai]
api_key = "sk-..."

[model]
default = "gpt-4o"

Google Gemini:

[provider.google]
api_key = "AIza..."

[model]
default = "gemini-2.5-flash"

Ollama (локальные модели): сначала установите Ollama (ollama.com) и загрузите модель (ollama pull llama3.2), затем добавьте в конфиг:

[provider.ollama]
base_url = "http://localhost:11434"

[model]
default = "ollama/llama3.2"

Переключение модели в активной сессии: нажмите m или введите /model. Можно переключаться между провайдерами прямо в процессе работы -- используйте дешёвые быстрые модели для рутины и переключайтесь на более мощные для сложных задач.

Два встроенных агента, переключение клавишей Tab:

ACP shell tool calls: OpenCode поддерживает ACP (Agent Communication Protocol) shell tools -- при выполнении команды агент указывает явно и саму команду, и рабочую директорию. Вы видите точно что и где будет исполнено, и подтверждаете действие до его выполнения. Это принципиальное отличие от инструментов, где команды выполняются в «чёрном ящике» без явного контроля.

Plugin client reuse: Если у вас уже запущен языковой сервер (LSP) в VS Code или другом редакторе, OpenCode переиспользует его подключение вместо запуска нового инстанса. Это ускоряет работу и снижает потребление оперативной памяти при совместном использовании редактора и терминального агента.

MCP-серверы в рабочем пространстве: OpenCode поддерживает MCP (Model Context Protocol) серверы на уровне проекта. Создайте файл .mcp/config.json в корне репозитория, и агент автоматически подключит общие инструменты для всей команды -- базы данных, внутренние API, системы документации, трекеры задач.

Встроенный diff viewer: Перед применением изменений OpenCode показывает diff прямо в терминале с подсветкой добавленных и удалённых строк. Дерево файлов сворачивает директории с изменениями для удобного обзора. Принять или отклонить изменение можно одной клавишей без выхода из сессии.

Параллельные инструменты: OpenCode читает несколько файлов и выполняет независимые операции параллельно, что ускоряет анализ крупных кодовых баз до 3 раз по сравнению с последовательным выполнением -- особенно заметно на монорепозиториях с сотнями файлов.

При запуске без аргументов OpenCode показывает домашний экран со списком последних сессий. Каждая запись отображает краткое описание задачи, дату последнего обращения и количество сообщений в сессии.

Горячие клавиши домашнего экрана:

Для запуска с конкретной задачей напрямую из командной строки, минуя интерактивное меню:

opencode "Добавь unit-тесты для модуля auth/"

Это создаёт новую сессию с заданным промптом и запускает агент немедленно без промежуточных экранов.

Понимание незнакомого кода. Переключитесь в plan-агент (Tab) и задавайте вопросы: «Объясни, как здесь реализована аутентификация», «Найди все места, где вызывается функция processPayment», «Почему здесь используется Saga-паттерн вместо Redux Thunk». Агент читает весь репозиторий и отвечает в контексте конкретного кода, а не абстрактно.

Рефакторинг кодовой базы. Переключитесь на build-агент. Опишите задачу: «Перенеси всю логику работы с базой данных из controllers/ в отдельный слой repositories/». Агент составит пошаговый план, покажет список затрагиваемых файлов и запросит подтверждение перед каждым шагом. Для масштабных задач используйте флаг --max-iterations:

opencode "Перенеси все обращения к устаревшему API v1 на v2 согласно документации в MIGRATION.md" --max-iterations 50

Отладка. Запустите тест, скопируйте stack trace и передайте агенту: «Тест падает с этой ошибкой -- найди причину и исправь». OpenCode читает полный вывод терминала и анализирует код в контексте всего проекта. Для анализа без изменений: opencode -r запускает режим только для чтения.

Генерация тестов. OpenCode понимает тестовый фреймворк, используемый в проекте, и генерирует тесты в том же стиле, что и существующий код:

opencode "Напиши unit-тесты для src/utils/validation.ts с покрытием граничных случаев"

Code review перед PR. Запустите анализ изменений перед созданием pull request: opencode "Найди потенциальные баги, проблемы безопасности и нарушения code style" --context git-diff. Агент анализирует только изменённые файлы и выдаёт структурированный список замечаний.

Версия v1.17.7 (17 июня 2026) включает следующие возможности:

Начинайте с plan-агента. Перед внесением изменений потратьте несколько минут на вопросы в режиме только для чтения. Это помогает агенту накопить нужный контекст и избежать архитектурных ошибок. Типичный рабочий процесс: plan-агент для исследования, затем build-агент для реализации.

Разделяйте модели по задачам. Для простых задач -- форматирование, мелкие правки, генерация комментариев -- используйте быстрые и дешёвые модели (Gemini Flash, GPT-5.5 Instant). Переключайтесь на мощные (Claude Sonnet, GPT-5.5) только для сложного рефакторинга или глубокого анализа. Переключение занимает секунду прямо в сессии.

Настройте .opencode/ignore. Создайте файл .opencode/ignore в корне проекта (синтаксис как .gitignore), чтобы агент не индексировал node_modules, dist/, build/ и другие директории без исходного кода. Это ускоряет запуск и снижает расход токенов.

MCP для командной работы. Если несколько разработчиков используют OpenCode в одном проекте, разместите конфигурацию MCP-серверов в репозитории (.mcp/config.json), а не только в личной конфигурации. Все участники команды автоматически получат доступ к общим инструментам при клонировании репозитория.

Флаг --max-iterations для долгих задач. По умолчанию агент ограничен определённым числом шагов. Для масштабных рефакторингов увеличьте лимит: opencode "задача" --max-iterations 100. Следите за расходом токенов при больших значениях.

OpenCode не видит изменения файлов в реальном времени. Причина: кэш файловой системы. Решение: запустите с флагом --no-cache или выполните /refresh в активной сессии для принудительного обновления индекса.

Ошибка «context too long» на больших проектах. Настройте max_context_files в ~/.config/opencode/config.toml: уменьшите лимит индексируемых файлов или добавьте директории в .opencode/ignore. Также помогает запуск из поддиректории проекта вместо корня монорепозитория.

Медленная работа с TypeScript монорепозиториями. Включите инкрементальный режим: opencode config set incremental_index true. Первая индексация займёт больше времени, но последующие запуски ускорятся значительно.

Ошибки авторизации с Ollama. Убедитесь что Ollama запущена (ollama serve) и модель загружена (ollama list). Проверьте значение base_url в конфиге -- по умолчанию должно быть http://localhost:11434.

Конфликт портов LSP. Если OpenCode не может переиспользовать LSP-клиент, проверьте, что языковой сервер запущен в вашем редакторе. При необходимости отключите переиспользование: установите lsp_reuse = false в config.toml.

OpenCode -- зрелый open-source инструмент с производительностью, сравнимой с коммерческими аналогами. Версия v1.17.7 предлагает параллельное выполнение инструментов, MCP-серверы, встроенный diff viewer и поддержку 75+ LLM-провайдеров. Самостоятельная MIT-лицензия обеспечивает полную прозрачность кода и отсутствие зависимости от условий подписки.

Выбирайте OpenCode, если: работаете преимущественно в терминале; хотите контролировать выбор AI-модели и расходы; вам важна открытость кода агента; работаете на Linux или в серверных средах. Если важны инлайн-подсказки в GUI и визуальный опыт -- рассмотрите Cursor или Windsurf в дополнение.

OpenCode v1.17.8 (21 июня 2026) -- улучшения производительности: Версия v1.17.8 включает ускорение загрузки временных шкал сессий (session timelines) -- история предыдущих разговоров теперь открывается быстрее при длинных проектах. Исправлена ошибка в схеме MCP-инструментов для OpenAI-провайдеров: при передаче функций с дополнительными полями схема теперь корректно обрабатывается без ошибок валидации. Обновление применяется командой npm update -g opencode-ai.

OpenCode занял первое место в рейтинге LogRocket (июнь 2026): Авторитетный обзор инструментов разработки LogRocket поставил OpenCode на первое место среди AI-ассистентов для кода в июне 2026 года, обойдя Cursor. Критерии: скорость работы, гибкость выбора модели, качество работы с контекстом, открытый исходный код. Рейтинг отражает растущую популярность: более 178 тысяч звёзд на GitHub делают OpenCode самым быстрорастущим open-source инструментом для разработки.

MCP resource templates: параметризованные шаблоны для подключения к MCP-серверам без ручного конфига. OAuth callback: безопасная авторизация в корпоративных системах прямо из терминала. --mini CLI mode: ультракомпактный режим для работы в ограниченных окружениях (CI/CD, Docker с малым объемом ресурсов). Opencode-managed provider integration: OpenCode теперь может подключаться к AI-провайдерам без ручного управления API-ключами - провайдер настраивается через интерфейс opencode.ai и учётные данные хранятся централизованно, что упрощает командную настройку.

С версии v1.18 OpenCode поддерживает локальные open-source-модели через Ollama, llama.cpp и LM Studio. Для настройки укажите URL сервера в opencode.jsonc (ключ ollama.url или llamacpp.url). Рекомендуемые модели: qwen2.5-coder:7b-16k или Qwen3 Coder 30B (требует контекст 64k+). Это позволяет работать без API-ключей при наличии совместимого GPU.

OpenCode v1.17.13 (6 июля 2026). Вышла актуальная версия open-source терминального агента. Ключевые исправления: стабилизирована работа с репозиториями более 10 000 файлов, улучшена совместимость при параллельном использовании нескольких MCP-серверов, исправлен сбой при работе в Windows Terminal. Обновление: go install github.com/sst/opencode@v1.17.13 или через менеджер пакетов вашей системы. Проверьте версию командой opencode --version.

Новые возможности OpenCode v1.17.10. Флаг --mini запускает агент в экономичном режиме с уменьшенным контекстным окном - снижает расход токенов при работе с простыми однофайловыми задачами. MCP resource templates - шаблоны ресурсов для MCP-серверов: агент динамически обращается к структурированным источникам данных (базы данных, файловые системы, внешние API) без ручного описания каждого источника. OAuth-bound callbacks: безопасная привязка авторизованных callback-адресов к конкретному OAuth-токену, что предотвращает перехват авторизации в публичных сетях.

OpenCode v1.17.15 (7 июля 2026). Вышло актуальное обновление open-source терминального агента. Основные изменения: добавлены варианты GLM-5.2 high и GLM-5.2 max с режимами повышенного "мышления" (thinking) от Zhipu AI, доступные в пикере моделей. Улучшен десктопный выбор файлов и папок (desktop file/folder picker v2): новый макет отображает путь и превью выбранного объекта, поддерживает множественный выбор. Обновите командой go install github.com/sst/opencode@v1.17.15 или через менеджер пакетов.

Быстрая загрузка таймлайна сессий и исправление MCP-схем. В v1.17.15 устранено мерцание (flicker) при открытии и прокрутке истории сессий: таймлайн загружается мгновенно даже при большом количестве сообщений. Исправлена ошибка валидации схемы инструментов MCP для OpenAI-совместимых провайдеров (ряд провайдеров возвращал несовместимые JSON-схемы, что приводило к сбою выполнения инструментов). Также устранена проблема передачи API-ключей через Cloudflare AI Gateway.

OpenCode v1.17.17 (9 июля 2026). Обновление улучшает работу с моделями Meta: исправлена обработка вариантов с расширенным мышлением (reasoning variants) при выборе провайдера. Добавлено всплывающее введение во вкладки (tabs intro popup) с возможностью закрытия - новые пользователи получают краткий тур по интерфейсу при первом запуске. Обновлены строки задач субагентов (sub-agent task rows) для лучшего отображения прогресса. Введён селектор бесплатных моделей версии 2 (v2 free-model selector) - обеспечивает более быстрый доступ к бесплатным провайдерам и упрощает первоначальную настройку без API-ключей.

OpenCode v1.17.18 (9 июля 2026). Критическое исправление: устранён сбой (crash), возникавший при использовании GitHub Copilot в случае, когда провайдер возвращал модели с нулевым размером батча для биллинга (zero billing batch size). Добавлена поддержка специфичного системного промпта для модели Meta Muse Spark - это позволяет точнее настроить поведение агента при работе с данной моделью. Обновление рекомендуется всем пользователям, использующим GitHub Copilot в качестве провайдера.

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