OpenCode-Anleitung
Die Provider-Konfiguration in opencode.jsonc, Modell-IDs für jede Stufe und wie du typische Fehler prüfst.
Du startest opencode serve und landest im Browser in einer endlosen HTTP-Basic-Auth-Abfrage oder einem Ladekreis mit 401. Mit einem kurzen Check von Umgebung, curl, DevTools und Proxy findest du die Ursache schnell.
Wer opencode serve oder opencode web in OpenCode 2.x startet und im Browser öffnet, landet schnell in einer von zwei Schleifen: Entweder war gar kein Passwort gesetzt und die Oberfläche hängt trotzdem mit 401 Unauthorized im Ladekreis, oder das richtige Passwort ist eingegeben und der Basic-Auth-Dialog poppt trotzdem immer wieder auf.
Im Browser weiterzuklicken hilft selten weiter. Geht man der Reihe nach Umgebungsvariablen, curl, den Network-Tab und eventuelle Reverse Proxies durch, zeigt sich schnell, wo es klemmt.
Zwei Dinge sorgen besonders oft für Verwirrung: OPENCODE_SERVER_PASSWORD="" verhält sich nicht wie ein echtes unset, und sobald ein Passwort aktiv ist, erwartet OpenCode den Standardbenutzer opencode.
OPENCODE_SERVER_PASSWORD prüfenIst OPENCODE_SERVER_PASSWORD gar nicht gesetzt, läuft opencode serve ohne Auth. Steht in .env oder dem Shell-Profil allerdings OPENCODE_SERVER_PASSWORD="" – oder greift die in anomalyco/opencode#50370 beschriebene Regression –, antworten Endpunkte mit 401 Unauthorized ohne nutzbaren Dialog.
Ohne Passwortschutz im lokalen Netz beide Variablen sauber entfernen:
unset OPENCODE_SERVER_PASSWORDunset OPENCODE_SERVER_USERNAMEopencode servecurl testen, nicht im Browser ratenIst Passwortschutz gewollt, wird im Browser-Popup meist der Benutzername falsch eingetragen: OpenCode nutzt standardmäßig opencode (OPENCODE_SERVER_USERNAME), nicht deinen Systembenutzer und kein leeres Feld.
Beide Variablen explizit exportieren:
export OPENCODE_SERVER_USERNAME="opencode"export OPENCODE_SERVER_PASSWORD="your-password"opencode serveUnd im zweiten Terminal direkt gegen /global/health prüfen:
curl -i -u opencode:your-password http://127.0.0.1:4096/global/healthcurl 200, liegt die Schleife am Browser-Cache oder Proxy.v2 serve auch bei curl 401, steckt der Build vermutlich in der Regression aus #45856 – dann auf das neueste Release aktualisieren.Wenn der Login erst klappt und erst beim Neuladen wieder abfragt, zeigt der Network-Tab oft 401-Antworten auf /site.webmanifest oder /global/health (#18325). Passwortmanager füllen native Basic-Auth-Fenster zudem oft unzuverlässig aus.
opencode attach prüfenLäuft opencode serve hinter Nginx, Caddy oder Cloudflare Access mit eigener Anmeldung und bleibt OPENCODE_SERVER_PASSWORD parallel aktiv, senden beide Seiten kollidierende WWW-Authenticate-Header. Binde opencode serve an 127.0.0.1 und entferne das eigene Passwort, damit nur der Proxy prüft.
Tritt 401 bei opencode attach oder einem SDK auf (#31254), gib -p direkt mit:
opencode attach http://localhost:4096 -p your-password| Symptom | Erster Check |
|---|---|
| Endlos-Laden / 401 ohne Passwort | Prüfen, dass kein OPENCODE_SERVER_PASSWORD="" gesetzt ist; vorab unset ausführen |
| Browser lehnt richtiges Passwort ab | Benutzername opencode verwenden und per curl -u opencode:... testen |
| Schleife hinter Nginx / Caddy / Cloudflare Access | OPENCODE_SERVER_PASSWORD in OpenCode entfernen, nur der Proxy authentifiziert |
opencode attach oder SDK meldet 401 | -p <passwort> übergeben bzw. Basic-Auth-Header senden |
Wichtig zur Abgrenzung: OPENCODE_SERVER_PASSWORD schützt nur den lokalen HTTP-Server von OpenCode, nicht deinen Modell-API-Key. Für CodingPass hinterlegst du den Key weiterhin über opencode service set env CODINGPASS_API_KEY cp-live-... wie in der OpenCode-Anleitung beschrieben.
Betreibe opencode serve lokal ohne Auth-Schleifen und richte deinen Provider auf CodingPass ein – für nutzungsbasierten Zugriff auf Claude, GPT und Open-Weight-Modelle.