Laufzeit prüfen
Bereiten Sie Node.js LTS, Git, einen sauberen Projektordner und ein Terminal mit Zugriff auf den Modellprovider vor.
Praxisleitfaden 2026
OpenCode Deployment GuideInstallieren, konfigurierenund Modellzugriff prüfen
Dieser Leitfaden hilft Entwicklern, OpenCode schnell lauffähig zu machen. Er behandelt Umgebung, CLI-Installation, Provider-Verbindung, Projektkonfiguration, Validierung und typische Fehler.
- Einstieg
- CLI zuerst
- Kernkonfiguration
- Provider + Modell
- Geeignet für
- AI-Coding-Nutzer
Quick Start
Deployment-Ablauf in 7 Schritten
Nutzen Sie diese Reihenfolge für die Erstinstallation oder beim Umzug auf einen neuen Rechner.
CLI installieren
Nutzen Sie die offizielle Methode und prüfen Sie, ob der Befehl opencode verfügbar ist.
Provider verbinden
Starten Sie mit einem Provider und speichern Sie API-Schlüssel außerhalb des Repositories.
Modell wählen
Beginnen Sie mit einem stabilen Modell und kopieren Sie die echte Modell-ID aus Dashboard oder Dokumentation.
Projektkonfiguration erstellen
Nutzen Sie opencode.json für nicht geheime Einstellungen wie Berechtigungen, ignorierte Pfade und Standardmodell.
Kleine Validierung ausführen
Lassen Sie OpenCode eine Datei erklären, eine risikoarme Änderung machen und einen Test ausführen.
Fehlernotizen sichern
Dokumentieren Sie Node-Version, Provider, Proxy, Standardmodell und häufige Fehler.
Provider
Provider: zuerst eine Verbindung stabil bekommen
Die meisten Probleme entstehen durch API-Schlüssel, Base URLs, Modellnamen, Proxy-Einstellungen oder zu breite Rechte.
| Prüfung | Empfohlene Aktion | Häufiger Fehler |
|---|---|---|
| API-Schlüssel | Außerhalb des Repositories speichern. | Secrets nach Git committen. |
| Base URL | Offiziellen oder kompatiblen Endpunkt nutzen. | Falscher Pfad oder fehlendes Protokoll. |
| Modellname | Die echte Modell-ID kopieren. | Marketingnamen als API-ID verwenden. |
| Berechtigungen | Konservativ starten und nach Tests erweitern. | Vor der Validierung alles erlauben. |
Project config example
Use this as a non-secret configuration shape. Confirm exact fields with your OpenCode version.
{
"model": "provider/model-id",
"permission": { "edit": "ask", "bash": "ask" },
"ignore": ["node_modules", ".env", "dist"]
}Platform Notes
Hinweise nach Plattform
Windows
PowerShell reicht für einfache Projekte; bei vielen Linux-Tools ist WSL meist besser.
macOS
Prüfen Sie, welche Node-Installation das Terminal wirklich nutzt.
Linux
Nutzen Sie keinen Root-Alltag für Entwicklung und schützen Sie API-Schlüssel.
Troubleshooting
Reihenfolge zur Fehlersuche
- Fehlt der Befehl, prüfen Sie den globalen npm-bin-Pfad und öffnen Sie das Terminal neu.
- Ist die Modellliste leer, prüfen Sie Provider, API-Schlüssel, Base URL und Netzwerk.
- Bei Timeouts trennen Sie lokales Netzwerk, Proxy, Rate Limits und Ausfälle.
- Bei Rechteproblemen prüfen Sie Arbeitsordner, Dateirechte und Policy.
- Bei instabiler Qualität zuerst mit einem stabilen Modell validieren.
FAQ
OpenCode Deployment FAQ
Was brauche ich vor OpenCode?
Node.js LTS, Git, ein Terminal und mindestens einen Provider-API-Schlüssel.
Wohin gehört opencode.json?
Meist in die Repository-Wurzel, aber niemals mit Secrets.
Wie validiere ich das Deployment?
Datei lesen, kleine Änderung machen und Test oder Formatierung ausführen.