OpenCode подключается к Ollama штатной командой ollama launch opencode. Выберите локальную модель с контекстом 64k или больше и дайте ей конкретную задачу в тестовой папке. Проверьте результат сами: появился ли файл с нужным содержимым.
Один агент, одна конкретная задача. Заранее укажите, что делать и как проверить результат. Без метода он будет делать, что попало.
Что должно быть готово перед запуском
До подключения проверьте, что:
- Установлен OpenCode; команда установки через npm -
npm install -g opencode-ai. - Работает локальный сервер Ollama.
- Скачана локальная модель, которую вы собираетесь использовать.
Установка OpenCode разобрана в отдельной статье.
Начните со списка установленных моделей:
ollama lsСохраните точное имя модели: оно нужно при выборе и ручной настройке.
Теперь проверьте, отвечает ли сервер через API:
curl http://localhost:11434/api/tagsЕсли соединения нет, проверьте, работает ли сервер. Если ответ пришёл, но нужного имени в списке нет, проверяйте, скачана ли выбранная модель. Это разные причины отказа.
ollama serve запускает сервер. Используйте команду, когда он не работает. Если его уже запустило приложение Ollama, второй экземпляр не нужен.
Мой компьютер генерирует картинки. Для работы с кодом через OpenCode нужна отдельная проверка.
Как я работаю с ИИ-агентами, рассказываю в канале:
Какую модель брать и сколько ей нужно контекста
Берите точное имя из ollama ls или ответа /api/tags. В примере настройки Ollama указана qwen3.5. Это пример, а не результат сравнения моделей. По нему нельзя судить, хватит ли памяти на вашем компьютере.
В документации интеграции OpenCode с Ollama требуется контекст 64k или больше. Страница контекста Ollama рекомендует для агентов и программирования не менее 64 000 токенов. Чем больше контекст, тем больше нужно памяти.
Для ручного запуска сервера задайте переменную окружения в оболочке, которая поддерживает такой синтаксис:
OLLAMA_CONTEXT_LENGTH=64000 ollama serveПеременная должна действовать в процессе сервера. Задать её только в терминале с OpenCode недостаточно. Если сервер уже работает, сначала остановите его, затем запустите с новой настройкой.
После загрузки модели проверьте выделенный контекст:
ollama psСмотрите CONTEXT и PROCESSOR. Через API можно проверить имя загруженной модели и её контекст:
curl http://localhost:11434/api/psПоле context_length показывает выделенный контекст. Сверьте его с настройкой: важно, сколько выделено, а не только что вы указали при запуске.
Для начала нам нужно доказать, что эта система работает, а потом уже снижать себестоимость производства. Сравнивайте локальные модели на одном и том же поручении. При смене модели не меняйте условия и способ проверки результата.
Что останется локальным, а что надо проверить отдельно
Название Ollama в интерфейсе не доказывает, что всё задание выполняется без сети. Проверьте 3 вещи:
- Выбрана скачанная локальная модель. В ручной настройке адрес API -
http://localhost:11434/v1. Полеnameзадаёт только отображаемое имя провайдера, а не адрес подключения. Ollama Cloud для локального запуска не нужен. - Внешние инструменты и подключения к сервисам через MCP проверены отдельно. OpenCode умеет получать веб-страницы и запускать команды. Выбор локальной модели эти возможности не отключает. Поручению с файлом сеть не нужна.
- Открыта пустая тестовая папка без настоящих документов и ключей. Проверьте, какие действия требуют согласования. Не разрешайте всё подряд ради удачного запуска.
Подключение MCP в OpenCode и проверку вызова инструмента разбираю в отдельной статье.
По умолчанию Ollama слушает 127.0.0.1:11434. Для клиента на том же компьютере открывать сервер во внешнюю сеть не требуется.
Чтобы отключить облачные функции Ollama, задайте OLLAMA_NO_CLOUD=1 в среде сервера. Другой вариант - поле "disable_ollama_cloud": true в ~/.ollama/server.json. После изменения перезапустите Ollama и проверьте, появилась ли в её журнале строка:
Ollama cloud disabled: trueТак отключаются облачные модели и веб-поиск Ollama. Это не отключает сетевые подключения OpenCode и других программ. Сможет ли задание выполняться без интернета, зависит и от используемых инструментов.
Как подключить OpenCode к Ollama штатным способом
Когда сервер отвечает и локальная модель есть в списке, переходите к запуску:
- Откройте терминал в отдельной пустой тестовой папке.
- Выполните команду:
ollama launch opencode- Выберите скачанную локальную модель по точному имени из
ollama lsили/api/tags. - Проверьте модель и адрес подключения. Нужен локальный сервер, без подключения Ollama Cloud.
- Переходите к поручению с файлом.
Штатный запуск передаёт конфигурацию выбранной модели непосредственно OpenCode. Файл ~/.config/opencode/opencode.json не перезаписывается, существующие настройки продолжают действовать. Поэтому одного старого файла недостаточно для проверки текущей сессии: учитывайте настройки, переданные запуском.
ollama launch opencode --config настраивает интеграцию без интерактивной сессии. Модели, заданные только в opencode.json, не появляются в выборе ollama launch.
После загрузки сверьте модель и контекст через ollama ps. Команда показывает загруженные модели, но не доказывает, какая из них обработала конкретное сообщение OpenCode.
Если хотите настроить провайдер вручную, перейдите к разделу «Когда нужен ручной opencode.json». Смешивать оба способа подключения не нужно.
Один агент, одна конкретная задача: появился ли файл
Ключевое в поручении - как проверить результат. Здесь образ результата простой: файл в заданной папке с заданной строкой. Сообщения «готово» недостаточно.
- Убедитесь, что открыта пустая тестовая папка. Настоящий проект пока не открывайте. Публикация и отправка изменений не нужны.
- Передайте задание целиком:
В текущей тестовой папке создай hello.txt с единственной строкой OpenCode was here. Используй инструмент записи файла. Другие файлы не меняй. Не обращайся к сети. После записи прочитай файл и проверь содержимое. Покажи, какие действия выполнил.- Следите за вызовом файлового инструмента и его результатом в сессии. Пересказ моделью своих действий не считается вызовом. Если требуется разрешение, согласуйте только нужную запись или чтение.
- Сами откройте
hello.txtредактором в этой папке. Нужна единственная строкаOpenCode was here, без пояснений и дополнительных записей. - Примите поручение, только если выполнены все условия ниже. Иначе переходите к диагностике, сохраняя условия задания.
Что принимаем:
- В сессии был вызов инструмента.
- В заданной папке появился
hello.txtс нужной строкой. - Вы сами открыли файл и подтвердили совпадение.
Повторное чтение самим агентом полезно, но вашу проверку не заменяет. Если файл создан не там или содержит другой текст, поручение не выполнено.
Совпали все условия - принято это конкретное поручение. Работу целого проекта оно не подтверждает. Перед переносом на свой продукт задайте собственные проверки и ограничьте права под задачу. После каждой фазы сохраняйте состояние и результаты запусков. Не расширяйте объём и доступы, не упрощайте требования в тестах, чтобы они прошли.
Если вы собираете свои проекты с ИИ-агентами, посмотрите программу практикума СмыслоКода.
Кстати, я снял ролик о работе с агентом на Hermes, обязательно посмотрите. В нём показываю, как задать способ работы и проверить результат:
Внутри - какие права давать агенту, как задать образец результата и проверить работу на разных моделях. Подключение OpenCode к Ollama в ролике не разбирается.
Чат отвечает, а работа не сделана: что проверять
Сначала найдите, где остановилась работа. Недоступный сервер, неверное имя модели и запрет записи нужно исправлять по-разному.
| Симптом | Что проверить | Следующее действие | Как проверить после правки |
|---|---|---|---|
| API не отвечает | Соединяется ли curl http://localhost:11434/api/tags с сервером, работает ли Ollama и совпадает ли адрес | Запустите локальный Ollama, если он остановлен. ollama serve не нужен поверх работающего сервера | Запрос API возвращает список моделей |
| Нужного имени нет в выборе | Сопоставьте ollama ls, /api/tags и способ подключения | Возьмите точное имя скачанной локальной модели. Запись только в opencode.json не пополняет выбор ollama launch | Нужная локальная модель доступна и выбрана |
| Чат отвечает, файла нет | Был ли вызов инструмента, в какой папке он работал, получено ли разрешение | Разберите результат вызова и согласуйте только нужное действие. Если дело не в разрешениях, сравните другую локальную модель на том же поручении | Сами откройте файл в редакторе и проверьте содержимое |
| Задача обрывается при нехватке контекста или памяти | CONTEXT и PROCESSOR в ollama ps, при необходимости context_length в /api/ps | Проверьте настройку работающего сервера и хватает ли памяти для нужного контекста | Повторите то же поручение и проверьте файл |
Увеличивать контекст при любом отказе бессмысленно. Если инструмент ждёт разрешения на запись, размер контекста этот вопрос не решит. Если API недоступен, сначала нужен ответ сервера.
Одна проблема, одна правка, потом повторная проверка. Так видно, какое изменение повлияло на результат. Не сбрасывайте всю конфигурацию и не снимайте ограничения на действия.
Диагностику ошибок OpenCode без сброса настроек разбираю в отдельной статье.
Когда нужен ручной opencode.json
Для ручного подключения добавьте в opencode.json провайдер provider.ollama. Если штатный запуск уже работает, повторять подключение не требуется.
Поля из примера документации:
Поле внутри provider.ollama | Значение |
|---|---|
npm | "@ai-sdk/openai-compatible" |
name | "Ollama" |
options.baseURL | "http://localhost:11434/v1" |
models | Карта моделей с ключом qwen3.5; внутри него поле name со значением "qwen3.5" |
Вместо qwen3.5 укажите точное имя своей модели. Сохраните вложенность provider → ollama → models.
После сохранения запускайте:
opencodeДальше выполните то же поручение с hello.txt. Способ подключения изменился, условия приёмки остаются прежними: нужен вызов инструмента и файл с заданным содержимым.
Что у вас происходит на первом поручении: агент создаёт нужный файл или останавливается на разговоре? Напишите в комментариях в канале, где возникла проблема.
Частые вопросы
Источники
- Ollama: OpenCode - запуск, 64k, ручная настройка.
- OpenCode: провайдеры - поля подключения, Ollama Cloud.
- Ollama: контекст - размер, память, проверка.
- Ollama: CLI - команды сервера и моделей.
- Ollama: API tags - идентификаторы моделей.
- Ollama: API ps - загруженные модели и контекст.
- Ollama: FAQ - локальный адрес, отключение облака.
- OpenCode: разрешения - доступ к ресурсам.
Новые материалы - дайджестом, без спама
Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

