Home / Gidsen / OpenCode gebruiken met een gratis LLM API

OpenCode gebruiken met een gratis LLM API

OpenCode is een open-source coding-agent voor de terminal en het bureaublad. Het accepteert elke OpenAI-compatibele provider. Deze gids koppelt OpenCode aan gratis modellen via FreeLLMAPI. Eén commando schrijft de configuratie en slaat de sleutel op.

Code, modelnamen en labels uit de live catalogus worden in het Engels getoond.

Stap 1: FreeLLMAPI installeren

FreeLLMAPI is een open-source gateway. Het draait op je computer in Docker en bundelt de gratis tiers van 45 providers achter één sleutel.

Installeren op macOS of Linux

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

Open http://localhost:3001. Voeg op de pagina Keys ten minste twee gratis providersleutels toe. Google AI Studio en Groq geven elk binnen enkele minuten een gratis sleutel. Kopieer je uniforme sleutel van dezelfde pagina.

Stap 2: OpenCode verbinden met één commando

Eén commando

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

Het commando doet drie dingen:

  • Het voegt een provider freellmapi toe aan ~/.config/opencode/opencode.json. De provider toont de modellen uit je actuele catalogus met hun contextlimieten.
  • Het zet freellmapi/auto als standaardmodel.
  • Het slaat de sleutel op in het credentialbestand van OpenCode, ~/.local/share/opencode/auth.json. Je hebt geen omgevingsvariabele nodig, in de CLI noch in de desktopapp.

Het commando maakt een back-up voordat het schrijft. Het voegt de nieuwe provider samen met de bestaande, dus je andere providers blijven bestaan. Als XDG_CONFIG_HOME of XDG_DATA_HOME is ingesteld, gebruikt het commando die mappen.

Controleer voordat je een lange taak start of de gateway nu een aanvraag kan beantwoorden. Deze aanroep toont alleen de modellen die op dit moment een bruikbare sleutel hebben:

Controleer welke modellen klaar zijn

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

Een model met de status exhausted heeft sleutels, maar al die sleutels hebben nu hun limiet bereikt. Deze status verdwijnt wanneer de cooldowns eindigen. Voer npx freellmapi doctor uit om zeker te weten dat de aanvragen van een client de gateway bereiken. Het aanvraaglogboek van het dashboard toont elke aanroep vanuit OpenCode. De responseheader X-Routed-Via noemt de provider en het model dat elke aanvraag heeft beantwoord. Is een aanvraag doorgeschakeld, dan noemt de header X-Fallback-Trail elke mislukte stap en de reden.

Handmatige installatie: het providerblok in opencode.json

Om het handmatig in te stellen, voeg je dit blok toe aan ~/.config/opencode/opencode.json, of aan opencode.json in je project. OpenCode gebruikt @ai-sdk/openai-compatible voor /v1/chat/completions-endpoints.

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 }
        }
      }
    }
  }
}

Voeg daarna de sleutel toe. Start OpenCode, voer /connect uit, selecteer de provider freellmapi en plak je uniforme sleutel. Het provider-id in /connect moet overeenkomen met het id in de configuratie. Voer /models uit om een model te selecteren.

  • limit.context is het maximale aantal invoertokens van het model. limit.output is het maximale aantal tokens dat het kan genereren.
  • Het model op het hoogste niveau gebruikt de notatie provider/model. Zonder die instelling houdt OpenCode het model aan dat het eerder gebruikte.
  • Elk model-id dat je wilt gebruiken, moet in de map models staan. Voeg meer ids toe uit GET /v1/models.
Let op bij configuratieversies: de documentatie van OpenCode beschrijft nu een V2-configuratieformaat met een sleutel providers. De documentatie zegt dat het V1-formaat hierboven nog wordt ondersteund. Het installatiecommando van FreeLLMAPI schrijft het V1-formaat.

Modellen kiezen voor OpenCode

OpenCode is een agent. Het leest bestanden, bewerkt ze en voert opdrachten uit via tool calls. Elke aanvraag bevat een systeemprompt, tooldefinities en bestandsinhoud. Gebruik modellen met tool calling en een groot contextvenster.

