OpenCode «Free usage limit reached»: что значит ошибка и как продолжить работу

Q: Что даёт OpenCode Go?

Платный доступ к моделям из списка Go с префиксом opencode-go/: $10 в месяц или $40 за Go Plus, согласно документации Go. У каждой модели есть лимиты на пять часов, неделю и месяц. Когда они заканчиваются, по документации можно продолжить на бесплатных моделях или включить Extra Usage и продолжить за счёт кредитов Console.

Короткий ответ

Бесплатные модели OpenCode, например Big Pickle и DeepSeek V4.1 Flash Free, работают через шлюз OpenCode (в OpenCode 1 он называется Zen, в документации OpenCode 2 — Console). Когда шлюз отклоняет запрос, приложение показывает одну из ошибок ниже. Бот поддержки OpenCode говорит, что перезапуск приложения или переход на другую бесплатную модель её не снимает.

Сначала проверьте версию OpenCode. 26 октября 2026 года один из мейнтейнеров OpenCode закрепил #59387 как основной issue по проблемам бесплатного тарифа: большинство жалоб приходит от OpenCode v1 (версии 0.x и 1.x, например Desktop 1.19.4), который больше не поддерживает бесплатные модели, а обновление до OpenCode v2 (на тот момент 2.1.4) многим помогло. Встроенное обновление настольного приложения v1 оставляет вас на 1.x, поэтому скачайте v2 сами с opencode.ai/v2/docs. Пошагово — ниже.

Если у вас уже последняя v2, есть три способа продолжить:

Подождать или написать в поддержку OpenCode. Если обратный отсчёт не заканчивается или вы считаете блокировку ошибочной, напишите на help@anoma.ly.
Заплатить OpenCode. Оформить подписку OpenCode Go или пополнить кредиты Console и пользоваться платными моделями.
Подключить своего провайдера. OpenCode работает с любым OpenAI-совместимым API. Запросы к нему не идут через бесплатный тариф OpenCode, поэтому его лимиты и блокировка по IP на них не действуют. Один из вариантов — TeamoRouter; настройка ниже.

Получить API-ключ — зарегистрируйтесь и пополните баланс от $5 в рублях через СБП, Т-Банк, ЮMoney или SberPay либо в USDT.

Как выглядят сообщения

text

Free usage exceeded, subscribe to Go
retrying in 50427s - attempt #1

Free usage limit reached. Subscribe to OpenCode Go to keep going: https://opencode.ai/go

Free usage limit reached. Connect a provider or subscribe to OpenCode Go to keep going, or switch models.

Error from provider (Console): OpenCode's free tier can only be used from within OpenCode

OpenCode's free models aren't available from your current network because we've detected abusive traffic from this IP address. This isn't related to your account. If you're on a VPN or proxy, turn it off and try again, or subscribe to OpenCode Go at https://opencode.ai/go to keep building.

Upstream request failed: Insufficient account funds
Upstream request failed: Invalid credential
Upstream request failed: Endpoint is unavailable.

You've used today's free messages. They reset at …
This version of OpenCode Desktop no longer supports free models
OpenCode 1.18.0 or newer is required to use the free tier

