Короткий ответ: OpenCode V2 позволяет выбрать модель, настроить действия агента и подключить плагины. До первого запроса создайте правила permissions: без ваших правил базовая политика V2 разрешает инструменты, запрашивая подтверждение главным образом для внешних каталогов и чтения .env. Встроенный Plan запрещает обычные правки файлов проекта, но shell-команды управляются разрешениями и по умолчанию могут выполняться.

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

Первый запуск в тестовом проекте

  1. Прочитайте миграцию с V1 и сохраните копию конфигурации. V2 installer заменяет бинарник V1; пакетную установку V1 сначала удаляют по инструкции. Создайте тестовый каталог без производственных секретов.
  2. Положите opencode.jsonc в корень проекта либо в его .opencode/. В нём задайте разрешения, прежде чем общаться с агентом. Затем из каталога проекта запустите opencode.
  3. Для большинства облачных провайдеров в интерфейсе выполните /connect, затем /models. Локальный Ollama может обнаруживаться без подключения аккаунта. Выберите модель, проверив тариф и передачу данных.
  4. Попросите агента прочитать один файл и предложить план. При запросе разрешения выберите «один раз» либо отклоните. «Разрешить всегда» сохраняет правило для проекта; затем проверьте список сохранённых правил. Просмотрите diff перед тестами и коммитом.

Разрешения в V2

Правило содержит action, resource, effect со значениями allow, ask, deny. Последнее подходящее правило побеждает. Shell запускается с правами пользователя системы, поэтому задавайте узкие разрешения и проверяйте исключения.

{
  "$schema": "https://opencode.ai/config.json",
  "permissions": [
    {"action": "shell", "resource": "*", "effect": "ask"},
    {"action": "shell", "resource": "git status *", "effect": "allow"},
    {"action": "shell", "resource": "git push *", "effect": "deny"},
    {"action": "edit", "resource": "*", "effect": "ask"}
  ]
}

Это учебный пример, не полноценная политика защиты секретов. В V2 используются permissions, shell и subagent вместо V1 permission, bash и task. Build — основной агент с широким доступом, Plan планирует без обычного редактирования, General и Explore — встроенные субагенты; Scout в V2 отсутствует. Проверьте фактические правила для каждого агента.

Плагины: V1, V2 и обновление

В V2 пакеты перечисляются в массиве plugins, а локальные файлы и папки под .opencode/plugins/ обнаруживаются автоматически. Плагины, написанные для API V1, в V2 не работают без переноса на новый API: одного переименования ключа мало. Сохраните исходник и проверьте раздел миграции плагинов перед обновлением.

opencode plugin check проверяет обновления, opencode plugin update обновляет пакетные плагины. Локальные плагины и точно закреплённые ревизии команда пропускает; их меняют отдельно. Изменения в отслеживаемых конфигурационных каталогах обычно перезагружаются автоматически, а opencode reload перечитывает конфигурацию без перезапуска сервера. После изменения неотслеживаемой локальной зависимости может потребоваться opencode service restart. Любой сторонний плагин просмотрите до установки: он может влиять на рабочий процесс агента.

Нужно ли переписывать конфигурацию V1

V2 продолжает читать поддерживаемые настройки V1 и переводит их в памяти; немедленно конвертировать файл необязательно. Новые настройки лучше писать в формате V2. Не смешивайте V1 и V2 внутри одной вложенной записи агента, провайдера или команды и сохраните копию, если после установки потребуется возврат. Поскольку клиент и сервер обновляются, протестируйте правила и плагины в чистом проекте до рабочего репозитория.

Источники

Документация просмотрена 23.09.2026.

Материал пригодился?