OpenCode: что это, как установить и подключить модель в 2026

Про OpenCode мне снова начали писать вопросы после того, как репозиторий перевалил за двести тысяч звёзд на GitHub. Люди услышали, что есть «бесплатный Claude Code с любой моделью», и пошли искать по-русски - а находят в основном короткие новости и пересказы ридми. Закрываю дыру.

Ниже разбираю всё по официальной документации, актуальность которой проверил сегодня: что это за инструмент, как поставить его на macOS, Linux или Windows, как подключить модель и что сделать при первом запуске. Отдельно - про деньги, потому что «бесплатный» тут относится только к инструменту: модели стоят денег, и это путает чаще всего.

В Telegram-канале - что нового в вайб-кодинге: инструменты, находки, ошибки. Подпишись, чтобы ничего не пропустить.

Что такое OpenCode простыми словами?

Если совсем коротко: OpenCode делает то же, что Claude Code, - принимает задачу на обычном языке и выполняет её в твоём проекте. Разница в двух вещах. Код полностью открыт, его можно прочитать и проверить. И инструмент не привязан к одному поставщику моделей: работает с 75+ провайдерами, от Anthropic и OpenAI до локальной модели на твоём железе.

Проект делает команда Anomaly. Репозиторий создан 30 апреля 2025 года, и по состоянию на 14 сентября 2026 года у него больше 207 тысяч звёзд и 27 тысяч форков. Язык - TypeScript. Документация обновляется постоянно: последняя её правка датирована 13 сентября 2026 года, так что инструкция ниже собрана по свежей версии.

Не путай названия: пакет в npm называется opencode-ai, репозиторий - anomalyco/opencode, а команда в терминале - просто opencode. В старых статьях можно встретить адрес sst/opencode: организация сменила имя, и старая ссылка сейчас перенаправляет на новую.

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

Если у тебя уже есть подписка Claude, я бы оставил Claude Code основным инструментом - у нас про него есть подробный материал с установкой. OpenCode имеет смысл в трёх случаях: хочешь работать через подписку ChatGPT Plus или GitHub Copilot, хочешь гонять локальную модель без счетов за API, или хочешь один интерфейс сразу для нескольких моделей. Про Codex у меня тоже есть разбор с установкой и доступом из России.

Если ты вообще только выбираешь инструмент, начни с карты: чем кодят в 2026. А если OpenCode у тебя уже стоит и нужно подключить его вместе с другими агентами в Devin Desktop - есть материал про связку через ACP.

Что нужно перед установкой?

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

Вторая вещь - модель. OpenCode работает через ту модель, которую ты подключишь: сам по себе он запросы не обрабатывает. Вариантов четыре: подписка (ChatGPT Plus, GitHub Copilot, GitLab Duo), ключ API любого провайдера, агрегатор OpenCode Zen от самой команды или локальная модель через Ollama. Все четыре пути разбираю в разделе про подключение.

Без описания проекта агенту приходится самому угадывать команды сборки, структуру файлов и принятые правила - отсюда и «галлюцинации». У OpenCode за это отвечает файл AGENTS.md - по сути тот же Второй мозг для агента. На практикуме за три вечера собираешь эту связку под себя целиком: ИИ-клон + Второй мозг + Контекст-инжиниринг. Она применима и в OpenCode, и в Claude Code, и в любом другом агенте - меняется только имя файла с инструкциями.

Практикум по вайб-кодингу

+Твой второй мозг

3 вечера - инструменты, метод, первый проект

Старт 22–24 сентября  ·  2 000 ₽

Записаться →

Как установить OpenCode на macOS и Linux?

Рекомендованный путь - официальный установщик:

1. Запусти установщик

   bash

   Скопировать

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

   Скрипт определяет систему и скачивает OpenCode. Если после установки команда не находится - закрой терминал и открой заново: в новой сессии путь подхватывается.

2. Проверь, что всё встало

   bash

   Скопировать

   opencode --version

   Команда отвечает номером версии - значит, установка прошла. Ответ «command not found» возвращает к первому шагу: новая сессия терминала или ручная правка PATH.

Если привык управлять пакетами сам, варианты такие:

brew install anomalyco/tap/opencode

npm install -g opencode-ai

Команда для Homebrew намеренно с anomalyco/tap/ в начале: документация советует именно их собственный tap, потому что формула brew install opencode от команды Homebrew обновляется реже. То же имя пакета opencode-ai работает и для bun, pnpm и yarn (bun install -g opencode-ai, yarn global add opencode-ai). На Arch Linux - sudo pacman -S opencode из стабильного репозитория или paru -S opencode-bin для самой свежей версии из AUR.

Обновляется OpenCode командой opencode upgrade; при запуске он и сам скачивает обновления, если автообновление не отключено. После обновления проверь версию уже знакомой opencode --version. Удаление - тоже встроенное:

opencode uninstall

