← Блог
OpenCodeИнтеграцияАгенты для кода

OpenCode с Claude и GPT: настройка через свой API-ключ

(цены в тексте следуют актуальному прайс-листу)

Коротко

Чтобы использовать OpenCode с APIVAI, выполните /connect, выберите Other, введите ID провайдера apivai и вставьте ключ APIVAI, затем добавьте провайдера apivai в opencode.json с "npm": "@ai-sdk/openai-compatible" и "baseURL": "https://api.apivai.com/v1", перечислите ID моделей, например claude-sonnet-4-6 и gpt-5.5, и выберите apivai/claude-sonnet-4-6 командой /models. Для Claude в родном формате можно вместо этого направить встроенного провайдера anthropic на https://api.apivai.com/v1; в OpenCode этот адрес сохраняет /v1, потому что используемый им Anthropic SDK добавляет только /messages. На 2026-10-10 Claude Sonnet 4.6 через APIVAI стоит $1.15 / $5.74 за миллион входных / выходных токенов против официальных $3.00 / $15.00. Оплата идёт за токены с предоплаченного баланса, без подписки.

Что такое OpenCode и зачем подключать свой API?

OpenCode — AI-агент для программирования с открытым исходным кодом, который работает в терминале. Он читает проект, правит файлы, запускает команды и выполняет задачу шаг за шагом. OpenCode построен на AI SDK и умеет работать со многими провайдерами, включая любой OpenAI-совместимый API, так что вы сами решаете, куда идут запросы к модели и кто их оплачивает.

APIVAI даёт один ключ для моделей Claude и GPT с оплатой за токены (для большинства моделей ниже официальных цен), с баланса, который вы пополняете по мере необходимости. Один ключ работает и в формате OpenAI, и в формате Anthropic, поэтому подходит для обоих вариантов настройки ниже.

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

Свой провайдер (OpenAI-совместимый)Встроенный провайдер anthropic
Пакет npm@ai-sdk/openai-compatibleвстроенный (Anthropic SDK)
baseURLhttps://api.apivai.com/v1https://api.apivai.com/v1
МоделиClaude и GPTТолько Claude
Что вызывает OpenCode/v1/chat/completions/v1/messages
Лучше всего дляОдного провайдера для всех моделейClaude в родном формате Messages

Начните со своего провайдера: он покрывает Claude и GPT, и вы сами задаёте, какие ID моделей появятся в списке. Используйте встроенного провайдера anthropic, если работаете только с Claude и хотите родную интеграцию OpenCode с Claude. Учтите, что после переопределения anthropic все запросы этого провайдера пойдут в APIVAI.

Как настроить OpenCode с APIVAI по шагам?

Шаг 1: Создайте ключ APIVAI

  1. Зарегистрируйтесь на apivai.com по email.
  2. Пополните баланс от $10 картой, криптовалютой, через Alipay или WeChat Pay. Бесплатного пробного периода нет: вы платите только за использование.
  3. Откройте Панель, создайте ключ и скопируйте его. Ключу можно задать собственный лимит бюджета, чтобы агент никогда не потратил больше запланированного.

Шаг 2: Сохраните ключ через /connect

  1. Запустите OpenCode в папке проекта и введите /connect.
  2. Прокрутите список до Other и выберите его.
  3. Введите ID провайдера apivai. Именно этот ID вы укажете в файле конфигурации.
  4. Вставьте ключ APIVAI, когда OpenCode попросит API-ключ.

OpenCode хранит ключ в ~/.local/share/opencode/auth.json. Тот же сценарий доступен вне TUI командой opencode auth login. Если удобнее переменная окружения, пропустите этот шаг и добавьте "apiKey": "{env:APIVAI_API_KEY}" в options провайдера ниже.

Шаг 3: Добавьте провайдера в opencode.json

Поместите это в opencode.json в корне проекта или в ~/.config/opencode/opencode.json, чтобы настройка действовала во всех проектах:

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "apivai": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "APIVAI",
      "options": {
        "baseURL": "https://api.apivai.com/v1"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6",
          "limit": { "context": 200000, "output": 16384 }
        },
        "claude-haiku-4-5": {
          "name": "Claude Haiku 4.5",
          "limit": { "context": 200000, "output": 16384 }
        },
        "gpt-5.5": {
          "name": "GPT-5.5",
          "limit": { "context": 128000, "output": 16384 }
        }
      }
    }
  },
  "model": "apivai/claude-sonnet-4-6",
  "small_model": "apivai/claude-haiku-4-5"
}
КлючЗначение
ID в providerapivai (тот же ID, что вы ввели в /connect)
npm@ai-sdk/openai-compatible
options.baseURLhttps://api.apivai.com/v1
Ключи в modelsТочные ID моделей, например claude-sonnet-4-6
limit.output8192 или больше (не меньше 4096)
modelapivai/claude-sonnet-4-6

baseURL должен заканчиваться на /v1 ровно один раз: пакет сам добавляет /chat/completions. Ключи внутри models — это ID, которые отправляются в APIVAI, а name — лишь подпись в списке. limit сообщает OpenCode, сколько контекста осталось и насколько длинным может быть ответ. small_model используется для лёгких задач, например для генерации заголовков сессий, поэтому туда подходит дешёвая модель.

Чтобы узнать, какие ID моделей доступны вашему ключу, выполните:

