OpenCode Zen или свой API-ключ: что выгоднее в России

OpenCode Zen — это шлюз с отобранными командой OpenCode моделями, где вы платите по факту за токены. Свой API-ключ — это когда вы подключаете к OpenCode отдельного провайдера и платите ему. Для разработчика из России выбор решается не ценой за токен, а способом оплаты: в Zen нужно привязать биллинг и платить в долларах, а ключ российского прокси оплачивается рублёвой картой. Если вы работаете с Claude и GPT каждый день, выгоднее свой ключ с фиксированной рублёвой подпиской; если хотите разово попробовать агента, у Zen есть бесплатные модели, и это самый быстрый старт без вложений.

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

Что такое OpenCode Zen

Сам OpenCode — агент с открытым кодом, его установка ничего не стоит. Но агенту нужна модель, а модель нужно где-то взять. Zen — это собственный шлюз OpenCode: по описанию документации, список протестированных и проверенных командой моделей, доступных через один API. В каталоге заявлено больше 70 моделей — семейства GPT, Claude, Gemini, Qwen, DeepSeek и отдельные специализированные модели.

Схема оплаты — pay-as-you-go: вы пополняете баланс и расходуете его по мере запросов, отдельной подписки «за месяц» нет. Zen также умеет работать с вашим собственным ключом OpenAI или Anthropic и поддерживает командные рабочие пространства с разделением прав.

Сколько стоят токены в OpenCode Zen

Цены в Zen указаны за 1 млн токенов и отдельно за ввод и вывод. На момент публикации документация приводит такие значения:

Разрыв между вводом и выводом здесь важнее самих цифр. Агент в коде на каждом запросе заново отправляет контекст — открытые файлы, историю диалога, вывод команд, — поэтому объём ввода обычно растёт быстрее объёма ответов. Считать расход по цене вывода значит заведомо себя напугать, по цене ввода — недооценить счёт.

Баланс пополняется автоматически: документация описывает механизм, при котором на счёт доливается $20, когда остаток опускается ниже $5. Это удобно, но означает, что расход не упирается в заранее заданный потолок — следить за ним придётся самостоятельно.

Бесплатные модели в OpenCode Zen

В каталоге Zen есть модели с нулевой ценой — на момент публикации это, в частности, Big Pickle и Space Bunny Free, а Jev 1.13 Free в документации помечена как доступная ограниченное время. Состав этого списка меняется, поэтому ориентироваться на конкретное имя не стоит: смотрите актуальный каталог.

Бесплатные модели — честный способ посмотреть, как OpenCode ведёт себя на вашем проекте, не привязывая карту. Ограничения у них есть, и на бесплатном уровне это обычно лимиты на частоту запросов, так что для ежедневной работы над задачами такой вариант не рассчитан.

Как получить API-ключ OpenCode Zen

Порядок простой: вы входите в OpenCode Zen, добавляете платёжные данные и копируете API-ключ. Дальше ключ отдаётся агенту — в TUI это команда /connect, в которой нужно выбрать OpenCode Zen и вставить ключ.

/connect

Команда выполняется внутри запущенного OpenCode, а не в системном терминале: она открывает список провайдеров и сохраняет введённый ключ в учётных данных агента.

И здесь же — то самое место, где схема упирается в российские реалии. Чтобы получить ключ, нужно добавить биллинг, а расчёты идят в долларах: понадобится карта, которой можно платить в долларах, плюс к цене токенов добавится банковская комиссия за конвертацию. Бесплатные модели доступны и без этого, но всё, что сверху, требует работающего платёжного средства.

Альтернатива: свой API-ключ через PurpleSchool

Второй путь — подключить к OpenCode своего провайдера. OpenCode не привязан к Zen: он умеет работать с любым OpenAI-совместимым адресом, и это штатная возможность, а не обходной приём. Для читателя из России это значит, что между агентом и моделью можно поставить сервис с рублёвой оплатой.

У PurpleSchool для этого есть AI для кода: один ключ, общий баланс токенов на модели Claude и OpenAI, оплата российской картой или через СБП и работа без VPN. Тарифы — подписка с ежемесячным обновлением лимита:

Неизрасходованный остаток переносится на следующий месяц, но дольше одного цикла не накапливается. На странице тарифов заявлено, что доступ выходит на 10% дешевле официальных API при тех же моделях.

Подключение в OpenCode — переменная окружения с ключом и блок провайдера в конфиге. Сначала ключ:

export PURPLESCHOOL_API_KEY="ваш ключ"

Эту строку добавляют в конфиг активной оболочки — ~/.zshrc или ~/.bashrc, — чтобы переменная поднималась в каждой новой сессии. Если команда export и разница между переменной сессии и переменной окружения вам не очевидны, посмотрите разбор export в bash.

