Startseite / Anleitungen / OpenCode mit einer kostenlosen LLM API nutzen

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

Der Befehl macht drei Dinge:

  • Er fügt einen Anbieter freellmapi zu ~/.config/opencode/opencode.json hinzu. Der Anbieter listet die Modelle aus Ihrem aktuellen Katalog mit ihren Kontextlimits auf.
  • Er setzt freellmapi/auto als 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.context ist die maximale Anzahl Eingabe-Tokens des Modells. limit.output ist die maximale Anzahl Tokens, die es erzeugen kann.
  • Das oberste Feld model verwendet das Format provider/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 models stehen. Fügen Sie weitere IDs aus GET /v1/models hinzu.
Hinweis zu Konfigurationsversionen: Die Dokumentation von OpenCode beschreibt jetzt ein Konfigurationsformat V2 mit dem Schlüssel 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.

Kostenlose Modelle für OpenCode: Tool-Calling und mehr als 128K Kontext
ModellKostenlos beiKontextKostenlose Limits (bestes Angebot)ToolsBildverarbeitung
GLM 5.3UnoRouter1M1 Anfragen/Min.
1 req/min per model
JaNein
GLM 5.3 FlashNVIDIA NIM, UnoRouter1M40 Anfragen/Min.
40 RPM
JaJa
Gemini 3.8 FlashGoogle AI Studio1MRecurring provider quotaJaJa
Qwen3.8 Flash NextAMD Radeon Cloud262KRecurring daily account allowanceJaNein
Qwen3.8 FlashElectronHub1M$0.25/week shared recurring creditJaJa
Gemini 3.7 FlashGoogle AI Studio1M10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa
GPT-5.6 LunaElectronHub1M$0.25/week shared recurring creditJaJa
Dots3 Note PreviewKilo Gateway, OpenRouter512K20 Anfragen/Min.
50 Anfragen/Tag
50 req/day account-wide (1,000 after a $10 purchase)
JaJa
DeepSeek V4 FlashAMD Radeon Cloud, BazaarLink, ElectronHub1M10 Anfragen/Min.
50 Anfragen/Tag
Shared rate limit
JaNein
Qwen3.8 27BElectronHub, Groq, OVH AI Endpoints262K30 Anfragen/Min.
250 Anfragen/Tag
70,000 Token/Min.
~6M
JaJa
Gemini 3.6 FlashGoogle AI Studio1M10 Anfragen/Min.
20 Anfragen/Tag
250,000 Token/Min.
~3M
JaJa
Qwen 3.8 27BCloudflare Workers AI262KShared 10k neurons/dayJaJa

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_switch in der Datei .env von 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

ProblemUrsacheLösung
"Invalid API key" trotz gültigem SchlüsselEin leerer apiKey in der Konfiguration überschreibt den Schlüssel aus /connectEntfernen Sie apiKey aus options oder führen Sie setup-opencode erneut aus
OpenCode verwendet den neuen Anbieter nichtDas oberste Feld model ist nicht gesetztSetzen Sie "model": "freellmapi/auto"
Modell nicht gefundenDie Modell-ID steht nicht in der Zuordnung models des AnbietersFügen Sie die ID zur Zuordnung hinzu oder führen Sie setup-opencode erneut aus
Schlüssel {env:VAR} ist leerOpenCode ersetzt eine nicht gesetzte Variable durch eine leere ZeichenketteExportieren Sie die Variable in derselben Shell oder speichern Sie den Schlüssel mit /connect
Tool-Aufrufe schlagen fehlDas Modell unterstützt Tool-Calling schwachWählen Sie ein Modell aus der Tabelle oben
Fehlermeldung: "All models rate-limited after N attempts"Alle Schlüssel haben ihr Limit erreichtFügen Sie Schlüssel von weiteren Anbietern hinzu oder warten Sie auf die Abklingzeiten
Nutzen Sie alle diese Modelle über einen einzigen Schlüssel. FreeLLMAPI ist ein Open-Source-Router, den Sie selbst hosten. Er stellt alle diese kostenlosen Angebote hinter einem einzigen OpenAI-kompatiblen Endpunkt bereit und wechselt zum nächsten Anbieter, wenn ein Anbieter das Limit erreicht. Katalog ansehen oder Jetzt starten.

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

Quellen

Alle Anleitungen · Alle kostenlosen Modelle ansehen