Iniciar sesiónElegir plan
Blog · Guías de configuración

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.

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—, 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_PASSWORDunset OPENCODE_SERVER_USERNAMEopencode 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; 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), 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), pasa -p al conectar:

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

Resumen rápido

Guía rápida para bucles 401 en OpenCode serve
SíntomaQué comprobar primero
Carga infinita / 401 sin contraseñaAsegúrate de no tener OPENCODE_SERVER_PASSWORD="" y ejecuta unset
El navegador rechaza la contraseña correctaUsa el usuario opencode y verifica con curl -u opencode:...
Bucle detrás de Nginx / Caddy / Cloudflare AccessQuita la contraseña propia de OpenCode y deja la auth en el proxy
opencode attach o SDK reciben 401Añ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.

Embarque

Separa la auth del servidor de tus claves de modelo.

Deja opencode serve en local sin bucles 401 y apunta tu proveedor a CodingPass para usar Claude, GPT y modelos abiertos con pago por uso.

  • ID de solicitud en cada respuesta
  • Reembolso total si has usado el 5% o menos
  • Sin cargos sorpresa
Elegir GoGuía de OpenCode

$10/mes hasta que canceles.