Руководство по OpenCode
Блок provider для opencode.jsonc, ID моделей по тарифам и разбор частых ошибок.
После запуска 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.
Если OPENCODE_SERVER_PASSWORD не задан, сервер должен работать без пароля. Но если в .env или профиле оболочки осталась строка OPENCODE_SERVER_PASSWORD="" — либо сработала регрессия из anomalyco/opencode#50370 — эндпоинты отдают 401 Unauthorized без нормального запроса входа.
Для локальной работы без пароля полностью удалите обе переменные:
unset OPENCODE_SERVER_PASSWORDunset OPENCODE_SERVER_USERNAMEopencode servecurl, а не браузерЕсли защита паролем нужна, в диалоге браузера чаще всего ошибаются с именем пользователя. При включённом 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/healthcurl возвращает 200, сервер и пароль в порядке — проблема в кэше браузера или прокси.curl на v2 serve получает 401, вероятна регрессия из #45856 — обновите OpenCode до свежей версии.Иногда первый вход проходит, но после F5 окно вылезает снова. Во вкладке Network в такие моменты нередко видны 401 на /site.webmanifest или /global/health (#18325), а менеджеры паролей в браузере плохо подставляют данные в системный диалог Basic Auth.
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_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 и открытым моделям с оплатой по факту.