OpenCode: установка на Windows, macOS и Linux, модели, Zen, Go и настройка

OpenCode — ИИ-агент с открытым исходным кодом для программирования от компании Anomaly: он читает проект, правит файлы и запускает команды в терминале на модели, которую вы подключите сами. Код лежит в anomalyco/opencode под лицензией MIT, на 13.11.2026 у проекта 226 583 звезды и 30 675 форков, последняя версия — v2.3.0 от 13.11.2026.

Работать с OpenCode можно в терминале, в приложении OpenCode Desktop, в браузере, с телефона и из своего кода через SDK. Каталог моделей приходит из Models.dev: в нём больше 200 провайдеров, плюс локальные модели и бесплатные модели самого OpenCode.

Способ установки выберите в переключателе вверху страницы: скрипт для macOS, Linux и WSL, npm, Homebrew, AUR, архив для Windows, OpenCode Desktop или Docker. После установки перейдите в папку проекта и выполните opencode. В таблице — что учесть на разных системах.

Провайдера подключают командой /connect в TUI: выберите его, введите ключ API или войдите через OAuth, затем выберите модель в /models. Без TUI то же делает opencode auth login, ключ можно передать и переменной окружения вроде ANTHROPIC_API_KEY.

Модель по умолчанию задаёт поле model в opencode.json в формате провайдер/модель, на один запуск — флаг --model. Список провайдеров и моделей OpenCode берёт из каталога Models.dev.

# в TUI
/connect          # выбрать провайдера и войти
/models           # выбрать модель

# из терминала
opencode auth login anthropic --method key
opencode auth list
opencode models   # все доступные модели

# локальная модель через Ollama
ollama serve
ollama pull qwen3:8b

# модель на один запуск
opencode run --model anthropic/claude-sonnet-5-5 "Refactor parseToken"

Сам OpenCode бесплатный: код открыт под MIT, CLI и Desktop скачиваются без оплаты. Без затрат агент работает на локальной модели и на бесплатных моделях OpenCode, их 14 на 13.11.2026. Платить приходится провайдеру, если вы подключаете свой ключ API или подписку.

OpenCode Zen — прежнее имя оплаты по факту: с октября 2026 года это OpenCode Models в OpenCode Console, вы пополняете баланс и платите за токены. OpenCode Go — подписка с фиксированной ценой на 32 модели, в основном открытые, подключается через /connect как OpenCode Go.

Перейдите в папку проекта и выполните opencode: откроется TUI. Подключите модель через /connect или выберите бесплатную в /models и напишите задачу обычными словами, а /undo откатит последний запрос вместе с правками в файлах.

Основных агентов два: build правит файлы и запускает команды, plan изучает код и пишет план без правки файлов проекта. Переключает их Shift+Tab. Для скриптов и CI есть opencode run, он отправляет запрос и печатает ответ без интерфейса.

cd ~/code/my-project
opencode                                   # TUI в папке проекта

opencode run "Explain this repository"     # без интерфейса
opencode run --agent build "Fix the failing test"
opencode run --continue "Now handle the expired case"
opencode run --format json "List the TODO comments"

opencode mini                              # упрощённый интерфейс

Настройки OpenCode хранятся в opencode.json или opencode.jsonc, в JSONC можно писать комментарии и запятые в конце. OpenCode ищет файлы от текущей папки до корня диска и склеивает их: конфиг проекта перекрывает глобальный, файл в папке .opencode — файл рядом с ним, системный конфиг — все остальные.

Ключи держите вне файла: {env:ANTHROPIC_API_KEY} подставляет переменную окружения, {file:~/.secrets/openai-key} — содержимое файла. Тема, клавиши и другие настройки терминала лежат отдельно, в ~/.config/opencode/cli.json.

{
  "$schema": "https://opencode.ai/config.json",
  "model": "anthropic/claude-sonnet-5-5",
  "default_agent": "build",
  "permissions": [
    { "action": "shell", "resource": "*", "effect": "ask" },
    { "action": "shell", "resource": "git status *", "effect": "allow" }
  ],
  "providers": {
    "anthropic": {
      "settings": { "apiKey": "{env:ANTHROPIC_API_KEY}" }
    }
  },
  "mcp": {
    "servers": {
      "playwright": { "type": "local", "command": ["bunx", "@playwright/mcp"] }
    }
  },
  "instructions": ["CONTRIBUTING.md"],
  "skills": ["./team-skills"],
  "plugins": ["opencode-example-plugin"]
}

OpenCode расширяется файлами в папке .opencode проекта или в ~/.config/opencode для всех проектов. Формат агентов, скиллов и команд первой версии вторая читает без изменений, плагины переписывают под новый API.

Сам OpenCode работает на вашем компьютере: программа ставится из GitHub, npm или Homebrew, а с локальной моделью через Ollama, LM Studio или vLLM обходится без аккаунтов и внешних сервисов. У сайта OpenCode есть русская версия opencode.ai/ru, документация первой версии переведена на русский.

Доступ к облачным моделям зависит от провайдера. У бесплатных Inkling 2 Small Free и Beam Free Россия в списке стран без доступа, LongCat 2.5 Free размещена в Китае, платные модели Console — в США и ЕС. Console и Go оплачивают через Stripe: карта, Link, Alipay, UPI или WeChat Pay.

Все четыре — агенты для работы с кодом в терминале и редакторе. OpenCode и Kilo Code подключают модели многих провайдеров, Claude Code рассчитан на модели Claude, Codex — на модели OpenAI, Kilo CLI — форк OpenCode под платформу Kilo.

Подписку OpenCode Go можно подключить в Claude Code и Codex: оба в списке проверенных клиентов Go. Скиллы в формате SKILL.md понимают все четыре агента.