OpenCode mit einer kostenlosen LLM API nutzen
OpenCode ist ein Open-Source-Coding-Agent für Terminal und Desktop. Er akzeptiert jeden OpenAI-kompatiblen Anbieter. Dieser Leitfaden verbindet OpenCode über FreeLLMAPI mit kostenlosen Modellen. Ein Befehl schreibt die Konfiguration und speichert den Schlüssel.
Code, Modellnamen und Bezeichnungen aus dem Live-Katalog werden auf Englisch angezeigt.
Schritt 1: FreeLLMAPI installieren
FreeLLMAPI ist ein Open-Source-Gateway. Es läuft in Docker auf Ihrem Computer und bündelt die kostenlosen Tarife von 45 Anbietern hinter einem Schlüssel.
Installation unter macOS oder Linux
curl -fsSL https://freellmapi.co/install.sh | bashÖffnen Sie http://localhost:3001. Fügen Sie auf der Seite Keys mindestens zwei kostenlose Anbieterschlüssel hinzu. Google AI Studio und Groq geben jeweils in wenigen Minuten einen kostenlosen Schlüssel aus. Kopieren Sie Ihren einheitlichen Schlüssel von derselben Seite.
Schritt 2: OpenCode mit einem Befehl verbinden
Ein Befehl
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>
opencodeDer Befehl macht drei Dinge:
- Er fügt einen Anbieter
freellmapizu~/.config/opencode/opencode.jsonhinzu. Der Anbieter listet die Modelle aus Ihrem aktuellen Katalog mit ihren Kontextlimits auf. - Er setzt
freellmapi/autoals Standardmodell. - Er speichert den Schlüssel in der Anmeldedatei von OpenCode,
~/.local/share/opencode/auth.json. Sie brauchen keine Umgebungsvariable, weder in der CLI noch in der Desktop-App.
Der Befehl legt vor dem Schreiben eine Sicherung an. Er führt den neuen Anbieter mit der bestehenden Konfiguration zusammen, Ihre anderen Anbieter bleiben also erhalten. Wenn XDG_CONFIG_HOME oder XDG_DATA_HOME gesetzt ist, verwendet der Befehl diese Ordner.
Bevor Sie eine lange Aufgabe starten, prüfen Sie, ob das Gateway jetzt eine Anfrage beantworten kann. Dieser Aufruf listet nur die Modelle auf, die in diesem Moment einen nutzbaren Schlüssel haben:
Prüfen, welche Modelle bereit sind
curl "http://localhost:3001/v1/models?execution_status=ready" \
-H "Authorization: Bearer <unified-key>"Ein Modell mit dem Status exhausted hat Schlüssel, aber alle sind gerade am Limit. Dieser Status endet, wenn die Abklingzeiten vorbei sind. Führen Sie npx freellmapi doctor aus, um sicherzustellen, dass die Anfragen eines Clients das Gateway erreichen. Das Anfrageprotokoll im Dashboard zeigt jeden Aufruf von OpenCode. Der Antwort-Header X-Routed-Via nennt den Anbieter und das Modell, die jede Anfrage beantwortet haben. Wurde eine Anfrage auf einen anderen Anbieter umgeleitet, nennt der Header X-Fallback-Trail jeden fehlgeschlagenen Schritt und den Grund.
Manuelle Einrichtung: der Anbieterblock in opencode.json
Um es manuell einzurichten, fügen Sie diesen Block in ~/.config/opencode/opencode.json ein oder in opencode.json in Ihrem Projekt. OpenCode verwendet @ai-sdk/openai-compatible für Endpunkte /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 }
}
}
}
}
}Fügen Sie dann den Schlüssel hinzu. Starten Sie OpenCode, führen Sie /connect aus, wählen Sie den Anbieter freellmapi und fügen Sie Ihren einheitlichen Schlüssel ein. Die Anbieter-ID in /connect muss mit der ID in der Konfiguration übereinstimmen. Führen Sie /models aus, um ein Modell zu wählen.
limit.contextist die maximale Anzahl Eingabe-Tokens des Modells.limit.outputist die maximale Anzahl Tokens, die es erzeugen kann.- Das oberste Feld
modelverwendet das Formatprovider/model. Ohne dieses Feld behält OpenCode das Modell, das es zuvor verwendet hat. - Jede Modell-ID, die Sie verwenden möchten, muss in der Zuordnung
modelsstehen. Fügen Sie weitere IDs ausGET /v1/modelshinzu.
providers. Laut Dokumentation bleibt das oben gezeigte Format V1 unterstützt. Der Setup-Befehl von FreeLLMAPI schreibt das Format V1.Modelle für OpenCode auswählen
OpenCode ist ein Agent. Er liest Dateien, bearbeitet sie und führt Befehle über Tool-Aufrufe aus. Jede Anfrage enthält einen System-Prompt, Tool-Definitionen und Dateiinhalte. Verwenden Sie Modelle mit Tool-Calling und einem großen Kontextfenster.
| Modell | Kostenlos bei | Kontext | Kostenlose Limits (bestes Angebot) | Tools | Bildverarbeitung |
|---|---|---|---|---|---|
| GLM 5.3 | UnoRouter | 1M | 1 Anfragen/Min. 1 req/min per model | Ja | Nein |
| GLM 5.3 Flash | NVIDIA NIM, UnoRouter | 1M | 40 Anfragen/Min. 40 RPM | Ja | Ja |
| Gemini 3.8 Flash | Google AI Studio | 1M | Recurring provider quota | Ja | Ja |
| Qwen3.8 Flash Next | AMD Radeon Cloud | 262K | Recurring daily account allowance | Ja | Nein |
| Qwen3.8 Flash | ElectronHub | 1M | $0.25/week shared recurring credit | Ja | Ja |
| Gemini 3.7 Flash | Google AI Studio | 1M | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| GPT-5.6 Luna | ElectronHub | 1M | $0.25/week shared recurring credit | Ja | Ja |
| Dots3 Note Preview | Kilo Gateway, OpenRouter | 512K | 20 Anfragen/Min. 50 Anfragen/Tag 50 req/day account-wide (1,000 after a $10 purchase) | Ja | Ja |
| DeepSeek V4 Flash | AMD Radeon Cloud, BazaarLink, ElectronHub | 1M | 10 Anfragen/Min. 50 Anfragen/Tag Shared rate limit | Ja | Nein |
| Qwen3.8 27B | ElectronHub, Groq, OVH AI Endpoints | 262K | 30 Anfragen/Min. 250 Anfragen/Tag 70,000 Token/Min. ~6M | Ja | Ja |
| Gemini 3.6 Flash | Google AI Studio | 1M | 10 Anfragen/Min. 20 Anfragen/Tag 250,000 Token/Min. ~3M | Ja | Ja |
| Qwen 3.8 27B | Cloudflare Workers AI | 262K | Shared 10k neurons/day | Ja | Ja |
Es werden 12 von 109 passenden kostenlosen Modellen angezeigt. Alle Modelle ansehen.
Live-Daten aus dem FreeLLMAPI-Katalog (Version 2026.11.19, geprüft 2026-11-19). Kostenlose Limits ändern sich oft. Der Katalog wird jeden Tag geprüft.
Verwenden Sie freellmapi/auto, damit der Router für jede Anfrage ein Modell wählt. Fügen Sie auto:smart oder auto:fast zur Zuordnung models hinzu, um Anfragen nach Intelligenz oder Geschwindigkeit zu steuern. Sie können auch ein benanntes Profil hinzufügen, zum Beispiel auto:coding, nachdem Sie es im Dashboard erstellt haben.
Ratenlimits und lange Sitzungen
Eine einzelne Agentenaufgabe kann Dutzende Anfragen senden. Ein einzelner kostenloser Tarif stoppt eine lange Aufgabe schnell. FreeLLMAPI zählt die Anfragen und Tokens jedes Schlüssels. Sendet ein Anbieter einen Fehler 429, leitet der Router die Anfrage an das nächste Modell der Kette weiter, und die Sitzung läuft weiter.
- Fügen Sie Schlüssel von vier oder mehr Anbietern hinzu. Mehr Anbieter ergeben mehr Anfragen pro Tag.
- Aktivieren Sie die Kontextübergabe mit
FREELLMAPI_CONTEXT_HANDOFF=on_model_switchin der Datei.envvon FreeLLMAPI. Wenn das Modell wechselt, erhält das nächste Modell einen kurzen Hinweis, dass es eine Aufgabe fortsetzt. - Feste Sitzungen halten eine Unterhaltung 30 Minuten lang auf einem Modell. So bleibt der Agent konsistent.
- Starten Sie für jede Aufgabe eine neue Sitzung. Ein kleinerer Kontext verbraucht pro Anfrage weniger Tokens.
Fehlerbehebung
| Problem | Ursache | Lösung |
|---|---|---|
| "Invalid API key" trotz gültigem Schlüssel | Ein leerer apiKey in der Konfiguration überschreibt den Schlüssel aus /connect | Entfernen Sie apiKey aus options oder führen Sie setup-opencode erneut aus |
| OpenCode verwendet den neuen Anbieter nicht | Das oberste Feld model ist nicht gesetzt | Setzen Sie "model": "freellmapi/auto" |
| Modell nicht gefunden | Die Modell-ID steht nicht in der Zuordnung models des Anbieters | Fügen Sie die ID zur Zuordnung hinzu oder führen Sie setup-opencode erneut aus |
Schlüssel {env:VAR} ist leer | OpenCode ersetzt eine nicht gesetzte Variable durch eine leere Zeichenkette | Exportieren Sie die Variable in derselben Shell oder speichern Sie den Schlüssel mit /connect |
| Tool-Aufrufe schlagen fehl | Das Modell unterstützt Tool-Calling schwach | Wählen Sie ein Modell aus der Tabelle oben |
| Fehlermeldung: "All models rate-limited after N attempts" | Alle Schlüssel haben ihr Limit erreicht | Fügen Sie Schlüssel von weiteren Anbietern hinzu oder warten Sie auf die Abklingzeiten |
Häufig gestellte Fragen
Kann ich OpenCode kostenlos nutzen?
Ja. OpenCode ist Open Source. Verbinden Sie es mit FreeLLMAPI als OpenAI-kompatiblen Anbieter. Das Gateway sendet jede Anfrage an kostenlose Anbieter-Tarife. Die Inferenz kostet daher 0 US-Dollar.
Wie füge ich OpenCode einen eigenen OpenAI-kompatiblen Anbieter hinzu?
Fügen Sie einen Anbieter mit npm auf @ai-sdk/openai-compatible, options.baseURL und einer Zuordnung models zu opencode.json hinzu. Führen Sie danach /connect aus, um den Schlüssel zu speichern, und /models, um ein Modell zu wählen.
Welches kostenlose Modell eignet sich am besten für OpenCode?
Verwenden Sie ein Modell mit Tool-Calling und mindestens 128K Kontext. Die Tabelle auf dieser Seite zeigt die stärksten kostenlosen Modelle, die heute beide Regeln erfüllen. Mit freellmapi/auto lassen Sie den Router eines auswählen.
Wo speichert OpenCode API-Schlüssel?
Schlüssel, die mit /connect hinzugefügt werden, landen in ~/.local/share/opencode/auth.json. Der Setup-Befehl von FreeLLMAPI schreibt den Schlüssel dorthin, damit ihn CLI und Desktop-App beide finden.
Verwandte Anleitungen
- Aider mit einer kostenlosen LLM-API nutzen
- Codex CLI mit kostenlosen Modellen nutzen
- So nutzen Sie Claude Code kostenlos
- Beste kostenlose Coding-Modell-APIs
- Kostenlose OpenAI-kompatible API-Base-URLs
Quellen
- OpenCode docs: providers (V1 config) (geprüft 20 November 2026)
- OpenCode docs: config (geprüft 20 November 2026)
- OpenCode docs: migrate from V1 (geprüft 20 November 2026)
- FreeLLMAPI CLI generators (geprüft 20 November 2026)
- FreeLLMAPI docs: context handoff (geprüft 20 November 2026)