Gratis modellen voor OpenCode: tool calling en 128K+ context
ModelGratis opContextGratis limieten (beste aanbod)ToolsVision
GLM 5.3UnoRouter1M1 aanvragen/min
1 req/min per model
JaNee
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 aanvragen/min
40 RPM
JaJa
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaJaJa
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceJaNee
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditJaJa
Gemini 3.7 FlashGoogle AI Studio1M10 aanvragen/min
20 aanvragen/dag
250,000 tokens/min
~3M
JaJa
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditJaJa
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 aanvragen/min
50 aanvragen/dag
50 req/day account-wide (1,000 after a $10 purchase)
JaJa
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 aanvragen/min
50 aanvragen/dag
Shared rate limit
JaNee
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 aanvragen/min
250 aanvragen/dag
70,000 tokens/min
~6M
JaJa
Gemini 3.6 FlashGoogle AI Studio1M10 aanvragen/min
20 aanvragen/dag
250,000 tokens/min
~3M
JaJa
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayJaJa

Toont 12 van 109 overeenkomende gratis modellen. Bekijk alle modellen.

Actuele gegevens uit de FreeLLMAPI-catalogus (versie 2026.11.19, gecontroleerd 2026-11-19). Gratis limieten veranderen vaak. De catalogus wordt elke dag gecontroleerd.

Gebruik freellmapi/auto om de router per aanvraag een model te laten kiezen. Voeg auto:smart of auto:fast toe aan de map models om aanvragen te sturen op intelligentie of snelheid. Je kunt ook een eigen profiel toevoegen, bijvoorbeeld auto:coding, nadat je het op het dashboard hebt gemaakt.

Snelheidslimieten en lange sessies

Eén agenttaak kan tientallen aanvragen sturen. Eén gratis tier stopt een lange taak snel. FreeLLMAPI telt de aanvragen en tokens van elke sleutel. Wanneer een provider een 429-fout stuurt, stuurt de router de aanvraag naar het volgende model in de keten, en gaat de sessie door.

  • Voeg sleutels van vier of meer providers toe. Meer providers geven meer aanvragen per dag.
  • Zet contextoverdracht aan met FREELLMAPI_CONTEXT_HANDOFF=on_model_switch in het .env-bestand van FreeLLMAPI. Wanneer het model verandert, krijgt het volgende model een korte notitie dat het een taak voortzet.
  • Sticky sessions houden een gesprek 30 minuten op één model. Zo blijft de agent consistent.
  • Start voor elke taak een nieuwe sessie. Een kleinere context gebruikt minder tokens per aanvraag.

Problemen oplossen

ProbleemOorzaakOplossing
"Invalid API key" met een geldige sleutelEen lege apiKey in de configuratie overschrijft de sleutel van /connectVerwijder apiKey uit options, of voer setup-opencode opnieuw uit
OpenCode gebruikt de nieuwe provider nietHet model op het hoogste niveau is niet ingesteldZet "model": "freellmapi/auto"
Model not foundHet model-id staat niet in de map models van de providerVoeg het id toe aan de map, of voer setup-opencode opnieuw uit
{env:VAR}-sleutel is leegOpenCode vervangt een niet-ingestelde variabele door een lege tekstExporteer de variabele in dezelfde shell, of sla de sleutel op met /connect
Tool calls mislukkenHet model heeft zwakke tool callingKies een model uit de tabel hierboven
"Alle modellen rate-limited na N pogingen"Alle sleutels hebben hun limiet bereiktVoeg sleutels van meer providers toe, of wacht op de cooldowns
Gebruik elk van deze met één sleutel. FreeLLMAPI is een open-source router die u zelf host. Die zet al deze gratis tarieven achter één eindpunt dat compatibel is met OpenAI. Bij een snelheidslimiet schakelt de router automatisch over. Bekijk de catalogus of live gaan.

Veelgestelde vragen

Kan ik OpenCode gratis gebruiken?

Ja. OpenCode is open source. Koppel het aan FreeLLMAPI als OpenAI-compatibele provider. De gateway stuurt elke aanvraag naar gratis providertiers, dus de inferentie kost $0.

Hoe voeg ik een eigen OpenAI-compatibele provider toe aan OpenCode?

Voeg een provider toe aan opencode.json met npm ingesteld op @ai-sdk/openai-compatible, options.baseURL en een map models. Voer daarna /connect uit om de sleutel op te slaan en /models om een model te selecteren.

Welk gratis model is het beste voor OpenCode?

Gebruik een model met tool calling en ten minste 128K context. De tabel op deze pagina toont de sterkste gratis modellen die vandaag aan beide regels voldoen. Gebruik freellmapi/auto om de router er een te laten kiezen.

Waar slaat OpenCode API-sleutels op?

Sleutels die je toevoegt met /connect gaan naar ~/.local/share/opencode/auth.json. Het installatiecommando van FreeLLMAPI schrijft de sleutel daarheen, zodat de CLI en de desktopapp hem allebei vinden.

Gerelateerde gidsen

Bronnen

Alle gidsen · Bekijk alle gratis modellen