OpenCode не работает: Forbidden, Free usage exceeded и ошибки API

Иногда OpenCode спокойно открывает проект, но падает, как только отправляешь первый запрос. Переустановка в такой ситуации редко помогает: чаще дело в выбранной модели, квоте провайдера или адресе локального сервера. Для начала раскрой и сохрани ошибку целиком — одна строка из уведомления может скрыть самое полезное.

Ниже разбираем обычный OpenCode CLI и его провайдеров. Мы сверили инструкции с документацией 7 сентября 2026 года. Похожие сообщения могут появляться по разным причинам, поэтому не пытайся угадать решение по одному слову Forbidden.

Сначала найди, на каком участке сбой

Что видишь	Что проверять
command not found	Установку команды и PATH: запрос до модели ещё не дошёл
Cannot connect to API, connection refused, timeout	Адрес сервера, работающий процесс, сеть и прокси
Forbidden или 403	Ответивший сервис, доступ к модели и права аккаунта
Free usage exceeded или 429	Тип лимита и провайдера, на которого реально ушёл запрос
Ответ есть, но агент не выполняет действия	Поддержку инструментов, контекст и разрешения

Таблица подсказывает, с чего начать, но не ставит диагноз. Например, Forbidden без адреса ответившего сервиса ещё не означает, что вся программа заблокирована в России.

Проверь провайдера и полный ID модели

Открой /models. В OpenCode модель определяется парой provider_id/model_id: одинаковое знакомое название может вести к разным сервисам. В документации моделей также описан приоритет выбора: параметр запуска --model, конфигурация, затем последнее использованное значение. Настройки отдельных агентов тоже стоит проверить.

Сохрани версию OpenCode, провайдера, полный ID модели, текст ошибки и время. Затем открой новую сессию и отправь короткий запрос без рабочих файлов и длинной переписки. Если он проходит, причина может быть в контексте или конкретном инструменте. Если падает так же, сосредоточься на подключении.

Не меняй одновременно ключ, модель и конфигурацию. Даже если после этого всё заработает, ты не узнаешь, что помогло, и не сможешь воспроизвести настройку на другой машине.

Free usage exceeded: почему оплата не всегда помогает

Сообщение Free usage exceeded, subscribe to Go встречается в обращениях пользователей OpenCode. Причём есть пример ошибки на первом же запросе. Так что сама надпись ещё не доказывает, что ты действительно израсходовал квоту. Сверь её с данными кабинета и посмотри, через какого провайдера ушёл запрос.

Если Go уже оплачен, проверь, не осталась ли выбрана бесплатная модель другого маршрута. В issue про подагентов описан именно такой симптом: основная подписка активна, а вспомогательные запросы используют opencode/deepseek-v4-flash-free. Это пользовательское наблюдение, не универсальное исправление и не подтверждение текущего сбоя сервиса.

Не отправляй один и тот же запрос снова и снова. Сначала посмотри расход в кабинете и сверь провайдеров основного и вспомогательных запросов. Если интерфейс показывает время обновления квоты, дождись его. А если кабинет и ошибка говорят разное, отправь поддержке время сбоя и обезличенный фрагмент лога. Ещё одна покупка проблему, скорее всего, не прояснит.

Разницу между балансом и подпиской разбираем отдельно: OpenCode Go и Zen.

Forbidden и Forbidden model: смотри на ответившую модель

При 403 сначала выясни, кто отказал: Zen, другой облачный API или промежуточный шлюз. Затем сравни модель в интерфейсе с моделью в ошибке. В трекере OpenCode есть сообщение, где отказ ссылался на big-pickle, хотя пользователь выбирал другие модели. Поэтому не ограничивайся названием в верхней части чата — модель внутри ошибки важнее.

Если ID отличается, проверь настройку модели у агента и вспомогательных задач. Если совпадает — уточни, доступна ли она этому аккаунту и не изменился ли каталог провайдера. Не подставляй старое имя из чужого конфига как заведомо рабочее.

Для запросов через OpenRouter есть отдельный разбор ошибок этого сервиса. Указанный в ошибке адрес openrouter.ai — повод идти туда; наличие слова OpenCode само по себе не делает сбой ошибкой Zen.

Cannot connect to API: локальный сервер и прокси

Для локального подключения проверь, что сервер модели действительно запущен и слушает адрес из конфига. В официальном примере Ollama-провайдера используется http://localhost:11434/v1. Это пример для Ollama, а не универсальный адрес любой модели. Название модели должно совпадать с установленной на сервере.

С Docker, WSL и второй машиной легко запутаться в localhost: это всегда то окружение, из которого устанавливается соединение. Полезно буквально записать цепочку: где запущен OpenCode, где работает сервер и по какому адресу первый может достучаться до второго.

OpenCode учитывает переменные прокси. Документация Network требует исключать локальный сервер через NO_PROXY. Для текущей сессии macOS/Linux это выглядит так:

export NO_PROXY=localhost,127.0.0.1

Если в переменной уже есть корпоративные исключения, добавь адреса к ним. Не отключай проверку TLS ради исчезновения ошибки сертификата: для корпоративного центра сертификации в документации предусмотрен NODE_EXTRA_CA_CERTS.

Где найти лог и что передать в поддержку

В руководстве по диагностике указаны каталоги логов: ~/.local/share/opencode/log/ на macOS/Linux и %USERPROFILE%\.local\share\opencode\log на Windows. Для более подробной записи можно запустить:

opencode --log-level DEBUG

Повтори сбой один раз на нейтральном запросе и сохрани несколько строк лога вокруг ошибки. Поддержке обычно хватает версии, ОС, провайдера, ID модели, времени и результата короткой проверки. Ключи, токены, содержимое проекта и личные пути удали. auth.json прикладывать не нужно: в нём лежат данные авторизации.

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

Когда переходить на локальную модель

Если облачный доступ регулярно прерывает работу, можно подключить Ollama к OpenCode. Это убирает зависимость генерации от квоты облачного API, но оставляет ограничения памяти, скорости и самой модели. Ошибки установки или локальной сети таким переходом автоматически не лечатся.

Если удобнее графический интерфейс, можно попробовать Доку с локальной моделью. Дай двум вариантам одну небольшую задачу и сравни результат. Только помни: внешние инструменты и облачные API сохраняют свои условия доступа в любом агенте.