Главная / Руководства / OpenCode с бесплатным LLM API

OpenCode с бесплатным LLM API

OpenCode это агент для написания кода с открытым исходным кодом для терминала и настольного приложения. Он принимает любого провайдера, совместимого с OpenAI. Это руководство подключает OpenCode к бесплатным моделям через FreeLLMAPI. Одна команда записывает конфиг и сохраняет ключ.

Код, названия моделей и метки живого каталога показаны на английском языке.

Шаг 1: установите FreeLLMAPI

FreeLLMAPI это шлюз с открытым исходным кодом. Он работает на вашем компьютере в Docker и объединяет бесплатные тарифы 45 провайдеров за одним ключом.

Установка на macOS или Linux

curl -fsSL https://freellmapi.co/install.sh | bash

Откройте http://localhost:3001. Добавьте минимум два ключа бесплатных провайдеров на странице Keys. Google AI Studio и Groq выдают бесплатный ключ за несколько минут. Скопируйте единый ключ с этой же страницы.

Шаг 2: подключите OpenCode одной командой

Одна команда

npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key> --dry-run
npx freellmapi setup-opencode --url http://localhost:3001 --api-key <unified-key>
opencode

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

  • Она добавляет провайдера freellmapi в ~/.config/opencode/opencode.json. Провайдер перечисляет модели из вашего актуального каталога с их лимитами контекста.
  • Она устанавливает freellmapi/auto как модель по умолчанию.
  • Она сохраняет ключ в файл учетных данных OpenCode, ~/.local/share/opencode/auth.json. Переменная окружения не нужна ни в CLI, ни в настольном приложении.

Перед записью команда создает резервную копию. Она объединяет нового провайдера с существующими, поэтому ваши другие провайдеры остаются. Если задано XDG_CONFIG_HOME или XDG_DATA_HOME, команда использует эти папки.

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

Проверка готовности моделей

curl "http://localhost:3001/v1/models?execution_status=ready" \
  -H "Authorization: Bearer <unified-key>"

Модель со статусом exhausted имеет ключи, но все они сейчас достигли лимита. Этот статус снимается, когда заканчиваются паузы. Запустите npx freellmapi doctor, чтобы убедиться, что запросы клиента доходят до шлюза. Журнал запросов на панели показывает каждый вызов из OpenCode. Заголовок ответа X-Routed-Via называет провайдера и модель, которые ответили на каждый запрос. Если запрос перешел на другой маршрут, заголовок X-Fallback-Trail называет каждый неудачный переход и причину.

Ручная настройка: блок провайдера в opencode.json

Чтобы настроить вручную, добавьте этот блок в ~/.config/opencode/opencode.json или в opencode.json вашего проекта. OpenCode использует @ai-sdk/openai-compatible для эндпоинтов /v1/chat/completions.

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "freellmapi/auto",
  "provider": {
    "freellmapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "FreeLLMAPI",
      "options": {
        "baseURL": "http://localhost:3001/v1"
      },
      "models": {
        "auto": {
          "name": "Auto",
          "limit": { "context": 128000, "output": 8192 }
        }
      }
    }
  }
}

Затем добавьте ключ. Запустите OpenCode, выполните /connect, выберите провайдера freellmapi и вставьте ваш единый ключ. ID провайдера в /connect должен совпадать с ID в конфиге. Выполните /models, чтобы выбрать модель.

  • limit.context это максимальное число входных токенов модели. limit.output это максимальное число токенов, которое она может сгенерировать.
  • Верхний уровень model использует формат provider/model. Без него OpenCode оставляет модель, которую использовал раньше.
  • Каждый ID модели, который вы хотите использовать, должен быть в карте models. Добавьте другие ID из GET /v1/models.
Примечание о версиях конфига: документация OpenCode теперь описывает формат конфига V2 с ключом providers. В документации сказано, что формат V1, описанный выше, по-прежнему поддерживается. Команда настройки FreeLLMAPI записывает формат V1.

Выбор моделей для OpenCode

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

Бесплатные модели для OpenCode: вызов инструментов и контекст 128K+
МодельБесплатно вКонтекстБесплатные лимиты (лучшее предложение)ИнструментыЗрение
GLM 5.3UnoRouter1M1 запр./мин
1 req/min per model
ДаНет
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 запр./мин
40 RPM
ДаДа
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaДаДа
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceДаНет
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditДаДа
Gemini 3.7 FlashGoogle AI Studio1M10 запр./мин
20 запр./день
250,000 токенов/мин
~3M
ДаДа
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditДаДа
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 запр./мин
50 запр./день
50 req/day account-wide (1,000 after a $10 purchase)
ДаДа
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 запр./мин
50 запр./день
Shared rate limit
ДаНет
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 запр./мин
250 запр./день
70,000 токенов/мин
~6M
ДаДа
Gemini 3.6 FlashGoogle AI Studio1M10 запр./мин
20 запр./день
250,000 токенов/мин
~3M
ДаДа
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayДаДа

