OpenCode — ИИ агент на ПК: установка и подключение модели в 2026 году

OpenCode — открытый ИИ-агент для программирования в терминале. Сам инструмент распространяется бесплатно по лицензии MIT, а модель можно выбрать самостоятельно: от Claude и GPT до локальной модели в Ollama. Репозиторий проекта набрал более двухсот тысяч звёзд на GitHub. Формулировка «бесплатный Claude Code с любой моделью» звучит привлекательно, но нуждается в пояснении: бесплатен OpenCode, а условия использования определяет подключённая модель.

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

Практические сведения о работе с Ailoot — в документации.

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

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

OpenCode разрабатывает команда Anomaly. Репозиторий появился 30 апреля 2025 года. По состоянию на 4 октября 2026 года у него более 211 тысяч звёзд и 28 тысяч форков; эти числа проверены запросом к GitHub API. Проект написан на TypeScript. Документация регулярно меняется, поэтому приведённые ниже сведения опираются на актуальную версию.

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

Обновлено 4 октября 2026 года: команда представила OpenCode 2.0 — крупное обновление инструмента. Инструкция по установке и настройке модели ниже описывает действующую линейку 1.x. Её устанавливает команда curl -fsSL https://opencode.ai/install | bash; на 30 сентября 2026 года актуальной была версия 1.18.34. Эта линейка продолжает активно поддерживаться и устанавливается по умолчанию согласно документации на opencode.ai/docs. Отличия второй версии и рекомендации по переходу описаны ниже.

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

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

Что изменилось в OpenCode 2.0?#

OpenCode 2.0 устанавливается командой curl -fsSL https://opencode.ai/v2/install | bash. В официальном руководстве по переходу (opencode.ai/v2/docs/migrate-v1) сказано, что обе версии используют одну команду opencode и по умолчанию не устанавливаются одновременно: установщик v2 заменяет исполняемый файл v1. Перед установкой v2 через пакетный менеджер документация рекомендует удалить v1. При этом обе версии читают конфигурацию из тех же расположений — ~/.config/opencode/ и <проект>/.opencode/. Настройки, агенты и MCP-серверы поэтому можно перенести без переписывания. Обновить потребуется плагины из-за нового API, интеграции с серверным API из-за изменения протокола и настройки терминала: вместо нескольких файлов tui.json используется единый cli.json.

Среди заметных новшеств v2 — Console, платный сервис для команд с учётом расхода, бюджетами и общими правилами для участников, а также опубликованные цены подписки Go. На странице opencode.ai/go, проверенной 4 октября 2026 года, указаны $10 в месяц за Go и $40 в месяц за Go Plus с более высокими лимитами. Ранее документация называла подписку недорогой, не указывая стоимость.

Если ты только начинаешь и хочешь установить агента, следуй инструкции ниже: она описывает первую версию, которую по умолчанию устанавливает документация. Вторая версия может подойти, если нужны новые возможности для плагинов или командный сервис Console. Учти, что некоторые прежние плагины придётся адаптировать к новому API.

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

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

Также понадобится модель: OpenCode сам не обрабатывает запросы, а передаёт их подключённой модели. Подключить её можно четырьмя способами: через подписку ChatGPT Plus, GitHub Copilot или GitLab Duo; с помощью API-ключа провайдера; через OpenCode Zen от команды OpenCode; либо локально, используя Ollama. Подробности приведены в разделе о настройке модели.

Без информации о проекте агенту придётся самостоятельно определять команды сборки, структуру файлов и принятые соглашения, что может привести к ошибкам. В OpenCode инструкции о проекте можно хранить в файле AGENTS.md. Аналогичный подход применим к Claude Code и другим агентам: отличается название файла с инструкциями.

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

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

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

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

   Скрипт определит операционную систему и загрузит OpenCode. Если после установки команда не распознаётся, закрой терминал и запусти его снова: новый сеанс обновит доступные пути.

2. Убедись, что установка завершилась

   opencode --version
   

   Если команда вывела номер версии, OpenCode установлен. Сообщение command not found означает, что нужно открыть новый сеанс терминала или вручную обновить PATH.

