Вчера мне скинули вопрос: "Поставил OpenCode, а он ругается на API-ключ. Что делать?". Знакомая ситуация. Сам когда-то потратил на установку минут двадцать не потому, что это сложно, а потому что пропустил один шаг в настройке. Рассказываю, как сделать всё с первого раза.
OpenCode - это ИИ-агент, который живет прямо в вашем терминале. Он читает файлы проекта, правит код, запускает команды и объясняет, что сделал. По сути, Cursor без отдельного интерфейса - работает там, где вы и так работаете, в консоли.
Что понадобится перед установкой
Три вещи. Современный эмулятор терминала - OpenCode капризен к старым консолям. На Linux и macOS отлично работают Kitty, Ghostty, Alacritty. На Windows берите WezTerm или Alacritty: встроенный cmd будет тормозить и глючить на отрисовке интерфейса.
Второе - API-ключ от той модели, которую хотите подключить. OpenCode сам нейросетью не является, он лишь оболочка, которая ходит к поставщикам LLM. Третье - Node.js, если ставите через npm. Версия 18 и выше, старые версии ломают установку.
Небольшая ремарка про ключи. Классическая проблема из России - оплата зарубежных API картой, которой просто нет. Я решил это для себя через 3GPT: там за 149 рублей в месяц дают доступ к ChatGPT 6, Claude Fable 5, Opus и другим флагманам, пополнение российской картой или через СБП. Дальше в статье покажу, как подключить OpenCode к такому провайдеру - всё делается одним JSON-файлом.
Установка на macOS и Linux: одна команда
Официальный способ - сценарий установки. Открываете терминал и вставляете:
curl -fsSL https://opencode.ai/install | bash
Скачивается бинарник под вашу систему, ставится в PATH. Занимает секунд десять-двадцать. Никаких wizards, никаких галочек - команда отработала, всё готово.
Если вы живете в экосистеме Homebrew, можно так:
brew install anomalyco/tap/opencode
Обновления потом подтягиваются через brew upgrade вместе со всем остальным - для многих это удобнее.
Установка на Windows
Через Chocolatey:
choco install opencode
Или через Scoop:
scoop install opencode
Обе утилиты сами пропишут PATH. Если ни одной нет - ставьте Scoop, он не требует прав администратора и живет в пользовательской папке. В PowerShell это две команды.
Установка через Node.js
Вариант для тех, у кого уже стоит Node и кто любит держать всё в npm-экосистеме:
npm install -g opencode-ai
Работают и альтернативы: bun install -g opencode-ai, pnpm install -g opencode-ai, yarn global add opencode-ai. Есть еще установка через Mise (mise use -g github:anomalyco/opencode) и запуск в Docker - последний вариант хорош, если хотите изолировать агент от основной системы.
Личный совет: не ставьте двумя способами одновременно. Видел ситуацию, когда curl-версия и npm-версия конфликтовали в PATH, и человек час ловил загадочное "command not found". Проверьте, что установилось, командой opencode --version.
Первый запуск и подключение модели
Переходите в папку проекта и запускаете:
cd путь/к/вашему/проектуopencode
Я почти всегда запускаю OpenCode не из голого терминала, а из VS Code - встроенный терминал редактора показывает измененные файлы рядом, и видеть diffs вживую сильно удобнее. Не обязательно, но попробуйте.
При первом старте OpenCode спросит провайдера и модель. Если у вас прямой ключ OpenAI или Anthropic - просто введите его. Если работаете через посредника с OpenAI-совместимым API (таких сейчас большинство), создайте в корне проекта файл opencode.json и укажите там конечную точку провайдера и список разрешенных моделей. Ключ обычно задается переменной окружения. На Linux и macOS - через export в .bashrc или .zshrc, на Windows через setx ИМЯ_ПЕРЕМЕННОЙ "значение", после чего обязательно откройте новый терминал - старый переменную не увидит. Тот самый шаг, на котором спотыкался мой знакомый из начала статьи.
Отдельно про модели. Через 3GPT доступен весь флагманский набор - ChatGPT 6 Astra, ChatGPT 6.1 Sol, Claude Fable 5.1, Claude Opus 5.5, генерация изображений через Nano Banana и видео. В OpenCode я обычно вешаю Claude Opus на сложный рефакторинг, а ChatGPT оставляю под рутину - переключение модели делается прямо из интерфейса агента за пару секунд.
Пара привычек, которые сэкономят вам нервы
- Работайте в Git-репозитории. Агент правит файлы напрямую, и откат без версии - это боль.
- Начинайте с мелких задач: переименуй функцию, напиши тест. Доверие к агенту наращивается постепенно.
- Читайте diffs перед применением. Всегда. Модели ошибаются уверенно.
- Коммитьте только те изменения, которые понимаете сами.
И запускайте агента только в папке проекта, а не в домашней директории - иначе он начнет шариться по всему диску в поисках контекста.
Если что-то не заводится
Три частые проблемы. Первая - ошибка авторизации с требованием Bearer-токена: ключ не попал в окружение, проверьте echo $API_KEY или, на Windows, откройте заново терминал. Вторая - модель недоступна: в 90% случаев неправильно указан base URL в opencode.json. В обсуждениях на Reddit разработчики не раз сходились в том, что чаще всего виноват лишний или отсутствующий /v1 в конце адреса. Третья - кривой интерфейс в терминале: вы в старой консоли, ставьте WezTerm.
Если полный стек не нужен и хочется просто покопаться в моделях через браузер - 3GPT дает доступ ко всем флагманам из России в одном месте, а у сервиса есть и готовые ИИ-агнты под конкретные задачи, где модель можно менять прямо в чате.
Установка OpenCode - дело десяти минут, вся сложность прячется в настройке доступа к моделям. Один раз собрав конфиг, вы получаете полноценного ИИ-напарника прямо в терминале. Следующий шаг простой: откройте терминал, вставьте curl-команду и дайте агенту первую мелкую задачу - например, попросите написать тест к любой функции в вашем проекте. К концу рабочей недели у вас будет отлаженный конфиг и понятное ощущение, стоит ли доверять агенту больше.