Первое сообщение выдаёт OpenCode 1.19.x, в том числе настольное приложение (#58781, #58941). Второе записывается в лог как FreeUsageLimitError (#58205). Третье — та же ошибка в формулировке из текущего исходного кода OpenCode 2. Последние три перечислены в закреплённом issue OpenCode по бесплатному тарифу (#59387).

«Free usage exceeded» и «Free usage limit reached»

Что это значит. Вы израсходовали бесплатный лимит. Бот поддержки OpenCode говорит, что лимит и время до повтора задаёт сервис OpenCode для вашего аккаунта, а не приложение (#58941), и что лимит может действовать ещё и на рабочее пространство и сеть (#58205). Размер бесплатного лимита и расписание его сброса OpenCode не публикует.

Что делать:

Посмотрите время сброса в OpenCode Console — по словам бота, оно показано там.
Если вы работаете через VPN, прокси или общую сеть, попробуйте без них.
Обновитесь до OpenCode v2. Версию можно узнать командой opencode --version в терминале или в настольном приложении в разделе Settings → About. Если у вас v1 (0.x или 1.x), установите v2 отдельно, а не через встроенное обновление — оно остаётся на 1.x:
- Настольное приложение: скачайте с opencode.ai/v2/docs или на macOS выполните brew install --cask opencode-desktop.
- Терминал: curl -fsSL https://opencode.ai/v2/install | bash на macOS и Linux или npm install -g @opencode/cli. Если v1 стоит через менеджер пакетов, сначала удалите его (например, npm uninstall -g opencode-ai). Chocolatey и Scoop не поддерживают v2, поэтому на Windows используйте настольное приложение, npm или отдельный бинарный файл. Мейнтейнеры пишут, что обновление до v2 многим убрало эту ошибку (#59387).
Оформили Go, а лимиты бесплатного тарифа всё равно появляются? Выполните /connect, выберите OpenCode Go, вставьте API-ключ Go и в /models выберите модель Go (opencode-go/...), а не бесплатную (opencode/...-free).
Если ошибка остаётся на последней v2, напишите комментарий в #59387: версия OpenCode, операционная система, модель, точный текст ошибки и время сброса. По вопросам аккаунта и оплаты пишите на help@anoma.ly. Не публикуйте данные аккаунта в открытых issue.

Не подтверждено: во многих сообщениях за 19–26 октября 2026 года ошибка появляется на первом запросе дня, при нулевом расходе в Console или с отсчётом, который всё время начинается заново (#58284, #58814, #59140). 26 октября мейнтейнеры OpenCode начали закрывать их как дубликаты #59387, где сказано, что большинство таких сообщений приходит от OpenCode v1.

«OpenCode's free tier can only be used from within OpenCode»

Что это значит. Бесплатные модели принимают запросы только от самого OpenCode. В документации Console сказано, что другим клиентам нужны платные модели или Go.

Эту ошибку видят и внутри OpenCode. Бот поддержки OpenCode называет известные причины (#56324):

в правах где-либо запрещены read или shell/bash, включая "*": "deny" или агента, которому запрещена оболочка. Мейнтейнер пишет, что случай с оболочкой отслеживается (#50627);
в конфиге есть провайдер с адресом https://opencode.ai/zen/v1;
остались старые плагины;
нет сохранённых учётных данных Console. Выполните opencode auth login opencode.

Что делать: проверьте конфиг (его выводит opencode debug config) и opencode auth list, исправьте найденное и повторите запрос. Не подтверждено: в #56324 бот не смог воспроизвести ошибку и предполагает, что шлюз по-разному относится к некоторым сетям или регионам.

«Free models aren't available from your current network»

Что это значит. Система защиты от злоупотреблений OpenCode пометила IP-адрес, с которого вы подключаетесь, а не ваш аккаунт. Бот поддержки OpenCode добавляет, что общие сети и сети операторов связи могут попасть под отметку из-за чужого трафика и что переустановка или повторный вход не помогут (#56916, #57074).

Что делать: OpenCode советует отключить VPN или прокси, если вы ими пользуетесь, и попробовать снова. Если не пользуетесь, напишите на help@anoma.ly и попросите проверить IP-адрес. Снять отметку может только команда OpenCode. Свой провайдер (раздел ниже) этой отметкой не затрагивается: запросы к нему не проходят через бесплатный шлюз OpenCode.

Ошибки «Upstream request failed»

Их возвращает шлюз OpenCode, а не приложение.

Insufficient account funds. В документации по оплате OpenCode сказано, что платные запросы завершаются ошибкой HTTP 402 с этим текстом, когда баланс кредитов Console доходит до нуля. Если вы платите за Go, проверьте префикс модели: по словам бота поддержки, модели opencode/ оплачиваются из кредитов Console, а модели Go — это opencode-go/ (#56768). Выполните /connect, выберите OpenCode Go, вставьте API-ключ Go и выберите модель Go в /models (документация Go). Если ошибка остаётся при активной подписке, напишите в поддержку.

Invalid credential. Мейнтейнер пишет, что истёк срок действия сохранённого API-ключа OpenCode и что часть старых ключей перестала работать после миграции Console (#54833). Выполните opencode auth login (или переподключитесь в настольном приложении) либо создайте новый ключ в Console в разделе Account → Personal API keys (#57106).

Endpoint is unavailable. Один такой случай — DeepSeek V4.1 Flash в Go с ответом HTTP 429 — мейнтейнер назвал временной проблемой хостинга или вышестоящего провайдера (#57613). Проверьте status.opencode.ai и попробуйте другую модель. Если не проходит, сообщите в OpenCode время, модель и ID запроса из логов Console.

Как продолжить работу со своим API-ключом

У нового аккаунта баланс $0 — пополните его до первого запроса. Пополнить можно от $5. Если запрос возвращает 402 (в формате OpenAI, который использует OpenCode, — 400) с текстом «wallet balance is insufficient», значит, баланс пуст, а base URL и ключ настроены правильно. Пополните баланс и повторите запрос.

Сколько запросов даёт $5 (оценка по официальным ценам):

Модель	Запросов на $5
DeepSeek V4.1 Flash (`deepseek-flash-1017`)	около 2 600–4 600
GLM 5.3 Flash (`glm-5.3-flash`)	около 1 600–3 000
Claude Sonnet 5.5 (`claude-sonnet-5-5`)	около 70–140

Оценка по официальным ценам моделей (для DeepSeek — по цене в часы пик) и по средней и медианной стоимости реальных запросов в TeamoRouter за три дня до 3 ноября 2026 года. Сейчас цены TeamoRouter ниже этих официальных, поэтому запросов будет больше. Один запрос — это один вызов API; агент вроде OpenCode на одну задачу обычно делает несколько.

Само сообщение OpenCode 2 предлагает подключить провайдера. TeamoRouter даёт один ключ для GPT, Gemini, DeepSeek, Kimi, GLM и Claude с оплатой за токены с предоплаченного баланса.

Создайте API-ключ в консоли TeamoRouter. Пополните баланс от $5 в рублях — через СБП, Т-Банк, ЮMoney или SberPay; подписки нет. Можно оплатить и в USDT, USDC или ETH: в окне пополнения нажмите «Оплатить криптовалютой» (пошагово).
Добавьте провайдера в ~/.config/opencode/opencode.json (для всех проектов) или в opencode.json в проекте:

json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "teamorouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "TeamoRouter",
      "options": {
        "baseURL": "https://api.teamorouter.com/v1",
        "apiKey": "{env:TEAMOROUTER_API_KEY}"
      },
      "models": {
        "gpt-6.1-sol": { "name": "GPT 6.1 Sol" },
        "deepseek-flash-1017": { "name": "DeepSeek V4.1 Flash 1017" },
        "kimi-k3.1-pro": { "name": "Kimi K3.1 Pro" },
        "glm-5.3": { "name": "GLM-5.3" }
      }
    }
  }
}

Это формат своего провайдера из документации OpenCode 1. OpenCode 2 по-прежнему его читает — так сказано в руководстве по миграции. В собственном формате конфига OpenCode 2 provider становится providers, npm — package (@opencode/ai/providers/openai-compatible), а options — settings (документация OpenCode 2).

Передайте OpenCode ключ:

bash

export TEAMOROUTER_API_KEY="ваш API-ключ TeamoRouter"

OpenCode 2 отправляет запросы из общего фонового сервера, поэтому передайте переменную этому серверу: opencode service set env TEAMOROUTER_API_KEY "ваш ключ" (документация). В OpenCode 1 вместо этого можно выполнить /connect, выбрать Other, ввести ID провайдера teamorouter и вставить ключ. После этого строку apiKey удалите.

Выполните /models и выберите модель TeamoRouter. Чтобы сделать её моделью по умолчанию, добавьте в конфиг "model": "teamorouter/gpt-6.1-sol". Запрос GET /v1/models с вашим ключом выводит все ID моделей.

В OpenCode Desktop того же провайдера можно добавить в Settings → Server → Providers → Custom provider; см. «Подключение OpenCode к TeamoRouter». Через этого провайдера там не рекомендуют модели Claude: он работает по протоколу OpenAI и может не попадать в кэш Claude. Для Claude используйте Claude Code.

Частые вопросы

Исправит ли ожидание «Free usage exceeded»? Обратный отсчёт — это время до повтора, которое задаёт сервис. Если он доходит до нуля и начинается заново, то тем, кто об этом сообщает, дальнейшее ожидание не помогло. Сначала убедитесь, что у вас OpenCode v2 (v1 больше не поддерживает бесплатные модели); если ошибка остаётся, напишите на help@anoma.ly.

Что даёт OpenCode Go? Платный доступ к моделям из списка Go с префиксом opencode-go/: $10 в месяц или $40 за Go Plus, согласно документации Go. У каждой модели есть лимиты на пять часов, неделю и месяц. Когда они заканчиваются, по документации можно продолжить на бесплатных моделях или включить Extra Usage и продолжить за счёт кредитов Console.

Нужен ли аккаунт OpenCode, чтобы пользоваться своим провайдером? Нет. В документации Console сказано, что Console необязателен и вместо него можно пользоваться любым другим провайдером. Своему провайдеру нужны только base URL и API-ключ.

Куда писать о проблемах с оплатой или аккаунтом? На help@anoma.ly. OpenCode решает вопросы оплаты по почте, а мейнтейнеры закрывают такие issue на GitHub и отправляют туда (#52958).