---
title: "Bucle 401 y avisos infinitos de Basic Auth en OpenCode serve: cómo depurarlo"
description: "Lanzas opencode serve y el navegador no deja de pedir Basic Auth o se queda en 401. Sigue este orden: variables vacías, prueba del usuario opencode con curl, recargas en Network y conflicto con proxy inverso."
url: https://codingpass.ai/es/blog/opencode-serve-basic-auth-401-loop
language: es
updated: 2026-11-20
---
# Bucle 401 en OpenCode serve: por qué vuelve el diálogo de acceso

Al abrir opencode serve en el navegador es fácil quedarse atrapado en un diálogo infinito de Basic Auth o en una carga eterna con 401. Revisando entorno, curl, Network y proxy en orden se localiza el fallo en minutos.

[Equipo de CodingPass](https://codingpass.ai/es/about) Publicado 20 nov 2026 Actualizado 20 nov 2026 5 min de lectura

Al arrancar `opencode serve` u `opencode web` en OpenCode 2.x y abrirlo en el navegador, es habitual tropezar con uno de estos dos bloqueos: o no configuraste contraseña y aun así la web gira sin fin devolviendo `401 Unauthorized`, o pusiste contraseña, la escribiste bien y el diálogo de HTTP Basic Auth reaparece cada pocos segundos.

Reintentar en el navegador rara vez aclara qué pasa. Salir a la terminal y comprobar en orden variables de entorno, `curl`, la pestaña Network y el proxy inverso despeja la causa enseguida.

Dos detalles despistan casi siempre: dejar `OPENCODE_SERVER_PASSWORD=""` vacío no equivale a hacer `unset`, y cuando hay contraseña activa, OpenCode espera el usuario por defecto `opencode`.

## Paso 1: Revisa si quedó una variable vacía

Sin `OPENCODE_SERVER_PASSWORD`, el servidor debe funcionar sin contraseña. Pero si en `.env` o en tu perfil de shell quedó `OPENCODE_SERVER_PASSWORD=""` —o te topas con la regresión de [anomalyco/opencode#50370](https://github.com/anomalyco/opencode/issues/50370)—, los endpoints devuelven `401 Unauthorized` sin abrir un inicio de sesión válido.

Si trabajas en local o en una red de confianza sin contraseña, elimina ambas variables antes de arrancar:

```
unset OPENCODE_SERVER_PASSWORD
unset OPENCODE_SERVER_USERNAME
opencode serve
```

## Paso 2: Prueba primero con `curl` antes de culpar al navegador

Cuando sí quieres contraseña, lo que más suele fallar en el cuadro del navegador es el **usuario**: OpenCode fija por defecto **`opencode`** (`OPENCODE_SERVER_USERNAME`), no tu usuario del sistema ni un campo vacío.

Exporta ambos valores de forma explícita:

```
export OPENCODE_SERVER_USERNAME="opencode"
export OPENCODE_SERVER_PASSWORD="your-password"
opencode serve
```

Y prueba `/global/health` desde otra terminal:

```
curl -i -u opencode:your-password http://127.0.0.1:4096/global/health
```

- Si `curl` devuelve `200`, servidor y credenciales están bien; el bucle viene de la caché del navegador o del proxy.
- Si `v2 serve` también responde `401` en `curl`, puede ser la regresión de [#45856](https://github.com/anomalyco/opencode/issues/45856); actualiza OpenCode a la última versión.

## Paso 3: Mira la pestaña Network al recargar

Si el primer acceso funciona pero al refrescar vuelve el aviso, revisa Network: peticiones como `/site.webmanifest` o `/global/health` pueden devolver `401` al recargar ([#18325](https://github.com/anomalyco/opencode/issues/18325)), y los gestores de contraseñas suelen fallar al rellenar diálogos nativos de Basic Auth.

## Paso 4: Comprueba el proxy inverso y los flags de `opencode attach`

Si `opencode serve` está detrás de Nginx, Caddy o Cloudflare Access con su propio login y mantienes `OPENCODE_SERVER_PASSWORD` activo, ambos envían cabeceras `WWW-Authenticate` enfrentadas. Vincula `opencode serve` a `127.0.0.1` sin su propia contraseña para que autentique solo el proxy.

Y si el `401` aparece en otra terminal o en un SDK ([#31254](https://github.com/anomalyco/opencode/issues/31254)), pasa `-p` al conectar:

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

## Resumen rápido

| Síntoma | Qué comprobar primero |
| --- | --- |
| Carga infinita / 401 sin contraseña | Asegúrate de no tener `OPENCODE_SERVER_PASSWORD=""` y ejecuta `unset` |
| El navegador rechaza la contraseña correcta | Usa el usuario `opencode` y verifica con `curl -u opencode:...` |
| Bucle detrás de Nginx / Caddy / Cloudflare Access | Quita la contraseña propia de OpenCode y deja la auth en el proxy |
| `opencode attach` o SDK reciben 401 | Añade `-p <contraseña>` o la cabecera Basic Auth |

Por último, recuerda que `OPENCODE_SERVER_PASSWORD` solo protege el servidor HTTP local de OpenCode, no tu clave de modelos. Para CodingPass, guarda tu clave aparte con `opencode service set env CODINGPASS_API_KEY cp-live-...` como indica la [guía de OpenCode](https://codingpass.ai/es/tools/opencode).

Escrito por Equipo de CodingPass

Operamos CodingPass y probamos cada guía con la última versión estable de la herramienta antes de publicarla. ¿Ves algo desactualizado? Escribe a [support@codingpass.ai](mailto:support@codingpass.ai).

## Lecturas relacionadas.

Guía

### [Guía de configuración de OpenCode](https://codingpass.ai/es/tools/opencode)

Configuración de proveedor en opencode.jsonc, IDs de modelo por plan y cómo revisar errores comunes.

Reglas

### [Cómo funcionan las cuotas y los límites](https://codingpass.ai/es/usage-limits)

Cuotas y límites para cada plan y modelo, además de la respuesta 429.

Modelos

### [Todos los modelos](https://codingpass.ai/es/models)

IDs de modelo, niveles requeridos y cuotas mensuales.