Команда покажет, что именно будет стёрто, и спросит подтверждение. Конфиги и данные сессий при желании можно оставить - для этого есть флаги --keep-config и --keep-data.

Как установить OpenCode на Windows?

Первый путь, который советуют сами разработчики, - WSL. Ставится одной командой в PowerShell от имени администратора:

wsl --install

После перезагрузки открой Ubuntu из меню «Пуск» и выполни внутри знакомую команду:

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

Твои файлы с дисков Windows доступны из WSL через /mnt/ - диск C: лежит в /mnt/c/, диск D: в /mnt/d/. То есть проект из C:\Users\Имя\project открывается так:

cd /mnt/c/Users/Имя/project
opencode

Второй путь - без WSL, через пакетные менеджеры Windows. В PowerShell:

choco install opencode

scoop install opencode

Третий - десктоп-приложение и веб-версия. Приложение ставится как обычная программа и рисует интерфейс в окне, без терминала. Веб-версия поднимается командой opencode web: она открывает OpenCode в браузере, и документация советует запускать её тоже из WSL, чтобы не было проблем с доступом к файлам. В документации есть и более редкие варианты - mise, Docker и готовый бинарник со страницы релизов на GitHub. Установка через bun на Windows пока в работе - если bun твой основной пакетный менеджер, бери npm-вариант.

Как подключить модель к OpenCode?

OpenCode поддерживает 75+ провайдеров через связку AI SDK и Models.dev, плюс локальные модели. Большинство подключается командой /connect внутри интерфейса; для локальных дополнительно указывается адрес сервера в конфиге. Варианты отличаются способом оплаты и требованиями к компьютеру:

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

Подключение выглядит так: вводишь /connect, выбираешь OpenCode Zen, сайт opencode.ai/auth просит войти и привязать оплату, получаешь ключ и вставляешь его. Дальше команда /models покажет список рекомендованных моделей. Среди них, например, GPT 5.2, GPT 5.1 Codex, Claude Opus 4.5, Claude Sonnet 4.5, Gemini 3 Pro и MiniMax M2.1. Документация при этом честно предупреждает: список не исчерпывающий и быстро устаревает, потому что модели выходят каждую неделю.

Подписки подключаются той же командой /connect: выбираешь ChatGPT Plus или GitHub Copilot из списка и входишь в свой аккаунт - дополнительной настройки не требуется.

Если выбираешь Anthropic, в /connect будет два варианта: вручную вставить ключ API или выбрать Claude Pro/Max и авторизоваться через браузер. При этом Anthropic запрещает сторонние плагины для использования подписки Claude Pro/Max, и встроенные плагины такого рода из OpenCode убрали начиная с версии 1.3.0. Если наткнёшься в старой статье на «OpenCode через подписку Claude» - это про те удалённые плагины, не про официальную авторизацию. Зато подписки ChatGPT Plus, GitHub Copilot, GitLab Duo (помечена как экспериментальная) и Atomic Chat работают без дополнительной настройки.

Ключи, которые ты вводишь через /connect, OpenCode хранит в файле ~/.local/share/opencode/auth.json. Модель по умолчанию, если не хочешь выбирать её каждый раз, прописывается в конфиге opencode.json в корне проекта:

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-4-5"
}

Формат - провайдер/модель, оба идентификатора видны в выдаче /models.

Как подключить локальную модель через Ollama?

Это путь без счетов за API вообще: модель крутится на твоём компьютере. Ставишь Ollama с официального сайта и скачиваешь модель:

ollama pull qwen3-coder

Приятная деталь из документации: Ollama умеет настраивать себя для OpenCode автоматически - у них есть отдельная инструкция по интеграции. Если хочешь прописать всё руками, в opencode.json добавляется провайдер с адресом локального сервера Ollama:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": {
        "baseURL": "http://localhost:11434/v1"
      },
      "models": {
        "qwen3-coder": {
          "name": "Qwen3 Coder"
        }
      }
    }
  }
}

Дальше /models в интерфейсе покажет локальную модель в списке, выбираешь её - и работаешь. Одна практическая оговорка из документации: если агент перестаёт вызывать инструменты (не правит файлы, не запускает команды), увеличь num_ctx в настройках Ollama - начни со значений 16k-32k. Локальные модели слабее облачных именно в работе агентом, и маленький контекст это усугубляет.

Сколько стоит OpenCode и работа с ним?

Все расходы тут - на модель, и сценариев четыре. Через ключ API или Zen ты платишь за фактический расход, и сумма зависит от того, как много агент работает. Go - подписочный план на открытые модели от команды OpenCode. Числовых цен и лимитов на страницах документации нет - их смотришь при подключении, от них и зависит, что выгоднее. При работе через ChatGPT Plus или Copilot запросы идут в рамках уже оплаченной подписки, просто помни, что у подписок есть свои лимиты на интенсивность. Наконец, за запросы к локальной модели через Ollama платить не нужно вовсе - но нужен достаточно мощный компьютер, чтобы модель работала шустро.

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