Показано 12 из 109 подходящих бесплатных моделей. Смотреть все модели.

Актуальные данные из каталога FreeLLMAPI (версия 2026.11.19, проверено 2026-11-19). Бесплатные лимиты часто меняются. Каталог проверяется каждый день.

Используйте freellmapi/auto, чтобы маршрутизатор выбирал модель для каждого запроса. Добавьте auto:smart или auto:fast в карту models, чтобы направлять запросы по уровню интеллекта или по скорости. Также можно добавить именованный профиль, например auto:coding, после того как вы создадите его на панели.

Лимиты запросов и длинные сессии

Одна задача агента может отправить десятки запросов. Один бесплатный тариф быстро останавливает длинную задачу. FreeLLMAPI считает запросы и токены каждого ключа. Когда провайдер возвращает ошибку 429, маршрутизатор отправляет запрос следующей модели в цепочке, и сессия продолжается.

  • Добавьте ключи от четырех или более провайдеров. Больше провайдеров дают больше запросов в день.
  • Включите передачу контекста командой FREELLMAPI_CONTEXT_HANDOFF=on_model_switch в .env FreeLLMAPI. Когда модель меняется, следующая модель получает короткую заметку о том, что она продолжает задачу.
  • Липкие сессии удерживают разговор на одной модели в течение 30 минут. Это сохраняет согласованность агента.
  • Начинайте новую сессию для каждой задачи. Меньший контекст расходует меньше токенов на запрос.

Устранение неполадок

ПроблемаПричинаРешение
"Invalid API key" при действительном ключеПустой apiKey в конфиге переопределяет ключ из /connectУдалите apiKey из options или запустите setup-opencode еще раз
OpenCode не использует нового провайдераВерхний уровень model не заданЗадайте "model": "freellmapi/auto"
Model not foundID модели нет в карте models провайдераДобавьте ID в карту или запустите setup-opencode еще раз
Ключ {env:VAR} пустOpenCode заменяет неустановленную переменную пустой строкойЭкспортируйте переменную в той же оболочке или сохраните ключ командой /connect
Вызовы инструментов завершаются ошибкойМодель слабо поддерживает вызов инструментовВыберите модель из таблицы выше
"All models rate-limited after N attempts" (все модели достигли лимита после N попыток)Все ключи достигли своего лимитаДобавьте ключи от большего числа провайдеров или дождитесь окончания пауз
Используйте каждую из этих моделей через один ключ. FreeLLMAPI это маршрутизатор с открытым исходным кодом, который работает на вашем сервере. Он объединяет все эти бесплатные тарифы за одной конечной точкой, совместимой с OpenAI, и переключается на другой провайдер, когда достигнут лимит запросов. Открыть каталог или перейти.

Часто задаваемые вопросы

Можно ли использовать OpenCode бесплатно?

Да. OpenCode имеет открытый исходный код. Подключите его к FreeLLMAPI как провайдера, совместимого с OpenAI. Шлюз отправляет каждый запрос на бесплатные тарифы провайдеров, поэтому стоимость инференса составляет $0.

Как добавить в OpenCode собственного провайдера, совместимого с OpenAI?

Добавьте в opencode.json провайдера с npm, равным @ai-sdk/openai-compatible, options.baseURL и картой models. Затем выполните /connect, чтобы сохранить ключ, и /models, чтобы выбрать модель.

Какая бесплатная модель лучше всего подходит для OpenCode?

Используйте модель с вызовом инструментов и контекстом не менее 128K. В таблице на этой странице показаны самые сильные бесплатные модели, которые сегодня соответствуют обоим условиям. Используйте freellmapi/auto, чтобы маршрутизатор выбрал одну из них.

Где OpenCode хранит API-ключи?

Ключи, добавленные командой /connect, попадают в ~/.local/share/opencode/auth.json. Команда настройки FreeLLMAPI записывает ключ туда, поэтому его находят и CLI, и настольное приложение.

Похожие руководства

Источники

Все руководства · Смотреть все бесплатные модели