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.
Offizielle Informationen Downloads und Dokumentation richten sich nach der offiziellen Website.
Worum es sich bei diesem Tool handelt und wofür es verwendet wird
Speicherort der Konfigurationsdatei
| System | Speicherort der Konfigurationsdatei | Beschreibung |
|---|---|---|
| Windows | C: \Users\YourUsername\. config\opencode\opencode.json | Falls die Datei nicht existiert, eine neue erstellen |
| macOS / Linux | ~/. config/opencode/opencode.json | Falls die Datei nicht existiert, eine neue erstellen |
Mit dem Verbindungsassistenten starten
OpenCode-Verbindungsassistent
cd YOUR_TEST_PROJECT opencode /connect OpenCode-Modellprüfung
cd YOUR_TEST_PROJECT opencode /models 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 Punkte | Beschreibung |
|---|---|
| Provider-Typ | Protokolle von OpenAI, Claude, Gemini oder anderen Anbietern nicht vermischen |
| Base-URL | Verwenden Sie die vollständige Adresse, die der Provider für OpenCode oder das entsprechende Protokoll bereitstellt |
| Key | Verwenden Sie den Key, der zum aktuellen Provider gehört |
| Modellname | Modellliste aus dem Backend des Providers kopieren |
So testen Sie nach dem Speichern
- Führen Sie nach dem Wechsel in ein Testprojektverzeichnis
opencodeaus. - Bestätigen Sie zunächst mit
/models, dass das gerade konfigurierte Modell sichtbar ist. - Senden Sie nach Auswahl des Modells: „Bitte antworte nur: OpenCode-Konfiguration erfolgreich“.
- Lassen Sie das Modell beim ersten Mal keine Dateien bearbeiten, sondern lediglich das aktuelle Verzeichnis oder die aktuelle Datei erklären.
- Falls ein Fehler auftritt, kehren Sie zunächst zu
/connectzurück oder überprüfen Sie Provider, Base-URL, Key und Modellname anhand der Provider-Dokumentation.
| Phänomen | Vorrangige Prüfung | Lösung |
|---|---|---|
/models enthält kein Modell | Prüfen, ob der Provider erfolgreich gespeichert wurde und ob die Modellliste abgerufen werden kann | Modell-ID / Modellname aus dem Provider-Backend manuell hinzufügen |
| Verbindung fehlgeschlagen | Prüfen, ob die Base-URL zum Protokoll des aktuellen Providers gehört | Adressen von Claude, Gemini und OpenAI nicht vermischen |
| Konfigurationsdatei ist ungültig | JSON-Format, Kommas, Anführungszeichen | Erstellen 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.
