opencode: что это за агент и как подключить к нему свои модели

Если вы искали «opencode ai что это», коротко: это открытый ИИ-агент для программирования. Он запускается в терминале, читает ваш проект, предлагает и вносит правки, запускает команды. Главное отличие от закрытых ассистентов в том, что модель выбираете вы: opencode умеет работать со многими поставщиками, а не с одним. Ниже: что он делает, как поставить, как устроена работа с ним и куда вписать ключ.

Описание сверено с документацией opencode.ai/docs на 18 октября 2026. Проект быстро развивается, в документации даже есть баннер про вторую версию. Если команда из статьи у вас не работает, сверьтесь с разделом для вашей версии.

Что такое opencode

По описанию проекта, это ИИ-агент с открытым кодом. Основной интерфейс текстовый, в терминале (TUI), но есть также десктопное приложение и расширение для IDE. Для привычной работы документация рекомендует современный терминал вроде WezTerm, Alacritty, Ghostty или Kitty. На Windows авторы советуют WSL: так, по их словам, лучше производительность и полная совместимость.

Что он делает в принципе, как и другие агенты этого класса: получает от вас задачу на обычном языке, сам ищет нужные файлы, читает их, вносит правки и при необходимости запускает команды. Чем отличаются разные инструменты друг от друга, мы разбирали отдельно в статье Claude Code, opencode, Aider, Cline: чем harness отличаются↗.

Нужен ли «opencode api key»

У самой программы ключа нет. Это клиент, а ключ выдаёт поставщик модели: Anthropic, OpenAI, любой шлюз или собственный каталог проекта Zen. Запрос «opencode api key» на деле значит «куда в opencode вставить ключ». Ответ: либо командой /connect, либо в конфиге opencode.json. Короткая пошаговая инструкция по подключению к шлюзу есть в статье opencode: подключение за пять минут↗, а здесь пройдём по порядку и с пояснениями.

Установка

Самый простой способ из документации:

curl -fsSL https://opencode.ai/install | bash

Есть и другие: npm install -g opencode-ai (также через bun, pnpm, yarn), brew install anomalyco/tap/opencode для macOS и Linux, пакеты для Arch, Chocolatey и Scoop на Windows, образ Docker. Авторы отмечают, что установка через скрипт ставит бинарник opencode и может конфликтовать с установленной второй версией. Не смешивайте способы.

Первый запуск

1. Подключите провайдера. В интерфейсе наберите /connect и выберите поставщика.
2. Перейдите в каталог проекта: cd /путь/к/проекту.
3. Запустите opencode.
4. Выполните /init. Агент изучит проект и создаст в корне файл AGENTS.md с описанием структуры и принятых соглашений. Его стоит закоммитить: он помогает агенту понимать код.

Дальше можно просто писать задачи. Файлы подмешиваются в запрос через @ с поиском по имени, картинки можно перетащить в окно терминала.

Режимы Plan и Build

Это самая полезная привычка. Клавиша Tab переключает режимы:

• Plan не вносит изменений, он только предлагает, как реализовать задачу. Попросите план, посмотрите, поправьте его уточнениями.
• Build делает работу: правит файлы, запускает команды.

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

Если результат не устроил, команда /undo откатывает изменения и возвращает ваше сообщение для правки, /redo повторяет. Работает несколько раз подряд.

Как подключить свои модели

Вариантов три.

Каталог Zen. В /connect выберите провайдера opencode, на opencode.ai/auth войдите, пополните кредиты и скопируйте ключ. Модели от команды проекта, проверенные в роли агентов.

Любой OpenAI-совместимый сервис. В /connect пролистайте до Other, задайте идентификатор и вставьте ключ, потом опишите провайдера в opencode.json через пакет @ai-sdk/openai-compatible.

Переопределить адрес у встроенного провайдера. Именно так подключается Zukko для Claude, у нас об этом написано в документации по opencode↗. Файл ~/.config/opencode/opencode.json:

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

Ключ fetch_... кладёте в переменную окружения:

export ZUKKO_API_KEY=fetch_ваш_ключ
opencode models

Команда opencode models показывает доступные модели, а в самой программе то же даёт /models. Выберите anthropic/claude-sonnet-5. Адрес должен заканчиваться на /v1: без него запросы из opencode уходят не на тот путь и возвращают 404. Это отличает opencode от Claude Code, который /v1 добавляет сам.

Проверить связку можно без интерфейса: opencode run "Объясни, что делает этот проект" отправит одну команду и завершится.

Файл конфига может лежать глобально (~/.config/opencode/opencode.json) и в корне проекта. Проектный имеет приоритет над глобальным, и его можно безопасно хранить в git, если в нём нет самого ключа. Поэтому ключ лучше брать из переменной окружения, как выше.

Работает ли opencode в России

Сама программа локальная, и доступность определяется поставщиком модели. Если нужный поставщик напрямую недоступен или не принимает ваш способ оплаты, подключайте модели через шлюз. Доступ из России у Zukko идёт через шлюз, оплата СБП (платёжная страница добавляет комиссию 8,5% сверху), картой MasterCard или криптовалютой. Баланс общий для всех инструментов: тот же ключ подойдёт для Claude Code или Cursor.

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

Возьмём условный первый день (объёмы — допущение для примера): вы просите объяснить проект и сделать пару правок, около 300 000 токенов входа и 20 000 выхода. Цены Zukko на 18 октября 2026, $ за 1M токенов, кэш не учитываем:

Агентные сессии обычно читают много, поэтому реальный расход зависит от проекта. Актуальные цены лежат в GET https://api.zukko.pro/v1/models, а какая модель подходит именно вам, выясняйте на своих задачах. Чтобы начать, создайте ключ в кабинете↗.

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

opencode бесплатный?

Сама программа с открытым кодом. За вызовы моделей платите поставщику, которого подключили. У Zen и у других провайдеров свои тарифы и условия, читайте их в документации этих сервисов.

Чем opencode отличается от Claude Code?

Claude Code ориентирован на модели Claude, opencode подключается к разным поставщикам. Кроме того, у них разные команды, формат настроек и адреса: для Claude Code адрес без /v1, для opencode с /v1.

Где хранится ключ после /connect?

В файле ~/.local/share/opencode/auth.json. Если ключ нужен только из окружения, укажите {env:ИМЯ} в apiKey конфига.

Можно ли держать несколько провайдеров сразу?

Да. Каждый описывается своим блоком в provider, а переключаться между моделями можно командой /models.