Руководство по OpenCode
Блок provider для opencode.json, ID моделей по тарифам и разбор частых ошибок.
В OpenCode 2 весь CLI переписали с нуля: терминал, веб и десктоп теперь работают через общий сервис, и пользоваться этим стало заметно удобнее. Но те, кто подключает подписку Claude, в последнее время всё чаще упираются в одну и ту же ошибку 400 — причём срабатывает она через раз.
В середине октября вышел OpenCode 2. Разработчики не стали ограничиваться очередным минорным обновлением и переписали базовую архитектуру с нуля.
Главное изменение — единый фоновый сервис для всех интерфейсов. В ветке 1.x терминальный UI, веб-версия и десктопный клиент запускали собственные процессы, а сессии между ними не пересекались. В 2.0 на машине поднимается один локальный сервис, к которому подключаются терминал, браузер и десктоп.
X · @CamilleRouxTUI, web et desktop sur un même service localСмотреть в XСкрипты автоматизации могут обращаться к нему напрямую через @opencode/client, а задачи по расписанию идут через тот же вход с помощью opencode api. Если нужно продолжить работу с другого устройства, opencode pair открывает доступ к локальному сервису без ручного проброса портов.
Второе новшество — включённый по умолчанию Code Mode. Раньше при подключении нескольких MCP server десятки JSON-схем инструментов целиком загружались в контекст: это съедало окно и мешало модели выбирать нужный вызов. В 2.0 все они оборачиваются в обычные функции JavaScript. Когда модели нужно вызвать несколько инструментов подряд, она пишет короткий скрипт и выполняет его в песочнице за один проход, без лишних раундов туда-обратно.

