ВойтиВыбрать тариф
Блог · Инструкции по настройке

Цикл 401 в OpenCode serve: почему окно входа не исчезает

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

После запуска 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 — эндпоинты отдают 401 Unauthorized без нормального запроса входа.

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

unset OPENCODE_SERVER_PASSWORDunset OPENCODE_SERVER_USERNAMEopencode 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 — обновите OpenCode до свежей версии.

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

Иногда первый вход проходит, но после F5 окно вылезает снова. Во вкладке Network в такие моменты нередко видны 401 на /site.webmanifest или /global/health (#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), явно передайте -p при подключении:

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

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

Шпаргалка по ошибкам 401 в OpenCode serve
СимптомЧто проверить первым делом
Вечная загрузка / 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.

Посадка

Разделите защиту сервера и ключи моделей.

Поднимите opencode serve локально без цикла 401 и подключите провайдера CodingPass для доступа к Claude, GPT и открытым моделям с оплатой по факту.

  • ID запроса в каждом ответе
  • Полный возврат, если израсходовано не больше 5%
  • Никаких неожиданных списаний
Выбрать GoРуководство по OpenCode

$10/мес., пока вы не отмените подписку.