Если ты предпочитаешь устанавливать программы через пакетный менеджер, используй один из этих вариантов:

brew install anomalyco/tap/opencode

npm install -g opencode-ai

В документации для Homebrew указан именно anomalyco/tap/: команда OpenCode рекомендует свой 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 upgrade. Если автообновление не отключено, OpenCode также загружает обновления при запуске. Проверить установленную версию можно командой 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

Другой вариант — установить OpenCode в Windows без WSL через пакетный менеджер. В PowerShell выполни одну из команд:

choco install opencode

scoop install opencode

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

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

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

Новичкам документация предлагает попробовать OpenCode Zen. По словам команды OpenCode, модели и провайдеров для этого варианта отбирали и проверяли на собственных задачах.

Подключение выполняется так: введи /connect, выбери OpenCode Zen и перейди на opencode.ai/auth, чтобы войти и настроить оплату. Полученный ключ вставь в OpenCode. Команда /models покажет рекомендованные модели. Например, 4 октября 2026 года в списке были GPT 6.1 Sol, GPT 6 Astra, Claude Opus 5.5, Claude Sonnet 5, GLM 5.3 и Kimi K2.5. Документация уточняет, что список неполный и может быстро устаревать: новые модели выходят часто.

Для подключения подписки введи /connect, выбери ChatGPT Plus или GitHub Copilot и войди в соответствующую учётную запись. Дополнительная настройка не нужна.

Для Anthropic в меню /connect доступны два способа: вручную указать API-ключ или выбрать Claude Pro/Max и пройти авторизацию в браузере. Anthropic запрещает сторонние плагины для доступа к подпискам Claude Pro/Max, поэтому OpenCode удалил встроенные плагины такого типа, начиная с версии 1.3.0. Материалы, описывающие подключение Claude через эти плагины, относятся к прежнему способу. Подписки ChatGPT Plus и GitHub Copilot работают без дополнительной настройки; GitLab Duo обозначена как экспериментальная, как и Atomic Chat.

Ключи, добавленные через /connect, сохраняются в ~/.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. Небольшой контекст может особенно осложнить агентную работу локальной модели. При необходимости модель Qwen также можно использовать через облачный провайдер и API-ключ.

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

Платить нужно за выбранную модель — есть четыре основных варианта. При использовании API-ключа или Zen стоимость зависит от фактического числа и объёма запросов. OpenCode Go — подписка на открытые модели от команды проекта: $10 в месяц за Go и $40 в месяц за Go Plus с более высокими лимитами. Эти цены указаны на странице opencode.ai/go, проверенной 4 октября 2026 года.

Лимиты зависят от модели. Например, на Go для Kimi K3 указано около 110 запросов за 5 часов (440 в месяц), а для более лёгкой DeepSeek V4.1 Flash — около 26 000 запросов за 5 часов. Для доступа к отдельным моделям сверх лимита документация указывает дополнительную стоимость: $15 в месяц за Kimi K3 и $60 за Go Plus. Точный перечень моделей и лимитов смотри на странице подписки при подключении.

Если работаешь через ChatGPT Plus или Copilot, запросы входят в уже оплачиваемую подписку, у которой могут быть собственные ограничения на интенсивность использования. При запуске модели локально через Ollama плата за API не взимается, но производительность зависит от мощности компьютера.

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

Сначала запусти OpenCode из каталога проекта:

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

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

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

В документации OpenCode рекомендуют формулировать задачи так:

Чёткое задание с достаточным контекстом обычно помогает избежать лишних исправлений. Чтобы приложить файл к сообщению, введи @ и начни печатать его имя: интерфейс выполнит нечёткий поиск. Изображения можно перетащить в терминал. Если начать сообщение с !, введённый текст выполнится как shell-команда, а результат попадёт в контекст агента.

Если агент выполнил не ту задачу, /undo отменит изменения; команду можно использовать несколько раз. Вернуть отменённое можно с помощью /redo. Команда /share создаёт ссылку на беседу. Без её использования беседа никуда не публикуется.

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

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

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

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

Веб-версия и сервер. Команда 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 работает в macOS, Linux и Windows. Затем запусти OpenCode в нём.

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

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

Открыть Ailoot.