Изменился и порядок обновлений. Начиная с версии 1.19.0 клиент больше не обновляется втихую: чтобы перейти на 2.0, нужно вручную вызвать /update или opencode upgrade --major. API плагинов и серверные интерфейсы спроектировали заново, поэтому старые плагины от 1.x после обновления перестают работать и требуют переписывания. То, что решение об обновлении вернули пользователю, как минимум спасает от сломанного окружения посреди утренней работы.
По ощущениям отклик и переключение между интерфейсами стали заметно бодрее, чем в 1.x. Но многие из тех, кто обновился и продолжил входить по подписке Claude, начали регулярно натыкаться на ошибку 400.
Само сообщение об ошибке короткое:
400 Third-party apps now draw from extra usage, not plan limits.Ask your workspace admin to add more and keep going.Если в этом году вы подключали подписку Claude к сторонним инструментам, эта строчка вам наверняка знакома. За последние полгода Anthropic несколько раз закручивала гайки, чтобы трафик по подписке не уходил за пределы официальных клиентов.
Первый шаг сделали 4 апреля. С этого дня вызовы из сторонних приложений перестали списываться из лимитов тарифа Pro и Max. Лимиты подписки оставили только для Claude.ai, официального Claude Code и Cowork; в остальные инструменты по-прежнему можно войти, но трафик в них оплачивается по полным ценам API с предоплаченного баланса extra usage. Если extra usage в аккаунте не включён или на балансе ноль, запрос блокируется и возвращает ту самую ошибку 400.
“Starting tomorrow at 12pm PT, Claude subscriptions will no longer cover usage on third-party tools like OpenClaw. You can still use these tools with your Claude login via extra usage bundles, or with a Claude API key.”
Борис Черный, автор Claude Code, тогда в Threads.
15 июня компания собиралась перевести на месячный пул кредитов ещё и вызовы через Agent SDK и claude -p, но в тот же день отложила это решение. В результате сложилось промежуточное положение: всё, что проходит по каналу настоящего Claude Code, по-прежнему укладывается в лимиты тарифа, а всё, что распознано как сторонний клиент, требует extra usage.
Главная головная боль для пользователей OpenCode — то, как именно устроена эта проверка. Судя по дампам трафика, которые сравнивали в сообществе, апстрим смотрит не только на User-Agent и заголовки, но и на системный промпт внутри самого запроса.
Поэтому ошибка и ведёт себя непредсказуемо. Апстрим не блокирует аккаунт на входе целиком, а проверяет содержимое каждого отдельного запроса. Исчерпанная квота или протухший токен ломали бы все запросы подряд, а не так, что один получает 200, а следующий тут же требует включить extra usage.
12 ноября мы почти одновременно получили одинаковые алерты на двух наших площадках. Логи шлюза на обеих показывали одно и то же: один диалог, один аккаунт — короткие запросы проходят, а основной запрос (24 КБ на одной площадке, 40 КБ на другой) упирается в эту 400.
Локально всё воспроизвелось чисто: OpenCode 2.2.7 с входом по подписке, логирующий прокси между клиентом и апстримом, одна обычная фраза в чат. Прокси перехватил четыре последовательных запроса:
| Запрос | Тело | Результат |
|---|---|---|
| Заголовок сессии | 2,3 КБ, без инструментов | 200 |
| Основной запрос | 47 КБ, 4 блока системного промпта, 13 инструментов | 400 |
| Повтор запроса заголовка | 2,3 КБ | 200 |
| Повтор основного запроса | 47 КБ | 400 |
Затем мы зафиксировали аккаунт и модель и начали по кускам вырезать содержимое из основного запроса на 47 КБ, чтобы проверить, в какой момент апстрим его пропустит:
| Изменение | Результат |
|---|---|
| Исходный запрос без изменений | 400 |
Удалён весь блок system | 200 |
Удалены все tools, блок system оставлен | 400 |
В system оставлен только базовый промпт на 1,4 КБ | 200 |
В system оставлен только блок Code Mode на 23,8 КБ | 400 |
| Оставлен Code Mode, удалён блок окружения в конце | 200 |
| В блоке окружения в конце оставлено 160 / 180 / 220 символов | 200 |
| В блоке окружения в конце оставлено 240 символов | 400 |
Замена на 1000 символов x или 240 символов обычного английского текста | 200 |
Круг сузился до минимума. Ни общий размер тела запроса, ни количество подключённых инструментов роли не играют — триггер срабатывает на самом последнем фрагменте системного промпта, где по шаблону подставляются сегодняшняя дата и параметры среды выполнения. Причём это не простой фильтр по стоп-словам: если заменить этот кусок на 1000 символов x или на обычный английский текст той же длины, сервер спокойно возвращает 200. А если сохранить исходную структуру, то 220 символов проходят, а 240 уже режутся — точнее границу внутри этого промежутка мы искать не стали.
Это заодно объясняет, почему запрос на генерацию заголовка срабатывает каждый раз: в его поле system лежит только короткая инструкция для суммаризации без финального блока с окружением. Рабочий каталог, платформу и текущую дату подставляет только основной запрос диалога.
Те, кто копал эту проблему в сообществе, пришли к тем же выводам. В обсуждении в репозитории Manifest выкладывали сравнение перехваченных запросов и отмечали, что фильтрация на стороне апстрима завязана именно на системный промпт; аналогичные репорты появлялись в репозитории самого Claude Code и в ишью проекта pi.
Если вы упёрлись в эту ошибку, не спешите переписывать конфиги — сначала за минуту проверьте, ваш ли это случай:
login или исчерпание лимитов — сначала загляните в claude.ai/settings/usage и проверьте статус аккаунта, это другая проблема.Когда проблемы с самим аккаунтом исключены, остаются три рабочих варианта — выбирайте тот, с которым готовы жить вдолгую.
Самый спокойный путь — перейти на официальный API key. Запросы пойдут через стандартный интерфейс, где вообще нет понятия «каким клиентом вы пользуетесь». Минус очевидный: фиксированной цены подписки больше не будет, каждый токен считается по прейскуранту API, а при активном написании кода счёт растёт очень быстро.
Если расставаться с подпиской не хочется, можно включить extra usage в настройках Claude и пополнить баланс. Запросы перестанут блокироваться, но весь трафик, который классификатор сочтёт сторонним, будет списываться с этого баланса по ценам API — по сути, вы платите и за подписку, и по факту сверху.
Третий вариант — пустить трафик через шлюз, который берёт на себя совместимость на уровне пересылки: тогда не придётся ни менять клиент, ни самостоятельно ловить дампы и подстраиваться под очередные правки апстрима. Сложность здесь в том, что правила проверки меняются, поэтому шлюз нужно постоянно поддерживать в актуальном состоянии. CodingPass работает именно по этой схеме: после подключения ошибка 400 уходит, а вызовы моделей и лимиты по-прежнему считаются из долларовой квоты вашего тарифа.
И напоследок короткое напоминание: на стороне апстрима работает динамически обучаемый классификатор, а не жёстко зафиксированный в документации протокол. Сегодня он цепляется за двести с лишним символов блока окружения, а завтра может переключиться на другие признаки. Если хотите спокойно продолжать работу в OpenCode 2, просто укажите baseURL от CodingPass по руководству для OpenCode. Если запрос через CodingPass всё же падает, в справочнике ошибок собраны все статусы, которые возвращает наш шлюз, и что с ними делать.
Оставайтесь в OpenCode 2. Достаточно поменять Base URL на CodingPass — эту ошибку 400 мы берём на себя, расход по факту, отмена в любой момент.