opencode: подключение к API-шлюзу за пять минут

opencode — терминальный агент с открытым исходным кодом: читает проект, правит файлы, запускает команды. Работает поверх обычного API и не привязан к одному поставщику, поэтому модель под ним можно поставить любую.

Что понадобится

Ключ API и адрес сервера. Если вы работаете через Zukko↗, ключ выглядит как fetch_... и берётся в кабинете. Адрес для opencode — https://api.zukko.pro/v1, с /v1, в том числе для провайдера anthropic.

Это самая частая ошибка при настройке, и она даёт непонятный 404. opencode работает через AI SDK, а его провайдер anthropic добавляет к адресу только /messages, а не /v1/messages. Без /v1 запрос уходит на https://api.zukko.pro/messages и получает 404. Не путайте с Claude Code и официальным Anthropic SDK — вот им как раз нужен адрес без /v1.

Настройка через конфиг

Самый надёжный путь — файл ~/.config/opencode/opencode.json:

{
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.zukko.pro/v1",
        "apiKey": "fetch_ваш_ключ"
      }
    }
  }
}

После этого выберите в opencode модель claude-opus-5-5 или claude-sonnet-5. Подробности — в документации по opencode↗.

Конфиг лежит в домашней папке, а не в проекте, поэтому в git он не попадает. Держать ключ в файле, который уезжает в git, не стоит — это относится и к .env внутри проекта.

Выбор модели

Актуальный список моделей всегда доступен запросом:

curl https://api.zukko.pro/v1/models -H "Authorization: Bearer fetch_ваш_ключ"

Модели, которые в этот момент не отвечают, из списка убираются автоматически — это сделано ровно для агентов: иначе вы выбираете первую попавшуюся, ловите отказ и делаете вывод, что сломан весь сервис.

Для повседневной агентной работы разумная пара: claude-opus-5-5 на сложные задачи и glm-5.3 на простые (учтите, что у GLM контекст 128K, а не 1M). Разница в цене заметная — $0.30 против $0.10 за миллион входных токенов, а в агентном цикле входные токены обычно и составляют основной расход. При сравнении с прайсом вендоров помните: у них чтение из кэша промптов стоит около 10% цены входа, а в Zukko кэшированные токены идут по обычной цене, так что для агента с большим повторяющимся контекстом реальная разница меньше, чем «в лоб».

Что проверить, если не заработало

401 или «invalid api key». Ключ скопирован не полностью или подставлен не в то поле конфига. Проверьте, что в значении нет пробела в конце — при копировании из мессенджера он появляется регулярно.

404 на запросе. Почти наверняка в baseURL не хватает /v1. См. выше.

Агент отвечает текстом вместо того, чтобы читать файлы. Значит, вызовы инструментов не доходят. Убедитесь, что выбранная модель вообще поддерживает вызов функций, и что вы не отключили инструменты в настройках opencode.

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

Сколько это стоит

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

Расход видно в кабинете в разрезе моделей, так что можно быстро понять, какая часть работы сколько стоит, и переложить рутину на модель подешевле.