OpenCode

OpenCode – AI-агент с открытым исходным кодом для разработки программного обеспечения, ориентированный на работу из терминала. Помимо терминального интерфейса (TUI), проект предоставляет desktop-приложение и расширения для IDE. Архитектура инструмента не привязана к одному поставщику моделей: пользователь самостоятельно подключает API выбранного LLM-провайдера либо использует OpenCode Zen – подборку моделей, протестированных командой проекта. Согласно официальной документации, OpenCode также поддерживает работу через GitHub Copilot и учетную запись ChatGPT Plus/Pro, а также подключение более чем 75 провайдеров моделей через Models.dev. Количество поддерживаемых провайдеров указано разработчиками; независимой верификации этого числа нет.

Основной сценарий использования – работа непосредственно внутри существующего репозитория. После инициализации агент анализирует структуру проекта и создает файл AGENTS.md, содержащий описание проекта и рекомендации для последующих сессий. Этот файл рекомендуется хранить в системе контроля версий, чтобы агент использовал накопленный контекст при следующих запусках.

Установка

Официальная документация поддерживает несколько способов установки:

  • install script: 
    curl -fsSL https://opencode.ai/install | bash
  • npm: 
    npm install -g opencode-ai
  • Bun, pnpm, Yarn;
  • Homebrew (brew install anomalyco/tap/opencode);
  • Arch Linux;
  • Chocolatey и Scoop для Windows;
  • Docker-образ.

После установки выполняется:

opencode

Затем рекомендуется выполнить:

/init

Команда анализирует репозиторий и создает AGENTS.md.

Базовые команды

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

  • opencode – запуск терминального интерфейса;
  • /init – анализ проекта и создание AGENTS.md;
  • /connect – настройка провайдера моделей;
  • /undo – отмена изменений;
  • /redo – повтор отмененных изменений;
  • /share – публикация ссылки на текущую сессию.

Также поддерживается поиск файлов через символ @ внутри запросов.

Настройка

OpenCode позволяет расширять поведение агента несколькими механизмами:

  • пользовательские slash-команды;
  • собственные настройки конфигурации;
  • кастомные keybindings;
  • настройка форматтеров кода;
  • использование AGENTS.md как постоянного контекста проекта.

Официальная документация также упоминает возможность создания custom commands. Подробных количественных ограничений (например, максимального числа команд или skills) не опубликовано.

Режим планирования

Одной из ключевых возможностей является Plan Mode.

В этом режиме агент не изменяет файлы проекта. Вместо этого он формирует план реализации задачи, предлагая последовательность изменений и подход к реализации. Переключение выполняется клавишей Tab в терминальном интерфейсе.

Такой режим позволяет проверить предполагаемые изменения до их применения, что удобно при работе с крупными изменениями или незнакомым кодом.

Выполнение и проверка плана

После согласования плана пользователь переключается обратно в обычный режим, где агент начинает выполнять предложенные изменения.

При необходимости изменения можно:

  • отменить (/undo);
  • повторить (/redo);
  • скорректировать запрос и получить новый вариант реализации.

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

Контроль выполнения плана

Контроль осуществляется несколькими механизмами:

  • режим планирования до внесения изменений;
  • возможность многократной отмены изменений;
  • повторное применение изменений;
  • совместное использование истории диалога через /share.

Кроме того, благодаря AGENTS.md агент использует накопленный контекст проекта при последующих запусках.

Подключение провайдеров моделей по API

OpenCode не требует использования собственного облачного сервиса.

После выполнения команды:

/connect

можно подключить API-ключ выбранного поставщика моделей.

Документация указывает поддержку:

  • OpenCode Zen;
  • Claude;
  • GPT;
  • Gemini;
  • локальных моделей;
  • других совместимых провайдеров через Models.dev.

Также заявлена возможность использовать существующую подписку GitHub Copilot или ChatGPT Plus/Pro. Список поддерживаемых моделей может изменяться между версиями проекта.

Особенности

По официальной документации OpenCode отличается несколькими особенностями:

  • открытый исходный код;
  • терминальный интерфейс, desktop-приложение и расширения IDE;
  • автоматическая загрузка подходящих LSP для проекта;
  • создание AGENTS.md;
  • режим планирования без изменения файлов;
  • поддержка нескольких параллельных сессий (Multi-session);
  • публикация ссылок на диалоги (/share);
  • независимость от конкретного поставщика LLM.

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

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

Основные сценарии использования:

  • навигация по большим существующим кодовым базам;
  • постепенное внедрение новых функций;
  • рефакторинг с предварительным планированием;
  • изучение незнакомых проектов;
  • генерация и изменение кода из терминала;
  • использование собственных API-ключей различных LLM;
  • работа в командах с обменом ссылками на сессии;
  • проекты, где требуется сохранять долгосрочный контекст разработки через AGENTS.md.

Веб-сайт: https://opencode.ai