Интеграция · OpenCode

OpenCode в России: 400 моделей в терминале

Терминальный ассистент подключается к Polza одной командой — скрипт сам проверит ключ, загрузит список моделей и допишет конфиг. Оплата картой РФ, зарубежные аккаунты не нужны.

Получить API-ключ Как подключить Документация

Настройка одной командой
Работает из РФ напрямую
Карта РФ и СБП
400+ моделей вместо встроенных

~/project · opencode

$ curl -fsSL https://s3.polza.ai/scripts/opencode.sh | bash

# проверка зависимостей: curl, jq, opencode

Введите API-ключ: sk-polza-••••••••••••

✓ ключ валиден, загружено 412 моделей

✓ opencode.json обновлён, провайдер polza

$ opencode

Так выглядит подключение: ключ, адрес API и модель.

Что такое OpenCode

OpenCode — терминальный ассистент для разработчиков с открытым кодом. Запускается в папке проекта, понимает его контекст и помогает писать, редактировать и отлаживать код, не переключаясь в браузер.

От автодополнения он отличается тем, что работает задачами, а не строками: вы описываете, что нужно, он сам решает, какие файлы открыть и что в них поменять, запускает команды и читает их вывод.

Скачать и пользоваться можно бесплатно — это открытый проект. Платной остаётся только модель, к которой ассистент обращается.

Почему OpenCode не отвечает из России

Сам ассистент ставится свободно — curl, npm, brew, choco или Docker. Упирается всё в провайдера, к которому он обращается за моделью.

Встроенные провайдеры молчат

Штатно OpenCode ходит к зарубежным API, а они не обслуживают российские адреса: ассистент ставится, но на первом запросе отдаёт ошибку.

Адрес Polza отвечает из РФ напрямую.

Картой не оплатить

У каждого провайдера из коробки своя оплата зарубежной картой, и подключить российскую не выйдет.

Карта РФ, СБП или счёт для юрлица.

Конфиг под каждого провайдера свой

Чтобы сравнить Claude с GPT, приходится описывать в opencode.json два разных блока и держать два ключа.

Один провайдер, весь каталог моделей.

Бесплатные модели кончаются

Бесплатные тарифы упираются в лимиты и очереди, а агентный режим выбирает их за вечер работы.

Оплата за токены: пополнил и работаешь.

Юрлицу не провести оплату

Подписку на зарубежный сервис не примет бухгалтерия, закрывающих документов нет.

Договор, счёт, УПД и НДС.

Непонятна цена сессии

Агент читает десятки файлов за задачу, и сколько это стоило, выясняется по факту списания.

Статистика по ключам и моделям в кабинете.

Как подключить OpenCode к Polza

Быстрый путь — один скрипт. Ручной вариант нужен, если конфиг уже настроен под другие провайдеры и перезаписывать его не хочется.

Что нужно для запуска

Современный терминал

WezTerm, Alacritty, Ghostty, Kitty или iTerm2. В стандартной консоли интерфейс отображается заметно хуже.

curl и jq

Нужны скрипту автонастройки для проверки ключа и загрузки списка моделей. При ручной настройке не требуются.

Ключ Polza

Создаётся в кабинете за минуту. Пополняется картой РФ, через СБП или по счёту для юрлица.

Шаг 1
Установите OpenCode
Любым удобным способом — доступны установщик, npm, Homebrew, Chocolatey и Docker. Нужен современный терминал: WezTerm, Alacritty, Ghostty, Kitty или iTerm2.
Терминал · установка
```
$ curl -fsSL https://opencode.ai/install | bash

# или через npm:
$ npm install -g opencode-ai
```
Шаг 2
Запустите скрипт автонастройки
Скрипт проверит зависимости, спросит ключ, убедится, что он рабочий, загрузит список моделей и сам допишет конфиг. Нужны установленные curl и jq.
Автонастройка
```
$ curl -fsSL https://s3.polza.ai/scripts/opencode.sh | bash

  ✓ провайдер polza добавлен в opencode.json
```
Шаг 3
Или настройте вручную
Создайте opencode.json в корне проекта и опишите провайдера сами. Так удобнее, если в конфиге уже есть другие источники моделей:
opencode.json
```
{ "provider": { "polza": {
    "npm": "@ai-sdk/openai-compatible",
    "baseURL": "https://polza.ai/api/v1",
    "apiKey": "<ваш ключ>"
} } }
```
Шаг 4
Выберите модель и работайте
Запустите opencode в папке проекта и вызовите команду /models — в списке появятся модели Polza. Дальше всё как обычно.
Выбор модели
```
$ cd ~/project && opencode
> /models

  ● anthropic/claude-sonnet-5
```