Что сделать при первом запуске?

Первый запуск - в папке твоего проекта:

cd путь/к/проекту
opencode

Откроется интерфейс с полем ввода. Первым делом - команда /init: агент просканирует важные файлы репозитория, при необходимости задаст пару вопросов и напишет AGENTS.md - инструкцию о том, как устроен проект, какие команды запускать для сборки и тестов и какие тут приняты соглашения. Этот файл документация советует закоммитить в git, и дальше OpenCode использует его как постоянную инструкцию проекта. По назначению AGENTS.md - прямой аналог CLAUDE.md: та же идея Второго мозга, только в экосистеме OpenCode.

Второе - режим плана. Клавиша Tab переключает между двумя основными агентами: Build работает с полным доступом к файлам и командам, а Plan предназначен для анализа и планирования - правки файлов и bash-команды в нём по умолчанию требуют твоего подтверждения. Для новых задач документация советует начинать с плана: читаешь, что агент собрался делать, поправляешь формулировку, и только потом тем же Tab возвращаешься в Build.

Документация даёт тут совет, который я сам повторяю на каждом эфире:

Чем конкретнее задача и чем больше контекста, тем меньше переделок. Файлы в запрос добавляются через @ - начни печатать имя, и интерфейс найдёт их нечётким поиском. Картинки можно прямо перетащить в терминал, а сообщение, начатое с !, выполняется как shell-команда - её вывод попадёт агенту в контекст. Ошибся с задачей или агент сделал не то - /undo откатывает изменения, и команду можно выполнить несколько раз подряд. Передумал снова - /redo вернёт отменённое. А /share создаёт ссылку на разговор для команды; без этой команды разговор никуда не публикуется.

Что ещё умеет OpenCode?

Свои команды. Любой повторяющийся запрос превращается в команду: кладёшь markdown-файл в .opencode/commands/, в его frontmatter задаёшь description, agent и model, а ниже пишешь шаблон промпта. Дальше команда вызывается через /. Проверка проекта перед публикацией, разбор свежих ошибок, генерация миграции - всё, что ты просишь регулярно.

Субагенты. Кроме Build и Plan внутри живут ещё трое: General для многошаговых задач (доступ ко всем инструментам, кроме списка задач), Explore для быстрого чтения кода без права правок и Scout для изучения внешних библиотек. Вызываются упоминанием через @ прямо в сообщении.

MCP-серверы. Внешние инструменты подключаются через конфиг opencode.json, секция mcp - локальные и удалённые серверы поддерживаются оба. Каждый MCP-сервер добавляет свои инструменты в контекст, и с жадным сервером вроде GitHub-овского контекст съедается очень быстро - подключай точечно, только нужное. Про сам принцип MCP у нас есть материал с готовыми связками - написан про Claude Code, но протокол общий.

Веб-версия и сервер. opencode web открывает интерфейс в браузере. Для доступа с другой машины - opencode serve --hostname 0.0.0.0 --port 4096, и здесь при любом сетевом доступе обязательно задай пароль через переменную OPENCODE_SERVER_PASSWORD: без пароля сервер не защищён.

Что делать, если установка пошла не так?

«opencode: command not found» после установки. Терминал ещё не знает про новый путь. Сначала просто закрой и открой терминал. Если не помогло, смотри, куда установщик положил бинарник, и добавь эту папку в PATH своего терминала.

Модель молчит или ругается на авторизацию. Проверь, что провайдер подключён: набери /connect и пройди авторизацию заново. Ключи живут в ~/.local/share/opencode/auth.json - если переносил установку с другой машины или чистил папки, файл мог потеряться. Ошибки ProviderInitError и AI_APICallError в документации разбираются отдельно: при первой помогает повторная авторизация провайдера, при второй - очистка папки ~/.cache/opencode и перезапуск.

Интерфейс кривой: панели расползаются, вместо символов нечитаемые знаки. Начни с проверки терминала. Поставь один из рекомендованных - WezTerm работает на всех трёх системах - и запусти OpenCode из него.

Если ничего не помогло, иди в логи: в macOS и Linux они лежат в ~/.local/share/opencode/log/, а в Windows нажми Win+R и введи %USERPROFILE%\.local\share\opencode\log. Хранятся последние десять файлов, подробность включается флагом opencode --log-level DEBUG. С этим логом уже можно идти в Discord проекта или писать сообщение об ошибке на GitHub.

Что ещё спрашивают про OpenCode?

Полная схема вайб-кодинга за три вечера: ИИ-клон + Второй мозг + Контекст-инжиниринг. Записи эфиров в личном кабинете, доступ 30 дней.

Практикум по вайб-кодингу

+Твой второй мозг

3 вечера - инструменты, метод, первый проект

Старт 22–24 сентября  ·  2 000 ₽

Записаться →

Новые материалы - дайджестом, без спама

Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

Подписаться в Telegramили на email