Einrichtungsleitfaden

Provider-Einrichtungsleitfaden

Einrichtungsschritte und Fehlerbehebung nach Tool durchsuchen.

Provider-Einrichtungsleitfaden/OpenCode-Konfiguration

OpenCode-Konfiguration

OpenCode ist ein quelloffener KI-Coding-Assistent für das Terminal. Er eignet sich für Code-Q&A, Dateiänderungen und Modellwechsel innerhalb eines Projektverzeichnisses. Einsteiger sollten zunächst den integrierten Verbindungsassistenten nutzen und vermeiden, die JSON-Datei zu Beginn manuell komplett neu zu schreiben.

Worum es sich bei diesem Tool handelt und wofür es verwendet wird

Speicherort der Konfigurationsdatei

SystemSpeicherort der KonfigurationsdateiBeschreibung
WindowsC: \Users\YourUsername\. config\opencode\opencode.jsonFalls die Datei nicht existiert, eine neue erstellen
macOS / Linux~/. config/opencode/opencode.jsonFalls die Datei nicht existiert, eine neue erstellen

Mit dem Verbindungsassistenten starten

OpenCode-Verbindungsassistent
cd YOUR_TEST_PROJECT opencode /connect

Was bei der manuellen Konfiguration zu beachten ist

Bearbeiten Sie die Konfigurationsdatei nur, wenn in der Dokumentation Ihres Providers das OpenCode-Provider-Feld, der Speicherort der Base-URL und der Key eindeutig angegeben sind. Felder können sich zwischen Versionen unterscheiden; kopieren Sie keine JSON-Beispiele aus anderen Tools direkt in OpenCode.

Zu prüfende PunkteBeschreibung
Provider-TypProtokolle von OpenAI, Claude, Gemini oder anderen Anbietern nicht vermischen
Base-URLVerwenden Sie die vollständige Adresse, die der Provider für OpenCode oder das entsprechende Protokoll bereitstellt
KeyVerwenden Sie den Key, der zum aktuellen Provider gehört
ModellnameModellliste aus dem Backend des Providers kopieren

So testen Sie nach dem Speichern

  1. Führen Sie nach dem Wechsel in ein Testprojektverzeichnis opencode aus.
  2. Bestätigen Sie zunächst mit /models, dass das gerade konfigurierte Modell sichtbar ist.
  3. Senden Sie nach Auswahl des Modells: „Bitte antworte nur: OpenCode-Konfiguration erfolgreich“.
  4. Lassen Sie das Modell beim ersten Mal keine Dateien bearbeiten, sondern lediglich das aktuelle Verzeichnis oder die aktuelle Datei erklären.
  5. Falls ein Fehler auftritt, kehren Sie zunächst zu /connect zurück oder überprüfen Sie Provider, Base-URL, Key und Modellname anhand der Provider-Dokumentation.
PhänomenVorrangige PrüfungLösung
/models enthält kein ModellPrüfen, ob der Provider erfolgreich gespeichert wurde und ob die Modellliste abgerufen werden kannModell-ID / Modellname aus dem Provider-Backend manuell hinzufügen
Verbindung fehlgeschlagenPrüfen, ob die Base-URL zum Protokoll des aktuellen Providers gehörtAdressen von Claude, Gemini und OpenAI nicht vermischen
Konfigurationsdatei ist ungültigJSON-Format, Kommas, AnführungszeichenErstellen Sie die Konfiguration vorzugsweise über den Verbindungsassistenten und nehmen Sie danach kleinere manuelle Anpassungen vor.
Offizielle OpenCode-Website Anweisungen zu Installation, Authentifizierung und Befehlen anzeigen.
OpenCode AI-Provider-Konfigurationsreferenz Den Konfigurationsansatz für opencode.json einsehen.