curl https://api.apivai.com/v1/models \
  -H "Authorization: Bearer YOUR_APIVAI_KEY"

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

Шаг 4 (по желанию): Встроенный провайдер Anthropic для Claude

  1. Выполните /connect, выберите Anthropic, затем Manually enter API Key и вставьте ключ APIVAI.
  2. Добавьте базовый адрес в opencode.json:
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "https://api.apivai.com/v1"
      }
    }
  }
}

Здесь /v1 остаётся. Это противоположно таким инструментам, как Claude Code: Anthropic SDK в OpenCode считает baseURL префиксом, который уже включает /v1 (по умолчанию это https://api.anthropic.com/v1), и добавляет только /messages. Адрес https://api.apivai.com без /v1 приведёт к вызову /messages и ошибке 404. Выбирайте модели Claude из списка Anthropic в /models; если нужного ID там нет, добавьте его в provider.anthropic.models. Подробнее об этом формате — на странице прокси для Claude API.

Какую модель выбрать в OpenCode?

Агент для программирования отправляет много запросов на одну задачу, поэтому цена токена важна. Цены за 1M входных / выходных токенов на 2026-10-10:

ID моделиЦена (вход / выход)Для чего
claude-sonnet-4-6$1.15 / $5.74Выбор по умолчанию для повседневного кода
claude-sonnet-5-5$0.77 / $3.82Повседневный код, более новый Sonnet
claude-opus-5-5$1.54 / $7.65Сложные баги, крупный рефакторинг
claude-haiku-4-5$0.38 / $1.92small_model, быстрые правки
gpt-5.5$0.77 / $4.56Альтернатива на GPT, второе мнение
gpt-6-luna$0.0144 / $0.0768Очень дешёвые простые задачи

Практичная схема: Claude Sonnet 4.6 или Claude Sonnet 5.5 в model, Claude Haiku 4.5 в small_model и Claude Opus 5.5, когда задача раз за разом не получается. Модели GPT работают только через свой OpenAI-совместимый провайдер.

Сколько стоит OpenCode с APIVAI?

Каждый шаг задачи заново отправляет сессию и прочитанные агентом файлы, поэтому входные токены быстро накапливаются. Два реалистичных примера с Claude Sonnet 4.6:

  • Одна средняя задача, например новая функция, затрагивающая несколько файлов: около 25 запросов по 30 000 входных и 2 000 выходных токенов. Стоимость: $1.15 с APIVAI, $3.00 по официальным ценам.
  • Рабочий месяц по три такие задачи в день в течение 22 дней (1 650 запросов): $75.87 с APIVAI, $198 по официальным ценам.

Тот же месяц на Claude Haiku 4.5 обойдётся в $25.15. В расчётах не учтено кэширование промптов, а токены размышлений включены в число выходных, поскольку оплачиваются как выходные. В Панели видны все запросы с токенами и стоимостью, так что уже через день вы сможете заменить эти допущения своими цифрами. Более широкое сравнение — в статье цены Claude API в 2026 году.

Как исправить частые ошибки OpenCode?

  • 401 Unauthorized: выполните opencode auth list и проверьте, что для apivai есть учётные данные. ID в /connect должен в точности совпадать с ID провайдера в opencode.json. Также убедитесь, что ключ не удалён и не исчерпал бюджет.
  • 404 Not Found: проверьте options.baseURL. В обоих вариантах это https://api.apivai.com/v1 — без /chat/completions или /messages в конце и без двойного /v1.
  • Модель не найдена: ключ внутри models должен быть точным ID, например claude-sonnet-4-6. Сверьте его с GET /v1/models.
  • Провайдера или моделей нет в /models: значение npm должно быть @ai-sdk/openai-compatible, а JSON — корректным. После правки файла перезапустите OpenCode.
  • Пустые или оборванные ответы: размышления включены по умолчанию и расходуют выходные токены. Увеличьте limit.output до 8192 или больше (минимум 4096).
  • 429 Too Many Requests: по умолчанию 60 запросов в минуту на ключ. Длинные задачи агента могут упереться в лимит; подождите немного или попросите поддержку его увеличить.

Общие правила форматов — на странице OpenAI-совместимый API и в документации.

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

Можно ли использовать Claude и GPT в OpenCode с одним ключом?

Да. Перечислите оба ID моделей в провайдере apivai и переключайтесь между ними через /models.

Какой baseURL указывать в OpenCode?

https://api.apivai.com/v1 в обоих вариантах. OpenAI-совместимый пакет добавляет к нему /chat/completions, а Anthropic SDK — /messages.

Где должен лежать opencode.json?

В корне проекта — для одного проекта, или в ~/.config/opencode/opencode.json — для всех. Конфигурация проекта имеет приоритет над глобальной.

Хранит ли APIVAI мой код?

Нет. Содержимое запросов и ответов не записывается. Для биллинга сохраняются только данные об использовании: модель, число токенов и стоимость.

Можно ли использовать тот же ключ в других инструментах?

Да. Тот же ключ работает в Aider, Claude Code и редакторах вроде Zed. Отдельный ключ для каждого инструмента упрощает чтение Панели.

Создайте аккаунт, пополните баланс от $10 и вставьте ключ в OpenCode.

Готовы начать?

Получите API-ключ за 30 секунд. Оплата по факту использования Claude и GPT.

Начать