Кратко
- Программа: OpenCode бесплатный, с открытым кодом (лицензия MIT), работает в терминале, есть настольное приложение.
- Ключ: официальные ключи Anthropic и OpenAI из России не получить, а платные модели самого OpenCode оплачиваются через Stripe, где нет российских способов оплаты. OpenCode подключают к API-шлюзу как своего провайдера.
- Оплата: баланс пополняется в рублях от $5, без подписки.
Короткий ответ
Пользоваться OpenCode в России можно. Сама программа бесплатная, а работать ей нужен доступ к моделям. Ключи Anthropic и OpenAI из России не получить и не оплатить. Подписка OpenCode Go и кредиты OpenCode оплачиваются картой, Link, Alipay, UPI или WeChat Pay через Stripe — СБП и «Мира» среди них нет. Поэтому в OpenCode добавляют своего провайдера: адрес API-шлюза https://api.teamorouter.com/v1, ключ и ID моделей. Ниже — установка, настройка, выбор модели, первый запуск и частые ошибки. Оплата — в рублях или в USDT.
Оплатить можно и криптовалютой. В окне пополнения нажмите «Оплатить криптовалютой» и переведите USDT, USDC или ETH с Binance, OKX или любой другой биржи либо кошелька — от $5, без расширения, можно с телефона. Пошагово — в статье «Как оплатить Claude API в USDT».
У нового аккаунта баланс $0 — пополните его до первого запроса. Пополнить можно от $5. Если запрос возвращает ошибку с текстом «wallet balance is insufficient», значит, баланс пуст, а base URL и ключ настроены правильно. Пополните баланс и повторите запрос.
Получить API-ключ — зарегистрируйтесь и пополните баланс от $5 в рублях через СБП, Т-Банк, ЮMoney или SberPay либо в USDT.
Что такое OpenCode
OpenCode — AI-агент для программирования с открытым кодом. Он работает в терминале, в настольном приложении и в веб-интерфейсе: читает файлы проекта, правит код, запускает команды и показывает изменения. Код открыт на GitHub под лицензией MIT. Подробнее — в статье «Что такое OpenCode».
Своих моделей у OpenCode нет: вы подключаете провайдера и платите ему за использованные токены. У команды OpenCode есть и свой платный доступ к моделям — подписка OpenCode Go и кредиты, — но пользоваться им не обязательно.
Что не работает из России и почему
| Шаг | Официальный путь | Что происходит из России |
|---|---|---|
| Поставить OpenCode | Установщик с opencode.ai, npm или Homebrew | Программа бесплатная, отдельной оплаты не нужно |
| Ключ для моделей Claude | Консоль Anthropic | Россия не входит в список поддерживаемых регионов Anthropic |
| Ключ для моделей GPT | Платформа OpenAI | Россия не входит в список поддерживаемых стран OpenAI |
| Платные модели OpenCode (Go, кредиты) | Оплата через Stripe: карта, Link, Alipay, UPI, WeChat Pay (документация OpenCode) | СБП и «Мира» в списке нет, а карты Visa, выпущенные в России, не работают за рубежом с марта 2022 года (заявление Visa) |
| Бесплатные модели OpenCode | Шлюз OpenCode с лимитами | Лимиты и ошибки бесплатного тарифа — в статье «OpenCode Free usage limit reached» |
Узкое место — не программа, а ключ и оплата. OpenCode работает с любым API, совместимым с OpenAI, поэтому достаточно добавить провайдера с адресом и ключом шлюза, который принимает оплату в рублях.
Шаг 1. Установка OpenCode
Сейчас выходят две ветки: OpenCode 1 (последний релиз на GitHub — 1.19.5 от 28 октября 2026 года) и OpenCode 2 со своей документацией. Для работы со своим провайдером подходят обе: OpenCode 2 читает конфиг в формате OpenCode 1 — так сказано в руководстве по миграции. Обе ставятся как команда opencode, поэтому рядом их не поставить — выберите одну.
OpenCode 1 (документация на русском):
- macOS и Linux:
curl -fsSL https://opencode.ai/install | bash - через npm на любой системе:
npm install -g opencode-ai - Homebrew:
brew install anomalyco/tap/opencode - Windows: OpenCode советует ставить его в WSL; можно и через
choco install opencodeилиscoop install opencode.
OpenCode 2 (документация): curl -fsSL https://opencode.ai/v2/install | bash или npm install -g @opencode/cli. Chocolatey и Scoop вторую версию не ставят.
Проверьте установку командой opencode --version: 1.x — это OpenCode 1, 2.x — OpenCode 2.
Если вам удобнее настольное приложение, провайдера там добавляют в Settings → Server → Providers → Custom provider — пошагово в документации по OpenCode.
Шаг 2. Получите ключ
Откройте консоль TeamoRouter, зарегистрируйтесь, пополните баланс и создайте API-ключ. Ключ показывается один раз — сохраните его.
Шаг 3. Подключите OpenCode
- Создайте файл
~/.config/opencode/opencode.json(для всех проектов) илиopencode.jsonв корне проекта и вставьте:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"teamorouter": {
"npm": "@ai-sdk/openai-compatible",
"name": "TeamoRouter",
"options": {
"baseURL": "https://api.teamorouter.com/v1",
"apiKey": "{env:TEAMOROUTER_API_KEY}"
},
"models": {
"gpt-6.1-sol": { "name": "GPT-6.1 Sol" },
"deepseek-v4-pro": { "name": "DeepSeek V4 Pro" },
"kimi-k3.1-pro": { "name": "Kimi K3.1 Pro" },
"glm-5.3": { "name": "GLM-5.3" }
}
}
}
}
Это формат своего провайдера из документации OpenCode. baseURL — именно с /v1 на конце.
-
Передайте OpenCode ключ через переменную окружения:
- macOS и Linux — добавьте в
~/.zshrc(или~/.bashrc) строкуexport TEAMOROUTER_API_KEY="ваш ключ TeamoRouter"и выполнитеsource ~/.zshrc; - Windows (PowerShell) —
setx TEAMOROUTER_API_KEY "ваш ключ TeamoRouter", затем закройте и снова откройте терминал; - OpenCode 2 отправляет запросы из фонового сервера, поэтому ключ нужно передать ему:
opencode service set env TEAMOROUTER_API_KEY "ваш ключ TeamoRouter"(документация).
В OpenCode 1 вместо переменной можно выполнить
/connect, выбрать Other, ввести ID провайдераteamorouterи вставить ключ. Тогда строкуapiKeyиз конфига удалите. - macOS и Linux — добавьте в
-
Запустите
opencode, выполните/modelsи выберите модель с префиксомteamorouter/. Чтобы она открывалась по умолчанию, добавьте в конфиг строку"model": "teamorouter/gpt-6.1-sol".
Шаг 4. Какую модель выбрать
Свой провайдер в OpenCode работает по протоколу OpenAI, поэтому лучше всего подходят модели, которые его поддерживают изначально:
gpt-6.1-sol— GPT-6.1 Sol от OpenAI, сильная модель для программирования (страница модели).deepseek-v4-pro— DeepSeek V4 Pro, заметно дешевле (страница модели).kimi-k3.1-proиglm-5.3— китайские модели для кода и агентных задач.
А как же Claude? Добавить модели Claude в этого провайдера можно, но по протоколу OpenAI кэш работает хуже, возможны сбои запросов и лишние расходы. Для Claude удобнее Claude Code — как запустить его в России, описано в статье «Claude Code в России».
Чтобы добавить другую модель, впишите её ID в раздел models конфига. Полный список моделей и их ID — в каталоге моделей.
Шаг 5. Первый запуск
Перейдите в папку проекта и запустите opencode. Выполните /init: OpenCode изучит проект и создаст в корне файл AGENTS.md с его описанием. Затем опишите задачу обычным языком — например, «перепиши эту функцию на async и добавь тесты».
Клавиша Tab переключает режим Plan: в нём OpenCode ничего не меняет, а только предлагает план. Когда план устроит, нажмите Tab ещё раз, чтобы вернуться в режим Build, и попросите внести изменения.
Сколько это стоит
OpenCode бесплатный. Платите только за токены модели — без подписки и без «сгорающих» тарифов. Цена задачи зависит от модели и размера проекта: DeepSeek V4 Pro заметно дешевле GPT-6.1 Sol. Точные цены — на странице цен.
Как оплатить из России
Баланс пополняется в консоли, списание — только за фактически использованные токены; минимального пакета и «сгорающих» тарифов нет.
- Рубли — в окне пополнения выберите способ справа на кнопке «Оплатить» — СБП, Т-Банк, ЮMoney или SberPay — и нажмите на кнопку. Платёж проводит платёжный сервис Payssion. Минимальное пополнение — $5. Если платёж не проходит, под кнопкой есть контакты поддержки — Telegram @teamorouter.
- USDT, USDC или ETH — кнопка «Оплатить криптовалютой» в том же окне; этот способ выручает, если платёж в рублях не прошёл. Откроется страница оплаты: выберите монету и сеть и переведите средства с Binance, OKX или другой биржи либо из любого кошелька. Расширение не нужно, оплатить можно и с телефона; минимум — $5 (USDT в сети BEP20), счёт действует 60 минут. Пошагово — в статье «Какие AI API принимают криптовалюту».
Частые ошибки
Первые три сообщения мы воспроизвели сами в OpenCode 1.15, намеренно ошибаясь в настройке.
Missing auth credential. Provide x-api-key: sk-teamo-* or Authorization: Bearer <token>.
Запрос дошёл до TeamoRouter без ключа: переменная TEAMOROUTER_API_KEY не задана в этом терминале. Проверьте echo $TEAMOROUTER_API_KEY (на Windows — echo $env:TEAMOROUTER_API_KEY). В OpenCode 2 передайте ключ фоновому серверу командой opencode service set env, как в шаге 3.
The provided bearer token could not be validated as either a Teamo API key or an OAuth/session token.
Ключ дошёл, но не подошёл: скопирован не полностью, с лишним пробелом или удалён в консоли. Создайте новый ключ и вставьте его заново.
Not Found
В baseURL нет /v1 на конце. Адрес должен быть ровно https://api.teamorouter.com/v1.
«wallet balance is insufficient» Баланс пуст, а настройки верные. Пополните баланс и повторите запрос.
«Free usage limit reached» или «Free usage exceeded»
Это лимит бесплатных моделей самого OpenCode, а не TeamoRouter. В /models выберите модель с префиксом teamorouter/. Подробнее — в статье «OpenCode Free usage limit reached».
Частые вопросы
OpenCode платный?
Нет. OpenCode бесплатный, с открытым кодом (MIT). Платить нужно только за модели, которые он вызывает.
Нужен ли аккаунт OpenCode?
Нет. Платный доступ к моделям от команды OpenCode необязателен — по документации OpenCode можно пользоваться любым другим провайдером. Своему провайдеру нужны только адрес и API-ключ.
Можно ли в OpenCode пользоваться моделями Claude из России?
Можно добавить их в своего провайдера, но по протоколу OpenAI кэш работает хуже, возможны сбои и лишние расходы. Для Claude лучше Claude Code с тем же ключом.
Чем OpenCode отличается от Claude Code, Codex и Cline?
OpenCode, Claude Code и Codex работают в терминале; Cline — расширение VS Code. OpenCode не привязан к одному поставщику моделей и работает с любыми, которые вы подключите. Одним ключом TeamoRouter можно пользоваться во всех четырёх.
Нужна ли карта иностранного банка?
Нет. Баланс пополняется в рублях через СБП, Т-Банк, ЮMoney или SberPay, а также в USDT.