OpenCode: настройка ИИ-агента для вашего репозитория
OpenCode — агент для программирования с открытым исходным кодом, терминальным, настольным и веб-интерфейсами. Его полезность зависит от подключённой модели и контекста репозитория. Руководство опирается на документацию v2, проверенную 15 ноября 2026 года; старые инструкции могут использовать другие поля конфигурации. Руководство по установке описывает поддерживаемые пакеты и команду /connect.
Подключите репозиторий и провайдера
Установите подходящий для ОС выпуск, откройте каталог проекта и запустите opencode. Через /connect настройте провайдера, доступного вашей учётной записи. Работающий клиент не означает бесплатного использования модели: сохраняются тарификация и условия обработки данных провайдера.
Создайте opencode.jsonc в репозитории, добавив схему ниже. Справочник конфигурации объясняет проектные, глобальные и управляемые настройки. Проверьте эти уровни, если параметр не действует: управляемая конфигурация может переопределять проектную. Не помещайте секреты в отслеживаемые Git файлы.
Явно ограничьте команды
Этот пример v2 запрашивает подтверждение команд оболочки, запрещает отправку изменений и спрашивает разрешение перед доступом за пределы проекта:
{
"$schema": "https://opencode.ai/config.json",
"permissions": [
{ "action": "shell", "resource": "*", "effect": "ask" },
{ "action": "shell", "resource": "git push *", "effect": "deny" },
{ "action": "external_directory", "resource": "*", "effect": "ask" }
]
}
Действует последнее совпавшее правило; проверьте также переопределения конкретного агента. Это разрешения инструментов, а не изоляция средствами ОС. Справочник разрешений описывает действия и сопоставление шаблонов.
Исследуйте конкретный дефект
Если форма отправляется дважды, начните с Plan: «Проследи обработчик отправки и сетевой запрос. Объясни, почему один клик создаёт два запроса, и предложи минимальное исправление». Plan избегает изменения обычных файлов проекта, но команды оболочки по-прежнему контролируются разрешениями. Реализацию выполняет Build; различия описаны в справочнике агентов.
Передайте Build найденные файлы и критерии приёмки: один запрос на клик, прежняя валидация и регрессионная проверка повторной отправки. Попросите использовать существующий тестовый фреймворк и показать фактический вывод команд. Правдоподобное объяснение не доказывает корректность кода.
Проверьте результат перед внедрением
Изучите git diff, запустите относящийся к изменению тест и обязательные проверки репозитория, проверьте неожиданные изменения зависимостей и сгенерированных файлов. Сохраните чистую исходную точку в Git: отмена файловых изменений не отменяет удалённые операции или изменения базы данных. Сравнивайте провайдеров на одном дефекте, фиксируя время проверки, оставшиеся ошибки и реальные расходы. Так появляется полезное основание для выбора без выдуманных баллов и предположений об одинаковом поведении моделей.