---
title: "Бесконечное окно Basic Auth и цикл 401 в OpenCode serve: пошаговая отладка"
description: "Запустили opencode serve, а браузер без конца просит логин Basic Auth или зависает с 401. Разбираем шаг за шагом: пустые переменные, проверка пользователя opencode через curl, повторные запросы при обновлении и двойная авторизация."
url: https://codingpass.ai/ru/blog/opencode-serve-basic-auth-401-loop
language: ru
updated: 2026-11-20
---
# Цикл 401 в OpenCode serve: почему окно входа не исчезает

После запуска opencode serve веб-интерфейс может застрять на вечной загрузке с 401 или бесконечно показывать окно Basic Auth. Если проверить окружение, curl, вкладку Network и прокси по очереди, причина находится за пару минут.

[Команда CodingPass](https://codingpass.ai/ru/about) Опубликовано 20 нояб. 2026 г. Обновлено 20 нояб. 2026 г. 5 мин чтения

После запуска `opencode serve` или `opencode web` в OpenCode 2.x легко упереться в одну из двух проблем: либо пароль вообще не задавался, но страница бесконечно крутит загрузку с ошибкой `401 Unauthorized`, либо пароль введён верно, но браузер каждые несколько секунд снова открывает окно HTTP Basic Auth.

Вводить пароль в браузере по кругу бесполезно. Гораздо быстрее выйти из браузера и пройти по цепочке: переменные окружения → `curl` → вкладка Network → внешний прокси.

Две детали чаще всего сбивают с толку: пустая строка `OPENCODE_SERVER_PASSWORD=""` ведёт себя не так, как полный `unset`, а при включённом пароле по умолчанию ожидается логин `opencode`.

## Шаг 1. Проверьте, не осталась ли пустая переменная

Если `OPENCODE_SERVER_PASSWORD` не задан, сервер должен работать без пароля. Но если в `.env` или профиле оболочки осталась строка `OPENCODE_SERVER_PASSWORD=""` — либо сработала регрессия из [anomalyco/opencode#50370](https://github.com/anomalyco/opencode/issues/50370) — эндпоинты отдают `401 Unauthorized` без нормального запроса входа.

Для локальной работы без пароля полностью удалите обе переменные:

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

## Шаг 2. Сначала проверьте `curl`, а не браузер

Если защита паролем нужна, в диалоге браузера чаще всего ошибаются с **именем пользователя**. При включённом `OPENCODE_SERVER_PASSWORD` логин по умолчанию — **`opencode`** (`OPENCODE_SERVER_USERNAME`), а не ваш системный пользователь и не пустая строка.

Задайте обе переменные явно:

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

И проверьте `/global/health` из второго терминала:

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

- Если `curl` возвращает `200`, сервер и пароль в порядке — проблема в кэше браузера или прокси.
- Если даже `curl` на `v2 serve` получает `401`, вероятна регрессия из [#45856](https://github.com/anomalyco/opencode/issues/45856) — обновите OpenCode до свежей версии.

## Шаг 3. Посмотрите Network при обновлении страницы

Иногда первый вход проходит, но после F5 окно вылезает снова. Во вкладке Network в такие моменты нередко видны `401` на `/site.webmanifest` или `/global/health` ([#18325](https://github.com/anomalyco/opencode/issues/18325)), а менеджеры паролей в браузере плохо подставляют данные в системный диалог Basic Auth.

## Шаг 4. Проверьте обратный прокси и `opencode attach`

Если перед `opencode serve` стоит Nginx, Caddy или Cloudflare Access со своей авторизацией, а `OPENCODE_SERVER_PASSWORD` тоже включён, конфликтующие заголовки `WWW-Authenticate` загоняют браузер в цикл. Привяжите `opencode serve` к `127.0.0.1` и уберите его собственный пароль — пусть проверяет только прокси.

А если `401` получает другой терминал или SDK ([#31254](https://github.com/anomalyco/opencode/issues/31254)), явно передайте `-p` при подключении:

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

## Шпаргалка по симптомам

| Симптом | Что проверить первым делом |
| --- | --- |
| Вечная загрузка / 401 без пароля | Убрать `OPENCODE_SERVER_PASSWORD=""` и выполнить `unset` перед запуском |
| Браузер не принимает верный пароль | Указать логин `opencode` и проверить через `curl -u opencode:...` |
| Цикл за Nginx / Caddy / Cloudflare Access | Отключить пароль в OpenCode, оставив авторизацию только на прокси |
| `opencode attach` или SDK получают 401 | Передать `-p <пароль>` или явный заголовок Basic Auth |

И последнее: `OPENCODE_SERVER_PASSWORD` закрывает только сам локальный HTTP-сервер OpenCode и не заменяет ключ провайдера моделей. Ключ CodingPass задаётся отдельно через `opencode service set env CODINGPASS_API_KEY cp-live-...`, подробнее — в [руководстве по OpenCode](https://codingpass.ai/ru/tools/opencode).

Автор Команда CodingPass

Мы делаем CodingPass и перед публикацией проверяем каждую инструкцию на последней стабильной версии инструмента. Нашли что-то устаревшее? Напишите на [support@codingpass.ai](mailto:support@codingpass.ai).

## По теме.

Руководство

### [Руководство по OpenCode](https://codingpass.ai/ru/tools/opencode)

Блок provider для opencode.jsonc, ID моделей по тарифам и разбор частых ошибок.

Справка

### [Как устроены квоты и лимиты](https://codingpass.ai/ru/usage-limits)

Квоты и лимиты для каждого тарифа и каждой модели, а также ответ 429.

Модели

### [Все модели](https://codingpass.ai/ru/models)

ID каждой модели, нужный тариф и месячная квота.