Конфиг в проекте, а не в системе

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

Открыть каталог моделей

Что умеет OpenCode

Возможности, ради которых его держат в терминале рядом с редактором.

Понимает контекст проекта

Читает файлы вокруг задачи сам, без ручного копирования кусков кода в промпт.

Пишет и правит код

Генерация по описанию, рефакторинг, разбивка больших функций — с показом изменений перед применением.

Отладка

Разбирает стектрейс и логи, находит причину и предлагает правку с объяснением.

Команды в терминале

Запускает сборку и тесты, читает вывод и исправляется, не выходя из сессии.

Работа в TUI

Полноценный текстовый интерфейс с историей и командами — отсюда и требование к современному терминалу.

Конфиг под проект

Настройки лежат рядом с кодом, поэтому окружение переносится вместе с репозиторием.

Скрипт автонастройки

Быстро и без ошибок: проверит ключ, подтянет модели и обновит конфиг. Подходит для чистой установки.

opencode.json вручную

Нужен, если в конфиге уже описаны другие провайдеры или вы держите настройки под контролем версий.

Примеры: что поручают OpenCode

Девять сценариев, которые закрываются без участия человека после того, как задача поставлена. Все они опираются на штатные возможности — режим планирования, агентов с разными правами и свои команды.

Разобраться в незнакомом проекте

Команда /init обходит важные файлы репозитория, задаёт уточняющие вопросы, если по коду ответа нет, и собирает AGENTS.md — краткую памятку о проекте: команды сборки и тестов, структура, договорённости и подводные камни. Дальше все сессии стартуют уже с этим контекстом.

Один раз описать правила

AGENTS.md лежит в репозитории и коммитится вместе с кодом. В нём удобно зафиксировать то, что новичок узнаёт неделю: каким пакетным менеджером пользуемся, что гонять перед коммитом, какие каталоги трогать нельзя.

Сначала план, потом правки

Клавиша Tab переключает в режим планирования: агент разбирает задачу и предлагает порядок действий, ничего не меняя. Удобно на рефакторингах, где цена ошибки высокая — план можно поправить до того, как файлы поедут.

Ревью перед пушем

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

Аудит безопасности

Подагент с запретом на редактирование ищет уязвимости: непроверенный ввод, дыры в авторизации, утечки данных, проблемные зависимости и небезопасные настройки. Запускается по расписанию или перед релизом.

Тесты и разбор падений

Агент прогоняет тесты, читает вывод, находит упавшие и предлагает исправления. Это как раз тот случай, где автономность окупается: цикл «запустил — прочитал — починил — перезапустил» проходит без вас.

Массовые правки по кодовой базе

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

Отладка по стектрейсу

Агент с доступом к терминалу и чтению файлов воспроизводит ошибку, читает логи и доходит до причины. Часто быстрее, чем расставлять принты вручную.

Документация, которую никто не пишет

Агент для документации умеет править файлы, но не запускает системные команды. Ему поручают README, комментарии к функциям и описания модулей — рутину, до которой руки не доходят.

Свои команды под повторяющиеся задачи

Кроме встроенных /init, /models, /undo, /redo и /share можно завести собственные. Команда — это markdown-файл с описанием и готовым промптом: положили в .opencode/commands/, и она появляется в списке после слеша.

.opencode/commands/test.md

---
description: Прогнать тесты с покрытием
agent: build
model: anthropic/claude-sonnet-5
---

Запусти весь набор тестов с отчётом о покрытии.
Покажи упавшие и предложи, как починить.

Вызывается как /test. Во фронтматтере можно указать агента и модель — значит, у каждой команды своя цена запуска.

Что обычно заводят

/test — прогон тестов с покрытием и разбор падений.
/review — вычитка изменений перед коммитом.
/changelog — описание релиза по истории коммитов.
/migrate — типовая миграция: обновить вызовы, поправить импорты.
/audit — разовая проверка зависимостей и настроек.

Команды лежат в репозитории рядом с кодом, поэтому переезжают вместе с ним и работают одинаково у всей команды.

Агенты: кто что делает и на какой модели

У OpenCode есть основные агенты и подагенты, которым можно раздать разные права и разные модели. Это главный способ управлять расходом: тяжёлую работу отдать сильной модели, а поиск по файлам и черновой текст — дешёвой. Ключ при этом остаётся один.

