Решение проблем

Двенадцать конкретных сценариев отказа, которые мы видим каждую неделю. Симптом → причина → однострочный фикс.

Топ-вопросы

Нужно ли логиниться в Claude Code? Что делать с 401 и «Auth conflict»

Нет. Ключ OneProvider работает без входа в аккаунт Claude. Для Claude Code задайте ANTHROPIC_BASE_URL и ANTHROPIC_AUTH_TOKEN (ключ уходит как Authorization: Bearer). Эта переменная главнее сохранённого входа и других переменных и не требует подтверждения. ANTHROPIC_API_KEY (заголовок x-api-key) наш шлюз тоже принимает, но Claude Code в интерактивном режиме один раз просит подтвердить такой ключ и молча игнорирует отклонённый (включить снова: /config → Use custom API key).

Если видите экран входа, 401 Invalid API key или Auth conflict, идите по шагам:

1. Выполните /status: должны быть Anthropic base URL с адресом OneProvider и строка Auth token или API key с вашей переменной. Если там Login method с аккаунтом claude.ai, переменная не дошла до сессии.
2. Auth conflict (и вход в claude.ai, и ключ): выполните /logout, переменные останутся.
3. 401 Invalid API key: в окружении лежит чужой ANTHROPIC_AUTH_TOKEN (токен другого сервиса) и перекрывает ключ, или в нём лишняя кавычка или пробел. Задайте в нём ключ OneProvider целиком, без кавычек.
4. Экран входа остаётся, хотя переменные заданы в .claude/settings.json проекта: этот блок читается после первого запуска, поставьте переменные в shell или в ~/.claude/settings.json.

# macOS / Linux: что реально задано
env | grep -E 'ANTHROPIC_(BASE_URL|AUTH_TOKEN|API_KEY)' | sed -E 's/(sk-.{4}).*/\1.../'
grep -nE 'ANTHROPIC_(AUTH_TOKEN|API_KEY)' ~/.zshrc ~/.bashrc 2>/dev/null

Нужно ли логиниться в ChatGPT для Codex CLI?

Нет. Codex CLI читает OPENAI_BASE_URL и OPENAI_API_KEY из окружения. Когда обе переменные указывают на OneProvider — Codex полностью обходит ChatGPT-вход и ходит на наш эндпоинт. Поэтому экран авторизации можно пропустить.

Если мешает токен от прошлой сессии или экспорт в shell-rc:

unset OPENAI_API_KEY
rm -f ~/.codex/auth.lock
# затем заново экспортируйте значения из redeem-страницы и перезапустите codex
export OPENAI_BASE_URL="https://api.oneprovider.dev/v1"
export OPENAI_API_KEY="sk-..."
codex

Подробнее — на странице Codex (OpenAI) .

Нужен ли VPN? Есть региональные ограничения?

VPN не нужен — региональных ограничений у OneProvider нет. Эндпоинт api.oneprovider.dev доступен по всему миру и не геоблокирует трафик.

Более того, VPN/VLESS-прокси часто ломают подключение к API двумя путями:

• SSE-стриминг буферизуется внутри прокси — стрим обрывается посреди токена.
• HTTP/2 + ALPN сбивается на ретранслирующих узлах — клиент видит connection reset.

Если ловите оборванный стрим, connection reset или таймауты, временно отключите VPN/VLESS и повторите. С нашей стороны стрим не буферизуется.

Ошибка парсинга JSON в конфиге (или ошибка 429)

Самая частая причина — «умные» кавычки (“ ”) в JSON-конфиге. Они появляются при копировании из мессенджера, Notion, Google Docs или браузера, где кавычки автозаменяются на типографские. Парсер JSON принимает только прямые ASCII-кавычки (").

Иногда такой битый конфиг проявляется не как «JSON parse error», а как 429: клиент принимает отсутствие ответа за rate-limit. Лечится одинаково:

• Замените все “ ” на " вручную.
• Копируйте конфиг прямо из этой документации — там кавычки уже правильные.
• Проверяйте файл через cat -v config.json или jq . config.json — оба покажут невалидный байт.

# Быстрая проверка: jq упадёт на первой кривой кавычке
jq . ~/.claude/settings.json
# Авто-замена умных кавычек на прямые (макрос для sed)
sed -i.bak $'s/[\u201c\u201d]/"/g' ~/.claude/settings.json

Матрица симптомов

Диагностические однострочники

Если матрица не подошла под ваш случай, соберите три улики:

# 1. Подтвердить досягаемость + авторизацию
curl -sS -o /dev/null -w "HTTP %{http_code} total %{time_total}s\n" \
https://api.oneprovider.dev/v1/models -H "x-api-key: $ANTHROPIC_API_KEY"
# 2. Воспроизвести падающий вызов с -v (verbose-заголовки)
curl -sv https://api.oneprovider.dev/v1/messages \
-H "x-api-key: $ANTHROPIC_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "content-type: application/json" \
-d '{"model":"claude-sonnet-5-5","max_tokens":32,"messages":[{"role":"user","content":"hi"}]}'
# 3. Проверить текущий баланс (он же виден в кабинете: бот @oneprovider_robot или app.oneprovider.dev)
curl -s https://api.oneprovider.dev/v1/dashboard/balance \
-H "Authorization: Bearer $ANTHROPIC_API_KEY"

Когда эскалировать

Пришлите три вывода выше + первые 8 символов ключа + UTC-таймштамп в @Oneproviderhelpbot . Этого хватит, чтобы мы нашли ваш запрос в логах за минуты. См. Получить поддержку — что нам не нужно (и о чём мы никогда не спрашиваем).