OpenCode Zen API key или свой провайдер: что выбрать и как платить

Вы поставили opencode, набрали /connect и увидели в списке Zen. Рядом есть «Other», где можно вписать любой адрес. Возникает вопрос: нужен ли вам отдельный opencode zen api key или проще подключить провайдера, которым вы уже пользуетесь. Ниже разбираем, чем эти варианты отличаются, как настраивается каждый и что с оплатой из России.

Сторонние детали (меню, команды, формат конфига) сверены с документацией opencode.ai/docs на 18 октября 2026. Интерфейс и названия у проекта меняются, поэтому если что-то не совпало, ориентируйтесь на актуальную документацию.

Что такое OpenCode Zen

Zen — это провайдер внутри самого opencode. Команда проекта собрала список моделей, которые проверила именно в роли кодовых агентов, и продаёт к ним доступ через собственный шлюз. Вы заводите аккаунт на сайте opencode, пополняете кредиты и получаете один ключ. Списание идёт за запросы по мере использования.

В свежей документации тот же раздел называется «Console»: там же настройки рабочего пространства, участников и месячных лимитов. Название Zen при этом остаётся в списке провайдеров. Это один и тот же сервис.

Что в документации заявлено как смысл Zen: не искать самому, какая модель у какого поставщика работает с агентом нормально, а взять проверенный набор. Это удобно новичку, особенно когда непонятно, почему «та же» модель у разных посредников ведёт себя по-разному.

Оговорки, которые стоит прочитать до оплаты. В разделе Privacy у части моделей указаны исключения по хранению данных и использованию запросов для улучшения моделей, а бесплатные «на ограниченное время» модели помечены отдельно. Если вы работаете с закрытым кодом, пройдитесь по этому списку.

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

По документации порядок такой:

1. Внутри opencode выполните /connect.
2. Выберите провайдера opencode (в новой документации он называется pay-as-you-go).
3. Откройте opencode.ai/auth, войдите, добавьте платёжные данные и скопируйте ключ.
4. Вставьте ключ в запрос терминала.
5. Командой /models посмотрите доступные модели и выберите одну.

В конфиге модели Zen указываются в формате opencode/<id-модели>, например opencode/gpt-6.1-sol. Актуальный список моделей и их цены смотрите в самой консоли: мы их здесь не приводим, потому что они меняются.

Те же модели можно вызывать напрямую, без opencode, по адресам из раздела Endpoints документации. Ключ от консоли при этом тот же. То есть привязки к одному агенту нет.

Свой провайдер: что это значит в opencode

opencode не ограничивает вас Zen. Документация прямо говорит, что работает любой LLM-провайдер, у которого есть ключ. Для сервиса с OpenAI-совместимым API есть два шага:

1. /connect, прокрутить до пункта Other, придумать идентификатор провайдера и вставить ключ. Он сохранится в ~/.local/share/opencode/auth.json.
2. Описать провайдера в opencode.json: пакет @ai-sdk/openai-compatible (для /v1/chat/completions), baseURL и список моделей.

Для Zukko есть и второй путь, который описан в документации по opencode↗: переопределить baseURL у встроенного провайдера anthropic. Для Claude это даже предпочтительнее, и вот почему: Anthropic-формат позволяет шлюзу видеть чтение и запись кэша, а значит Claude получает цену кэша. В OpenAI-формате (/v1/chat/completions) для Claude весь вход считается по цене входа.

Конфиг, где в одном файле и Claude через anthropic, и дешёвые модели через OpenAI-совместимый провайдер:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-5",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.zukko.pro/v1",
        "apiKey": "{env:ZUKKO_API_KEY}"
      },
      "models": {
        "claude-sonnet-5": {},
        "claude-opus-5-5": {}
      }
    },

Обратите внимание на /v1 в обоих адресах. Для провайдера anthropic в opencode без него запросы уходят не туда и вы получаете 404. Ключ fetch_... создаётся на странице API-ключей↗, в окружение его кладут обычным export ZUKKO_API_KEY=fetch_....

Сравнение по существу

Это не рейтинг: Zen удобнее, когда вы хотите просто выбрать из готового списка, свой провайдер удобнее, когда у вас уже есть баланс и ключи, а моделей нужно больше или нужны отдельные ключи на проекты.

Как платить из России

Это самый частый вопрос по запросу «opencode оплата из россии», и отвечать на него по Zen честно можно только так: условия оплаты задаёт сам сервис. Какие способы доступны, подойдёт ли ваша карта и нет ли ограничений по стране для конкретных моделей, видно при пополнении и в разделе Privacy документации. Мы не знаем актуальных условий и не берёмся их пересказывать.

Что известно про Zukko: доступ из России идёт через шлюз, оплата возможна СБП, картой MasterCard или криптовалютой. Баланс считается в долларах, пополнение от $1. Через СБП платёжная страница добавляет комиссию 8,5% сверху: чтобы получить на баланс $10, вы заплатите в рублях по курсу на момент оплаты сумму, равную $10 × 1,085 = $10,85. Карты MasterCard идут с комиссией около 13%, суммы от $2 до $594.

Сколько это стоит на примере

Цены Zukko на 18 октября 2026, $ за 1M токенов. Возьмём сессию агента: 2 млн токенов свежего входа и 200 тыс. выхода, без учёта кэша.

• claude-sonnet-5 (0.4 вход / 2 выход): 2 × 0.4 + 0.2 × 2 = 0.8 + 0.4 = $1,20.
• deepseek-v4.1-flash (0.013 / 0.038): 2 × 0.013 + 0.2 × 0.038 = 0.026 + 0.0076 ≈ $0,034.

Реальный счёт зависит от кэша и от того, сколько агент читает. Актуальные цены берите из GET https://api.zukko.pro/v1/models или со страницы «Модели» в кабинете. Какая модель справится с вашей задачей, проверяйте на своих задачах: цена и индекс силы подсказывают, с чего начать, но не заменяют проверку.

Что выбрать

Если вы пробуете opencode впервые и не хотите разбираться с провайдерами, начните с Zen. Если у вас уже есть ключ Zukko и баланс, подключите его через baseURL, как выше: тогда в opencode, Claude Code и других инструментах вы тратите один баланс. Можно держать оба провайдера в одном конфиге и переключаться командой /models.

Чтобы попробовать второй вариант, создайте ключ в кабинете↗ и пройдите короткую инструкцию из быстрого старта↗.

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

Нужен ли отдельный ключ для Zen, если у меня есть ключ другого провайдера?

Да. Ключ Zen выдаёт консоль opencode, он работает только с её каталогом моделей. Ключ другого провайдера подключается рядом как отдельный блок provider.

Можно ли использовать Zen и Zukko одновременно?

Можно. Это два независимых провайдера в одном opencode.json, у каждого свой баланс. Переключаться между моделями можно через /models, а модель по умолчанию задаётся полем model.

Почему при подключении Claude через Zukko появляется 404?

Чаще всего в baseURL провайдера anthropic нет /v1. Для opencode адрес должен быть https://api.zukko.pro/v1. Это отличается от Claude Code, где /v1 не нужен.

Где посмотреть актуальные модели Zukko?

Запросом GET https://api.zukko.pro/v1/models или на странице «Модели» в кабинете. Имена моделей в конфиге должны совпадать с тем, что вернул этот список.