Агенты: кто что делает и на какой модели
Агент	Откуда	Что ему разрешено	Какая модель подойдёт
build	Встроенный	Все инструменты: чтение, правка файлов, терминал	Сильная модель — он делает основную работу
plan	Встроенный	Анализ и планирование, без изменений в файлах	Сильная модель: ошибка в плане дороже ошибки в строке
general, explore, scout	Встроенные	Поиск по коду и вспомогательные задачи	Дешёвая: тут важнее скорость и объём
review	Заводится сам	Только чтение плюс работа с документацией	Средняя: замечания по диффу не требуют топовой
debug	Заводится сам	Чтение файлов и запуск команд в терминале	Сильная модель на запутанных багах
docs	Заводится сам	Правка файлов без системных команд	Дешёвая: текст пишется предсказуемо

build, plan, general, explore и scout идут из коробки. review, debug и docs встроенными не являются — это агенты, которых заводят под себя, примеры есть в документации проекта.

~/.config/opencode/agents/security-auditor.md

---
description: Аудит безопасности и поиск уязвимостей
mode: subagent
permission: edit: deny
model: anthropic/claude-sonnet-5
---

Ты эксперт по безопасности. Ищи непроверенный ввод,
ошибки авторизации, утечки данных и уязвимые зависимости.

permission ограничивает агента: аудитору запрещено править файлы, автору документации — запускать системные команды.

Зачем ограничивать права

Автономный агент делает ровно то, что ему разрешено. Ревьюеру не нужен доступ на запись, чтобы описать проблемы, а автору README незачем выполнять команды в терминале. Чем уже права, тем предсказуемее результат и тем спокойнее запускать агента без присмотра. Второй эффект — деньги. У каждого агента своя модель, поэтому дешёвые задачи не уходят на дорогую модель просто потому, что она выбрана по умолчанию.

Посмотреть цены моделей

Внешние инструменты через MCP

Model Context Protocol подключает к агенту то, что лежит за пределами репозитория: трекер ошибок, документацию библиотек, поиск по чужому коду, внутренние сервисы. Поддерживаются и локальные серверы, и удалённые — после подключения инструменты становятся доступны модели наравне со встроенными.

opencode.json · mcp

{ "mcp": {
    "sentry": { "type": "remote", … },
    "context7": { "type": "local", … }
} }

# каждый инструмент занимает контекст —
# включайте только те, что реально нужны

Что это даёт на практике

Агент сам смотрит в трекер ошибок и чинит то, что там висит, а не то, что вы пересказали.
Подтягивает актуальную документацию библиотеки вместо того, чтобы вспоминать версию двухлетней давности.
Ищет примеры использования в открытом коде, когда в вашем проекте такого паттерна ещё нет.

Важная оговорка из документации проекта: каждый подключённый инструмент занимает место в контексте. Десяток серверов «на всякий случай» удорожает каждый запрос, поэтому включать стоит только нужные.

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

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

OpenCode

Открытый код, конфиг в JSON рядом с проектом и готовый скрипт автонастройки. Самый быстрый путь от установки до рабочей связки.

Claude Code

Сильнее в длинных автономных задачах, настройки живут в переменных окружения. Через Polza работает тоже, под него есть отдельная страница.

Codex CLI

Инструмент OpenAI с похожей логикой. Подключается тем же ключом, инструкция есть в документации.

Напрямую или через Polza

OpenCode: Напрямую или через Polza
Из России	Встроенные провайдеры	OpenCode через Polza
Оплата	Зарубежная карта у каждого	Карта РФ, СБП, счёт для юрлиц
Доступ к API	Закрыт, нужны обходные пути	Работает из РФ напрямую
Настройка	Свой блок конфига на провайдера	Один провайдер на весь каталог
Выбор моделей	Ограничен вендором	Claude, GPT, Gemini и ещё 400
Лимиты	Очереди и квоты на бесплатных	За токены, лимиты не сгорают
Документы	Нет	Договор, счёт, УПД, НДС
Расходы	По кабинетам провайдеров	Статистика по ключам и моделям

Сколько стоит OpenCode в России

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

Ежедневная разработка

Claude Sonnet 5 — основная рабочая модель: пишет и рефакторит код, гоняет тесты, разбирается в чужом проекте.

Сложные задачи

Claude Opus 4.8 и GPT-5.5 — архитектура, запутанные баги, большие рефакторинги. Включаются, когда нужна глубина.

Рутина и прогон по файлам

GLM 5.3, Kimi и DeepSeek V4 Flash — массовые правки и черновики. В разы дешевле при сопоставимом результате.

