Руководство по OpenCode
Блок provider для opencode.jsonc, ID моделей по тарифам и разбор частых ошибок.
С релизом OpenCode v2 в ветке #59387 резко выросло число сообщений о недоступных бесплатных моделях. Многие сразу решают, что кончилась дневная квота, и оформляют подписку Go — хотя за похожими окнами скрываются минимум четыре разные причины.
В конце октября OpenCode выпустил ветку 2.x и начал закрывать доступ к бесплатным моделям для старых клиентов. После этого репозиторий на GitHub завалило однотипными жалобами, и мейнтейнеры выделили anomalyco/opencode#59387 как общую тему, куда перенаправляют все дубликаты.
Сценарий у большинства пользователей одинаковый: посреди работы появляется красное сообщение о превышении бесплатного лимита. Человек обновляется по первой попавшейся инструкции или ждёт указанного времени сброса, но после наступления срока дата просто перескакивает на следующий день. За формулировкой «кончился бесплатный лимит» на практике стоят четыре разные проблемы.
Прежде чем менять настройки или покупать Go, прочитайте точный текст ошибки. Устаревший клиент 1.x, старая сессия из 1.x, зависший счётчик на сервере и вызов вне OpenCode решаются по-разному.
Всплывающие окна почти не отличаются внешне, поэтому ориентироваться нужно на текст и кнопки:
1. This version of OpenCode Desktop no longer supports free models.2. Free usage exceeded, subscribe to Go3. You've used today's free messages. They reset at Oct 22, 2026, 8:00 p.m.4. FreeUsageLimitError (HTTP 429)Если в третьем варианте под текстом есть кнопки Upgrade to OpenCode Go и Switch model, клиент уже прошёл проверку версии и ограничение действительно связано с квотой. Остальные сообщения к расходу дневного лимита отношения не имеют.
Сообщения no longer supports free models и Free usage exceeded, subscribe to Go почти всегда означают, что у вас по-прежнему 1.x. 27 октября мейнтейнеры официально подтвердили, что ветка v1 больше не поддерживает бесплатные модели.
Многие остаются на 1.x в полной уверенности, что обновились до последней версии. Причины две. Во-первых, как указано в #59482, встроенный апдейтер Desktop v1 удерживает приложение на 1.x (The v1 Desktop's built-in updater keeps you on 1.x, so updating from inside the app won't get you there.). Во-вторых, в npm опубликованы два пакета: старый opencode-ai остановился на 1.19.5, а актуальный v2 находится в пакете @opencode/cli (2.2.2+ под тегом latest). Команда npm i -g opencode-ai навсегда оставляет вас на 1.x.
Десктоп и CLI — отдельные бинарники, поэтому проверьте 2.x именно в том интерфейсе, которым пользуетесь: через opencode --version в терминале, Settings → About в десктопном приложении или в свойствах .exe в каталоге установки Windows. Для ручной установки v2 выберите способ под свою платформу:
| Способ | Платформа | Команда или действия |
|---|---|---|
| curl | macOS / Linux | curl -fsSL https://opencode.ai/v2/install | bash |
| npm | Все платформы | npm install -g @opencode/cli |
| Homebrew | macOS | brew install anomalyco/tap/opencode-v2 |
| Отдельный бинарник | Windows | Скачать официальный zip-архив x64, распаковать и добавить папку в PATH |
В документации отмечено, что менеджеры пакетов Windows не поддерживаются, поэтому на Windows лучше ставить через npm или zip-архив. Если после установки в /models нет бесплатных моделей, выполните /connect и войдите в аккаунт OpenCode Console — без авторизации встроенный провайдер opencode вообще не отображается.
После обновления до v2 многие открывают незаконченный диалог и снова видят no longer supports free models, решая, что установка прошла криво.
Этот случай описан в #60352: даже если и CLI, и десктоп обновлены до 2.2.2, а локальная база мигрировала без ошибок, сервер всё равно отклоняет сессии, созданные во времена 1.x, как устаревший клиент. Стоит создать новую сессию с тем же аккаунтом и той же бесплатной моделью — и всё начинает работать. Проверять обновление до v2 нужно только в новом чате.
При сообщении You've used today's free messages. They reset at <время> · <дата> проследите, меняется ли время сброса. Если каждый день указан один и тот же час, дневной лимит действительно выработан и остаётся дождаться сброса.
Если же таймер доходит до нуля и сразу переносит дату на следующие сутки (например, с Oct 22 на Oct 23), счётчик застрял на стороне сервера. Согласно #60328, квоты и окна сброса задаются на бэкенде Console по связке «аккаунт + сеть», и клиент повлиять на них не может. Переустановка программы, удаление конфигов или очистка локальной базы почти никогда не помогают, но гарантированно стирают историю сессий. В треде отмечают два неофициальных обходных способа: выйти из аккаунта Console внутри OpenCode и войти заново (иногда несколько раз подряд) либо сменить сеть, например переключиться на мобильный хот-спот.
Если другой редактор или собственный скрипт получает FreeUsageLimitError или HTTP 429, версия клиента и сеть здесь ни при чём. В документации OpenCode прямо сказано: Free-tier chat models require OpenCode. Ключи бесплатного уровня работают только внутри официального клиента OpenCode; любые сторонние вызовы получают 429 независимо от настроек. Перейдите обратно в OpenCode или выберите платную модель.
GPT-6 Luna, это не скрытое списание. По документации Console, OpenCode генерирует заголовки сессий в фоне с помощью недорогих моделей (Haiku, Nano, Flash) по отдельному каналу, не связанному с бесплатной квотой чата.Illegal instruction на старых процессорах: CPU старше десяти лет, поддерживающие только SSE4.1 (без инструкций SSE4.2 и POPCNT), падают на v2 с ошибкой Illegal instruction, тогда как v1 уже не поддерживает бесплатные модели. Это аппаратное ограничение, которое настройками не обойти.Если после проверки версии 2.x, создания новой сессии, повторного входа и смены сети ошибка сохраняется, напишите в #59387, указав три вещи: точную версию, ОС и полный текст ошибки.
На странице OpenCode Go указано: If you reach the usage limit, you can continue using the free models. Подписка Go даёт отдельный платный пул запросов и не «разблокирует» бесплатные модели.
Оформлять Go бесполезно, если вы застряли на 1.x, в старой сессии 1.x или получаете 429 из стороннего инструмента. Покупка оправдана только тогда, когда на свежей сессии v2 время сброса остаётся фиксированным, а дневная бесплатная квота регулярно заканчивается уже к середине дня (тарифы: Go — $10/мес, Go Plus — $40/мес, Go Teams — $20/пользователь/мес; точное число бесплатных сообщений в день OpenCode не публикует).
Ограничения пула и регионов: сейчас во временный бесплатный пул (limited time) входят Big Pickle, GLM-5.3-Flash Free, DeepSeek V4.1 Flash Free, Beam Free, Flint 40B Free, MiMo-V2.6-Flash Free, Nemotron 3 Ultra Free, Nemotron 3.5 Lightning Free, Nemotron 3.5 Super VL Free и Jev 1.13 Free. Beam Free недоступен в Китае (включая Гонконг и Макао). Чтобы полностью скрыть бесплатные модели, задайте переменную окружения OPENCODE_DISABLE_FREE_MODELS=1.
Оставайтесь в OpenCode 2. Когда бесплатные лимиты или региональные ограничения мешают работе, переключите Base URL на CodingPass и используйте Claude, GPT и открытые модели с оплатой по факту.