Затем провайдер в opencode.json в корне проекта — существующие настройки из файла удалять не нужно, блок добавляется к ним:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "purpleschool": {
      "npm": "@ai-sdk/openai",
      "name": "PurpleSchool OpenAI Proxy",
      "options": {
        "baseURL": "https://app.purpleschool.ru/api-v2/public/ai-proxy/openai/v1",
        "apiKey": "{env:PURPLESCHOOL_API_KEY}"
      },
      "models": {
        "<MODEL_NAME>": {
          "name": "<MODEL_NAME>"
        }
      }
    }
  }
}

Разберём, что здесь происходит. npm указывает, каким пакетом OpenCode будет говорить с провайдером — здесь это OpenAI-совместимый клиент. baseURL перенаправляет запросы на прокси PurpleSchool вместо адреса по умолчанию. Запись {env:PURPLESCHOOL_API_KEY} — это подстановка переменной окружения: в файл попадает имя переменной, а не сам ключ, поэтому конфиг можно коммитить в репозиторий. <MODEL_NAME> нужно заменить на имя доступной модели — список берётся в личном кабинете, там же, где выдаётся ключ.

Если не хочется править файлы руками, на странице продукта есть CLI, который сам прописывает ключ и адрес прокси в установленные инструменты:

npx @purpleschool/ai-for-code

Для запуска нужен установленный Node.js версии 22 или новее.

Полную установку OpenCode со всеми вариантами под macOS, Linux и Windows мы разбирали отдельно — OpenCode в России: установка и настройка без VPN. Здесь шаги не повторяем.

Одна оговорка про формат конфига. У OpenCode есть вторая линия версий, где настройки лежат в opencode.jsonc, а блок провайдеров называется providers и описывается другими ключами. Конфиг выше — из актуальной официальной инструкции PurpleSchool и рассчитан на opencode.json. Если ваш OpenCode создаёт файл с другим именем и другой схемой, берите конфиг из кабинета, а не переписывайте пример по памяти.

OpenCode Zen или свой ключ: что выгоднее

Сравнивать цену за токен напрямую бессмысленно: в Zen вы платите за фактический расход в долларах, в подписке — фиксированную сумму в рублях за лимит. Поэтому полезнее посчитать, во что обошлись бы в Zen те же объёмы, что входят в тарифы. Возьмём Claude Opus 5.5 по ценам выше и посчитаем две границы — если бы весь объём ушёл в ввод и если бы весь ушёл в вывод:

Реальный расход в Zen лежит внутри вилки и ближе к её нижней границе, потому что ввода у агента больше, чем вывода. Переводить доллары в рубли я сознательно не буду: результат зависит от курса на день платежа и комиссии вашего банка, и любая конкретная цифра здесь устареет раньше, чем вы её прочитаете. Сравнивайте сами по актуальному курсу — структура расчёта в таблице.

Что из этого следует по пунктам:

• Способ оплаты. У Zen — долларовый биллинг с привязкой карты. У подписки — российская карта и СБП. Для большинства читателей из России это решающий пункт, а не цена.
• Предсказуемость. Подписка — известная сумма в начале месяца. Zen — счёт по факту, причём с автодоливом баланса, то есть верхней границы расхода по умолчанию нет.
• Выбор моделей. Здесь выигрывает Zen: больше 70 моделей против доступа к моделям Claude и OpenAI в подписке. Если вам нужна конкретная модель вне этих двух семейств, Zen закрывает задачу, а прокси — нет.
• Старт без вложений. Бесплатные модели есть только у Zen. Карта для них не нужна.

Про оплату самих ключей Anthropic из России есть отдельный разбор — API-ключ Claude: как получить и оплатить из России; он пригодится, если вы рассматриваете вариант с прямым ключом провайдера, а не со шлюзом.

Что выбрать: три сценария

Посмотреть, как работает агент, и ничего не платить. Берите Zen на бесплатных моделях. Ключ получается за пару минут, биллинг для бесплатного уровня не нужен, а качества хватит, чтобы понять, нужен ли вам такой инструмент в работе вообще.

Работать с Claude или GPT каждый день из России. Берите свой ключ через прокси с рублёвой подпиской. Решающий довод не в цене за миллион токенов, а в том, что платёж проходит без зарубежной карты, а сумма известна заранее. Начинать разумно с младшего тарифа: 2,5 млн токенов — это уже полноценные рабочие сессии, а перейти на старший можно, когда упрётесь в лимит.

Нужна редкая модель, которой нет в прокси. Здесь вариантов нет — только Zen, с решённым вопросом долларовой оплаты. Каталог на 70+ моделей и есть то, за что имеет смысл терпеть неудобный биллинг.

Эти способы не исключают друг друга: провайдеров в opencode.json можно описать несколько и переключаться между моделями внутри одной сессии. Рабочая схема — рублёвый прокси как основной провайдер и Zen на бесплатных моделях для черновых задач.