Модели, с которых стоит начать

Anthropic: Claude Sonnet 5

anthropic/claude-sonnet-5

ежедневная разработка

Anthropic: Claude Opus 4.8

anthropic/claude-opus-4.8

сложные задачи

OpenAI: GPT-5.5

openai/gpt-5.5

рассуждения

Z.ai: GLM 5.3

z-ai/glm-5.3

дёшево и быстро

DeepSeek: DeepSeek V4 Flash

deepseek/deepseek-v4-flash

массовая рутина

Актуальные цены за 1M токенов — в каталоге моделей.

Если OpenCode не работает

Четыре причины, на которые приходится почти вся переписка с поддержкой.

Скрипт падает на проверке зависимостей

Не хватает curl или jq. Поставьте их пакетным менеджером системы и запустите скрипт заново.

Ошибка авторизации

Проверьте ключ и баланс, затем убедитесь, что baseURL записан ровно как https://polza.ai/api/v1, без лишнего слеша.

Список моделей пустой

Команда /models читает конфиг. Если правили его руками, проверьте, что JSON валиден и блок провайдера лежит внутри секции provider.

Интерфейс рассыпается

Это не про подключение, а про терминал: возьмите WezTerm, Kitty, Ghostty или iTerm2.

Для команд и юрлиц

Счёт, УПД и НДС

Оплата по счёту для ООО и ИП, договор с российским юрлицом, закрывающие документы каждый месяц.

Ключ на сотрудника

Отдельные ключи с общим балансом организации: видно, кто и сколько потратил.

Контроль бюджета

Статистика расходов по ключам и моделям в кабинете, без сюрпризов в конце месяца.

Помощь с переездом

Поможем перевести команду с зарубежных подписок на API: настройка окружений и правила расходования.

Вопросы и ответы

Работает ли OpenCode в России?

Да. Сам ассистент ставится без ограничений, а запросы идут через API Polza, которое отвечает из России напрямую. VPN не нужен.

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

Запустите скрипт автонастройки: он проверит зависимости, спросит ключ, убедится в его валидности, загрузит модели и сам обновит opencode.json.

Какой Base URL указывать вручную?

https://polza.ai/api/v1 — в поле baseURL провайдера. Тип провайдера — @ai-sdk/openai-compatible.

Бесплатный ли OpenCode?

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

Работает ли на Windows?

Да, есть установка через Chocolatey и npm. Нужен современный терминал — в стандартной консоли интерфейс отображается хуже.

Где взять список моделей?

После настройки вызовите команду /models прямо в OpenCode — список подтянется из каталога. Там же можно переключаться между моделями.

Что делать, если OpenCode не работает после настройки?

Проверьте ключ и баланс, затем убедитесь, что baseURL записан ровно как https://polza.ai/api/v1. Если правили конфиг руками, проверьте, что JSON валиден.

Что такое AGENTS.md и зачем он нужен?

Файл с правилами проекта, который попадает в контекст каждой сессии: команды сборки и тестов, структура репозитория, принятые договорённости. Создаётся командой /init и коммитится вместе с кодом.

Можно ли подключить MCP-серверы?

Да, поддерживаются и локальные, и удалённые. После подключения инструменты доступны модели наравне со встроенными. В документации проекта есть важная оговорка: каждый инструмент занимает место в контексте, поэтому включать стоит только нужные.

Чем подагенты отличаются от основных?

Основной агент ведёт диалог, подагент вызывается под конкретную задачу и имеет свои права и свою модель. Ревьюеру можно запретить правку файлов, автору документации — запуск команд, и назначить каждому модель по цене задачи.

Нужны ли аккаунты у зарубежных провайдеров?

Нет. Достаточно ключа Polza, регистрация где-то ещё не требуется.

Другие интеграции

Тот же ключ работает в остальных инструментах: меняется только место, куда вписать Base URL.

Кто проверял эту инструкцию

Илья Дашкин

Основатель Polza.AI · редакция Polza.AI

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

Обновлено 26 сентября 2026 · Как работает редакция · Нашли неточность? Напишите нам

Подключите OpenCode одной командой

Скрипт сделает всё сам: проверит ключ, загрузит модели и настроит конфиг. Дальше ассистент работает из России и за рубли.

Получить API-ключ

Остались вопросы? Документация по OpenCode, поддержка в Telegram или support@polza.ai

Инструкцию проверила редакция Polza.AI, обновлено 26 сентября 2026. Цены и список моделей меняются — актуальные смотрите в каталоге.