---
title: "OpenCode serve 401-Schleife und endlose Basic-Auth-Popups: Schritt für Schritt gelöst"
description: "Nach dem Start von opencode serve hängt der Browser in einer Basic-Auth-Schleife oder liefert 401. So prüfst du leere Umgebungsvariablen, den Standardbenutzer opencode per curl, Reload-Anfragen und Reverse Proxies."
url: https://codingpass.ai/de/blog/opencode-serve-basic-auth-401-loop
language: de
updated: 2026-11-20
---
# 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.

[CodingPass-Team](https://codingpass.ai/de/about) Veröffentlicht 20. Nov. 2026 Aktualisiert 20. Nov. 2026 5 Min. Lesezeit

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](https://github.com/anomalyco/opencode/issues/50370) beschriebene Regression –, antworten Endpunkte mit `401 Unauthorized` ohne nutzbaren Dialog.

Ohne Passwortschutz im lokalen Netz beide Variablen sauber entfernen:

```
unset OPENCODE_SERVER_PASSWORD
unset OPENCODE_SERVER_USERNAME
opencode 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](https://github.com/anomalyco/opencode/issues/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](https://github.com/anomalyco/opencode/issues/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](https://github.com/anomalyco/opencode/issues/31254)), gib `-p` direkt mit:

```
opencode attach http://localhost:4096 -p your-password
```

## Schnellübersicht

| 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](https://codingpass.ai/de/tools/opencode) beschrieben.

Geschrieben von CodingPass-Team

Wir betreiben CodingPass und testen jede Anleitung vor der Veröffentlichung mit der aktuellen stabilen Version des Tools. Etwas ist veraltet? Schreib an [support@codingpass.ai](mailto:support@codingpass.ai).

## Mehr zum Thema.

Anleitung

### [OpenCode-Anleitung](https://codingpass.ai/de/tools/opencode)

Die Provider-Konfiguration in opencode.jsonc, Modell-IDs für jede Stufe und wie du typische Fehler prüfst.

Referenz

### [So funktionieren Kontingente und Limits](https://codingpass.ai/de/usage-limits)

Jedes Kontingent und jedes Limit pro Tarif und Modell sowie die 429-Antwort.

Modelle

### [Alle Modelle](https://codingpass.ai/de/models)

Modell-IDs, erforderliche Stufe und das Monatskontingent für jedes Modell.
