Руководство по настройке AI-провайдеров

Настройка OpenCode

OpenCode — это терминальный ИИ-ассистент для написания кода с открытым исходным кодом. Он отлично подходит для ответов на вопросы по коду, изменения файлов и переключения моделей внутри каталога проекта. Новичкам рекомендуется сначала воспользоваться встроенным мастером подключения и избегать ручного составления полного JSON-файла на первых порах.

Официальная информация Загрузки и документацию см. на официальном сайте.

Официальный сайт OpenCode Опенсорсный терминальный ИИ-ассистент для написания кода Документация Инструкции по установке, аутентификации и командам Справочник по настройке провайдеров ИИ Пример подхода к конфигурации в opencode.json

Что это за инструмент и для чего он нужен

Расположение файла конфигурации

Система	Расположение файла конфигурации	Описание
Windows	`C: \Users\YourUsername\. config\opencode\opencode.json`	Если файл не существует, создайте его
macOS / Linux	`~/. config/opencode/opencode.json`	Если файл не существует, создайте его

Начало работы с мастером подключения

Мастер подключения OpenCode

cd YOUR_TEST_PROJECT opencode /connect

Проверка моделей в OpenCode

cd YOUR_TEST_PROJECT opencode /models

На что обратить внимание при ручной настройке

Редактируйте файл конфигурации вручную только в том случае, если в документации вашего провайдера чётко указано поле Provider для OpenCode, а также куда именно подставлять Base URL и API-ключ. Поля могут различаться в зависимости от версии — не копируйте напрямую примеры JSON из других инструментов в OpenCode.

Параметр для проверки	Описание
Тип провайдера	Не смешивайте протоколы OpenAI, Claude, Gemini и другие
Base URL	Используйте полный адрес, предоставленный провайдером для OpenCode или соответствующего протокола
Ключ (Key)	Используйте ключ, соответствующий выбранному провайдеру
Название модели	Скопируйте идентификатор модели из личного кабинета провайдера

Как протестировать после сохранения

Перейдите в каталог тестового проекта и выполните команду opencode.
Сначала с помощью команды /models убедитесь, что настроенная модель отображается в списке.
Выбрав модель, отправьте запрос: «Ответь только: Настройка OpenCode прошла успешно».
При первом запуске не просите инструмент менять файлы — просто попросите объяснить структуру текущего каталога или содержимое файла.
В случае ошибки вернитесь к команде /connect или перепроверьте провайдера, Base URL, ключ и название модели по документации провайдера.

Проблема / признак	Первоочередная проверка	Решение
В `/models` нет моделей	Успешно ли сохранён провайдер, удаётся ли получить список моделей	Вручную добавьте ID / название модели из личного кабинета провайдера
Ошибка подключения	Соответствует ли Base URL протоколу выбранного провайдера	Не смешивайте адреса конечных точек Claude, Gemini и OpenAI
Файл конфигурации недействителен	Формат JSON, пропущенные запятые, кавычки	Рекомендуется сначала сгенерировать базовый конфиг через мастер подключения, а затем внести нужные точечные правки.

Официальный сайт OpenCode Инструкции по установке, аутентификации и доступным командам.

Справочник по настройке провайдеров ИИ в OpenCode Пример настройки файла opencode.json.