Використання 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 для endpoint /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 і вставте ваш єдиний ключ. Ідентифікатор провайдера в /connect повинен збігатися з ідентифікатором у конфігурації. Виконайте /models, щоб вибрати модель.
limit.contextце максимальна кількість вхідних токенів моделі.limit.outputце максимальна кількість токенів, яку вона може згенерувати.- Верхньорівневий
modelвикористовує форматprovider/model. Без нього OpenCode залишає модель, яку використовував раніше. - Кожен ідентифікатор моделі, який ви хочете використовувати, повинен бути в карті
models. Додайте інші ідентифікатори з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" |
| Модель не знайдено | Ідентифікатора моделі немає в карті models провайдера | Додайте ідентифікатор до карти або запустіть setup-opencode ще раз |
Ключ {env:VAR} порожній | OpenCode замінює незаданий змінну порожнім рядком | Експортуйте змінну в тій самій оболонці або збережіть ключ за допомогою /connect |
| Виклики інструментів не працюють | Модель слабко підтримує виклик інструментів | Виберіть модель з таблиці вище |
| «All models rate-limited after N attempts» | Усі ключі досягли свого ліміту | Додайте ключі від більшої кількості провайдерів або зачекайте завершення пауз |
Часті запитання
Чи можна використовувати OpenCode безкоштовно?
Так. OpenCode має відкритий код. Підключіть його до FreeLLMAPI як провайдера, сумісного з OpenAI. Шлюз надсилає кожен запит до безкоштовних тарифів провайдерів, тому вартість інференсу становить $0.
Як додати власного провайдера, сумісного з OpenAI, до OpenCode?
Додайте до 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)