Какой провайдер модели выбрать для OpenCode?

OpenCode работает с 75+ провайдерами. Для кода сильнее всего Anthropic Claude. Из России удобнее всего OpenRouter - один ключ даёт доступ к моделям Anthropic, OpenAI, Google и другим, и он открывается напрямую без VPN. Если нужно совсем бесплатно и без интернета - локальные модели через Ollama (слабее облачных, но работают на вашем ноутбуке).

Нужен ли VPN из России для OpenCode?

Сам OpenCode ставится и запускается из России свободно, без VPN. А вот доступ к моделям зависит от провайдера: сайты Anthropic и OpenAI напрямую из России не открываются - для них нужен VPN. Обходные варианты без VPN - OpenRouter (работает напрямую) или локальные модели через Ollama (работают вообще без интернета).

Установка OpenCode - инструкция для участников AI Masters

Q: Сколько стоит OpenCode и правда ли он открытый?

Сам OpenCode бесплатный и с открытым кодом (проект sst/opencode на GitHub, лицензия MIT). Платить нужно только провайдеру модели за использованные токены - и то не всегда: с локальными моделями через Ollama работа полностью бесплатна. Для платных провайдеров (Anthropic, OpenAI, OpenRouter) счёт идёт по факту использования.

Q: Чем OpenCode отличается от Cursor и Claude Code?

OpenCode - открытая программа-агент с поддержкой любого провайдера модели, работает в окне команд. Cursor - это отдельное приложение-редактор (IDE) с агентом внутри. Claude Code - тоже агент в окне команд от Anthropic, но привязанный только к моделям Claude. OpenCode ближе к Claude Code по формату, но не привязан к одному провайдеру и полностью открыт.

Установка

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

OpenCode - открытая программа-помощник с ИИ (репозиторий sst/opencode). Ставится на Windows, macOS и Linux. Сам OpenCode устанавливается из России свободно, VPN для установки не нужен. А вот для доступа к модели нужен ключ провайдера - и здесь VPN может понадобиться (разбираем в шаге 2).

Что за окно команд - и почему это нормально У OpenCode нет привычного окна с кнопками: он открывается в окне команд. Такое окно (его называют «терминал») уже встроено в Windows и Mac, ставить его отдельно не нужно - на Mac это программа «Терминал», на Windows - PowerShell. Установка сводится к тому, что вы вставляете в это окно готовые команды с этой страницы (их удобно копировать кнопкой) и нажимаете Enter. Так и задумано - это обычный способ поставить такую программу.

Установить OpenCode

Рекомендуемый путь - WSL (подсистема Linux внутри Windows). OpenCode лучше всего работает в Linux-окружении, а в WSL оно уже есть.

Откройте PowerShell от имени администратора и выполните wsl --install, затем перезагрузитесь. Откроется окно команд Ubuntu.
Внутри Ubuntu установите OpenCode универсальным скриптом:

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

Если WSL ставить не хотите - можно через менеджеры пакетов Windows или npm (нужен установленный Node.js):

> scoop install opencode > choco install opencode > npm install -g opencode-ai

Схема: установка OpenCode в WSL скриптом curl (заменим на скриншот)

Самый простой способ - универсальный скрипт установки. Откройте приложение Терминал (Spotlight → «Терминал») и вставьте:

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

Если у вас установлен Homebrew - можно через него:

$ brew install sst/tap/opencode

Проверьте, что установилось: команда opencode --version должна показать версию.

Схема: установка OpenCode на macOS скриптом curl (заменим на скриншот)

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

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

Альтернативы: через npm (нужен Node.js) или из репозитория на Arch:

$ npm install -g opencode-ai $ sudo pacman -S opencode # Arch / Manjaro

Проверьте: opencode --version.

Подключить провайдера модели и ключ

OpenCode сам по себе - только «руки» агента. «Мозг» - модель - вы подключаете отдельно. Он работает с 75+ провайдерами: Anthropic (Claude), OpenAI, OpenRouter, Google, локальные модели через Ollama и другими. Для облачных нужен API-ключ провайдера.

Схема: OpenCode подключается к провайдеру модели по API-ключу (заменим на скриншот)

2.1. Запустить вход в провайдера

В том же окне команд выполните команду - откроется интерактивный выбор провайдера:

$ opencode auth login

Стрелками выберите провайдера и вставьте API-ключ. OpenCode сохранит его в ~/.local/share/opencode/auth.json. Проверить сохранённые ключи можно командой opencode auth list.

Схема: выбор провайдера и ввод ключа через opencode auth login (заменим на скриншот)

Про VPN и доступ из России Сам OpenCode ставится и работает без VPN. Но чтобы получить ключ и достучаться до модели, играет роль провайдер: сайты Anthropic и OpenAI из России напрямую не открываются - для регистрации и работы нужен VPN. Без VPN есть два пути: OpenRouter (открывается напрямую, один ключ ко многим моделям) или локальные модели через Ollama (работают вообще без интернета).

Какой ключ где взять Anthropic - console.anthropic.com (с VPN). OpenAI - platform.openai.com (с VPN). OpenRouter - openrouter.ai (без VPN). Ollama - ключ не нужен, ставится локально с ollama.com. Какой вариант выбрать под программу - подскажем в чате.

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

3.1. Создать папку проекта и запустить

Создайте пустую папку для проекта - например, ai-masters.
Перейдите в неё и запустите OpenCode:

$ mkdir ai-masters $ cd ai-masters $ opencode

Прямо в этом окне откроется рабочий экран OpenCode. Внизу - поле ввода, где вы пишете задачу обычными словами.

3.2. Написать первое сообщение агенту

opencode - ai-masters

opencode · подключён провайдер: Anthropic

Папка пуста. Опишите задачу - я начну.

