start_within in der Konfiguration festlegen, sodass ein Agent-Schlüssel hier optional ist. Der Schlüssel ist jedoch weiterhin der einfachere Weg, da er sich ohne Neustart ändern lässt. Siehe Agent-Schlüssel.
Einrichtung mit einem Agenten
Öffnen Sie den folgenden Block und kopieren Sie ihn in einen beliebigen Coding-Agenten. Der Prompt fragt niemals nach Ihrem API-Schlüssel: Der Agent konfiguriert alles andere und gibt dann die eine Exportzeile aus, die Sie selbst ausführen können.Agent-Setup-Prompt kopieren
Agent-Setup-Prompt kopieren
OpenCode konfigurieren
- Exportieren Sie den Schlüssel in der Shell, die OpenCode startet.
- Schreiben Sie den Provider-Eintrag in
opencode.json.
- Starten Sie OpenCode mit dieser Datei.
npm wählt das OpenAI-kompatible Paket aus. options.baseURL sendet Anfragen an den Router. options.apiKey liest den Schlüssel aus der Umgebung. Jeder Schlüssel unter models ist ein Slug, den wir ausführen.
Fügen Sie ein Modell hinzu, indem Sie einen Schlüssel unter models hinzufügen. Alles andere im Eintrag dient der Anzeige und den Limits.
Global oder pro Projekt
Platzieren Sie den Provider-Eintrag an einer von zwei Stellen, je nachdem, wie weit Sie ihn anwenden möchten.
Projektkonfiguration hat Vorrang vor globaler Konfiguration. OpenCode sucht im Arbeitsverzeichnis nach
opencode.json und geht bis zum nächsten Git-Verzeichnis hoch, sodass ein Repository Ihren maschinenweiten Provider überschreiben kann, ohne ihn zu ändern.
Platzieren Sie den Provider-Eintrag in der globalen Datei, und die Deadline bleibt überall gleich. Platzieren Sie ihn in einer Projektdatei, und nur dieses Repository leitet Anfragen über uns.
Setzen Sie OPENCODE_DISABLE_PROJECT_CONFIG, um die aufsteigende Suche zu beenden.
Zwei weitere Quellen existieren für Bundles und Automatisierung. OPENCODE_CONFIG_DIR benennt ein Verzeichnis, aus dem OpenCode Konfigurationen liest, und OPENCODE_CONFIG_CONTENT enthält das JSON inline. Verwenden Sie OPENCODE_CONFIG für eine Datei, die Sie pro Lauf auswählen.
Deadline stattdessen in der Konfiguration festlegen
OpenCode kannstart_within selbst senden. Beide Stellen sind reines JSON, und beide haben Vorrang vor dem Schlüssel.
Legen Sie es pro Modell fest. Der options-Block wird in den Request-Body für dieses Modell eingefügt.
--variant bei opencode run aus oder wechseln Sie sie in der TUI mit ctrl+t durch.
Bestätigen, dass der Schlüssel angewendet wurde
Jede Antwort enthältx-flexinference-defaults-applied. OpenCode zeigt keine Response-Header in der TUI an, lesen Sie stattdessen die Anfrage im Dashboard unter Logs.
Fehlerbehebung
Anfragen erreichen uns nie. Das Top-Level-Feldmodel wählt den Provider aus. Wenn Sie also einen Provider definieren, ohne ihn dort zu benennen, bleibt OpenCode bei seiner integrierten Standardeinstellung. Setzen Sie "model": "flexinference/<slug>".
401 invalid_api_key. FLEXINFERENCE_API_KEY ist in der Shell, die OpenCode gestartet hat, nicht gesetzt. Exportieren Sie ihn vor dem Start, da options.apiKey ihn aus der Umgebung liest.
400 unsupported_parameter. Ein Chat Completions-Parameter, den wir nicht übersetzen, war in den options eines Modells enthalten, z. B. seed oder stop. Entfernen Sie ihn aus dem Eintrag.
400 key_default_not_applicable. Ihr Schlüssel enthält eine Dauer, und einer dieser Parameter wurde daneben angegeben. Bearbeiten Sie den Schlüssel auf eine Stufe oder entfernen Sie den Parameter.
400 flex_unsupported_for_anthropic. Eine Dauer in options erreichte ein claude-*-Modell mit Ihrem eigenen Anthropic-Schlüssel. Der Wettlauf, den eine Claude-Dauer ausführt, erfordert verwaltete Schlüssel. Entfernen Sie die Dauer und lassen Sie den Schlüssel die Deadline halten, da eine Schlüssel-Dauer stattdessen ein Fallback auslöst.
Eine Konfigurationsänderung bewirkte nichts. Eine spätere Konfigurationsquelle hat sie überschrieben. Überprüfen Sie die oben genannte Suchreihenfolge und bevorzugen Sie OPENCODE_CONFIG, um sich pro Lauf für eine Datei zu entscheiden.
Siehe Fehler für jede von uns zurückgegebene Ablehnung und Agent-Schlüssel für diejenigen, die nicht spezifisch für OpenCode sind. OpenWork und OpenScience lesen denselben Provider-Eintrag.