AnmeldenTarif wählen
Blog · Setup-Anleitungen

OpenCode serve 401-Schleife: Warum das Login-Fenster bleibt

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.

Schritt 1: Auf leeres OPENCODE_SERVER_PASSWORD prüfen

Ist 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 serve

Schritt 2: Erst per curl testen, nicht im Browser raten

Ist 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 serve

Und im zweiten Terminal direkt gegen /global/health prüfen:

curl -i -u opencode:your-password http://127.0.0.1:4096/global/health
  • Liefert curl 200, liegt die Schleife am Browser-Cache oder Proxy.
  • Liefert v2 serve auch bei curl 401, steckt der Build vermutlich in der Regression aus #45856 – dann auf das neueste Release aktualisieren.

Schritt 3: Im Network-Tab Reload-Anfragen prüfen

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.

Schritt 4: Reverse Proxy und opencode attach prüfen

Lä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

Schnellübersicht

Schnelle Lösungen für 401-Schleifen bei OpenCode serve
SymptomErster Check
Endlos-Laden / 401 ohne PasswortPrüfen, dass kein OPENCODE_SERVER_PASSWORD="" gesetzt ist; vorab unset ausführen
Browser lehnt richtiges Passwort abBenutzername opencode verwenden und per curl -u opencode:... testen
Schleife hinter Nginx / Caddy / Cloudflare AccessOPENCODE_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.

Abfahrt

Server-Auth und Modell-Keys getrennt halten.

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.

  • Request-ID in jeder Antwort
  • Volle Erstattung bei höchstens 5 % Nutzung
  • Keine Überraschungskosten
Go wählenOpenCode-Anleitung

$10/Monat bis zur Kündigung.