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.
providers. В документации сказано, что формат V1, описанный выше, по-прежнему поддерживается. Команда настройки FreeLLMAPI записывает формат V1.Выбор моделей для OpenCode
OpenCode это агент. Он читает файлы, редактирует их и запускает команды через вызовы инструментов. Каждый запрос содержит системный промпт, определения инструментов и содержимое файлов. Используйте модели с вызовом инструментов и большим окном контекста.
| Модель | Бесплатно в | Контекст | Бесплатные лимиты (лучшее предложение) | Инструменты | Зрение |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 запр./мин 1 req/min per model | Да | Нет |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 запр./мин 40 RPM | Да | Да |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Да | Да |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Да | Нет |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Да | Да |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 запр./мин 20 запр./день 250,000 токенов/мин ~3M | Да | Да |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Да | Да |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 запр./мин 50 запр./день 50 req/day account-wide (1,000 after a $10 purchase) | Да | Да |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 запр./мин 50 запр./день Shared rate limit | Да | Нет |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 запр./мин 250 запр./день 70,000 токенов/мин ~6M | Да | Да |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 запр./мин 20 запр./день 250,000 токенов/мин ~3M | Да | Да |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 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в.envFreeLLMAPI. Когда модель меняется, следующая модель получает короткую заметку о том, что она продолжает задачу. - Липкие сессии удерживают разговор на одной модели в течение 30 минут. Это сохраняет согласованность агента.
- Начинайте новую сессию для каждой задачи. Меньший контекст расходует меньше токенов на запрос.
Устранение неполадок
| Проблема | Причина | Решение |
|---|---|---|
| "Invalid API key" при действительном ключе | Пустой apiKey в конфиге переопределяет ключ из /connect | Удалите apiKey из options или запустите setup-opencode еще раз |
| OpenCode не использует нового провайдера | Верхний уровень model не задан | Задайте "model": "freellmapi/auto" |
| Model not found | ID модели нет в карте models провайдера | Добавьте ID в карту или запустите setup-opencode еще раз |
Ключ {env:VAR} пуст | OpenCode заменяет неустановленную переменную пустой строкой | Экспортируйте переменную в той же оболочке или сохраните ключ командой /connect |
| Вызовы инструментов завершаются ошибкой | Модель слабо поддерживает вызов инструментов | Выберите модель из таблицы выше |
| "All models rate-limited after N attempts" (все модели достигли лимита после N попыток) | Все ключи достигли своего лимита | Добавьте ключи от большего числа провайдеров или дождитесь окончания пауз |
Часто задаваемые вопросы
Можно ли использовать 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, и настольное приложение.
Похожие руководства
- Aider с бесплатным LLM API
- Codex CLI с бесплатными моделями
- Как бесплатно пользоваться Claude Code
- Лучшие бесплатные API моделей для кода
- Базовые URL бесплатных API, совместимых с OpenAI
Источники
- OpenCode docs: providers (V1 config) (проверено 20 November 2026)
- OpenCode docs: config (проверено 20 November 2026)
- OpenCode docs: migrate from V1 (проверено 20 November 2026)
- FreeLLMAPI CLI generators (проверено 20 November 2026)
- FreeLLMAPI docs: context handoff (проверено 20 November 2026)