Tab - Plan / Build · @ - файл · Enter - отправить

Привет, отвечай по-русски. Что ты умеешь?

пишите сюда

Что написать: «Привет, отвечай по-русски. Расскажи в двух словах, что ты умеешь.»

Результат: через несколько секунд агент пришлёт ответ. Если ответ есть - всё работает: OpenCode установлен и провайдер подключён. Если ошибка про ключ или сеть - вернитесь к шагу 2.

Полезные команды в OpenCode /init - агент изучит проект и создаст файл AGENTS.md / CLAUDE.md с описанием
Tab - переключение между режимами Plan (обдумать) и Build (делать)
@ - подставить файл в сообщение · /undo - откатить изменения

Проблемы

Типовые проблемы и решения

Сгруппировано по этапам. Если вашей проблемы нет - пишите в чат программы со скриншотом окна.

Установка

Команда opencode не найдена (command not found)

Закройте окно команд и откройте заново - PATH обновляется при новом запуске.
Если ставили скриптом - убедитесь, что ~/.opencode/bin добавлен в PATH (скрипт обычно делает это сам, но нужен перезапуск).
Как запасной вариант установите через npm: npm install -g opencode-ai.

Windows: скрипт curl не работает в PowerShell

Универсальный скрипт рассчитан на Linux/WSL. На Windows есть два пути:

Поставить WSL (wsl --install) и запускать OpenCode внутри Ubuntu - рекомендуется.
Или через менеджеры пакетов Windows: scoop install opencode / choco install opencode, либо npm install -g opencode-ai.

npm ругается: нет прав / EACCES

Не запускайте npm через sudo. Проще поставить OpenCode универсальным скриптом curl -fsSL https://opencode.ai/install | bash - он не требует прав администратора.
На macOS с Homebrew: brew install sst/tap/opencode.

Провайдер и ключ

Сайт провайдера не открывается (Anthropic / OpenAI)

Anthropic и OpenAI из России напрямую не открываются. Варианты:

Включить VPN - тогда сайт и модель работают как обычно.
Использовать OpenRouter (openrouter.ai) - открывается без VPN, один ключ даёт доступ к моделям Anthropic, OpenAI, Google и другим.
Использовать локальную модель через Ollama - без интернета и без ключа вовсе.

Агент отвечает: ошибка авторизации / invalid API key

Проверьте, что скопировали ключ целиком, без пробелов по краям.
Заново пройдите opencode auth login и вставьте ключ ещё раз.
Убедитесь, что на балансе провайдера есть средства (у платных провайдеров ключ без баланса не работает).
Список сохранённых ключей - opencode auth list.

Не знаю, какого провайдера выбрать

Короткая шпаргалка:

Есть VPN, нужен лучший результат для кода - Anthropic Claude.
Нет VPN, но готовы платить по факту - OpenRouter.
Хотите совсем бесплатно / без интернета - Ollama локально (модель слабее, но работает).

Под конкретную программу подскажем в чате.

Запуск

Запустил opencode, а он сразу закрылся

Проверьте, что запускаете внутри папки проекта (cd в неё), а не в домашней директории.
Прочитайте текст ошибки в окне - чаще всего это про непройденный opencode auth login.
Обновите OpenCode: opencode upgrade.

Интерфейс выглядит криво, символы «плывут»

Дело в самом окне команд. Стандартные «Терминал» на macOS и PowerShell на Windows работают, но иногда рисуют рамки хуже. Разверните окно на весь экран - обычно помогает. Если хочется ровнее - поставьте современное окно команд (WezTerm, Alacritty, Ghostty, Kitty), но для программы это не обязательно.

Агент отвечает на английском

Модели по умолчанию часто отвечают на английском. Напишите: «Отвечай по-русски» - и дальше диалог пойдёт на русском.

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

FAQ

Общие вопросы по OpenCode. Технические проблемы установки - в разделе выше.

Сколько стоит OpenCode и правда ли он открытый?

Сам OpenCode бесплатный и с открытым кодом - это проект sst/opencode на GitHub под лицензией MIT. Платить нужно только провайдеру модели за использованные токены.

И даже это не обязательно: с локальными моделями через Ollama работа полностью бесплатна. У платных провайдеров (Anthropic, OpenAI, OpenRouter) счёт идёт по факту использования - для учебного проекта суммы небольшие.

Какой провайдер модели выбрать?

OpenCode работает с 75+ провайдерами. Ориентир:

Anthropic Claude - сильнее всего для кода (нужен VPN и баланс).
OpenRouter - один ключ ко многим моделям, открывается из России без VPN.
Ollama - локальные модели, бесплатно и без интернета, но слабее облачных.

Нужен ли VPN из России?

Для установки самого OpenCode - нет, он ставится и запускается свободно.

Для доступа к модели - зависит от провайдера. Anthropic и OpenAI напрямую из России не открываются - нужен VPN. Без VPN работают OpenRouter (напрямую) и локальные модели через Ollama (вообще без интернета).

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

OpenCode - открытая программа-агент, работает в окне команд, подключается к любому провайдеру модели.
Cursor - отдельное приложение-редактор (IDE) с агентом внутри, с привычным окном и кнопками.
Claude Code - тоже программа-агент в окне команд, но привязана только к моделям Claude от Anthropic.

По формату OpenCode ближе всего к Claude Code, но не завязан на одного провайдера и полностью открыт.

Сколько весит OpenCode и сколько занимает установка?

OpenCode небольшой - загрузка занимает пару минут, места на диске требует немного. Обычного рабочего ноутбука хватит.

Вся настройка - 10-20 минут: поставить OpenCode (2-5 мин), подключить провайдера через opencode auth login (5-10 мин), запустить в папке проекта и проверить агента (3-5 мин).