Часто встречающиеся ошибки и проверка подключения
401 / invalid_api_key
Убедитесь, что запрос отправляется на наш сайт Base URL, а Authorization использует Bearer sk-.... Проверьте, полный ли ключ, не был ли он отозван и правильна ли группа, к которой он принадлежит.
404 / model not found
Пошагово проверьте ID модели, адрес протокола и группу ключа. OpenAI Compatible обычно использует адрес с /v1; Claude Code обычно использует корневой адрес без /v1.
403 или блокировка системой безопасности
Укажите явный User-Agent для скрипта, чтобы снизить вероятность блокировки пустым User-Agent на шлюзе. Не пытайтесь обойти ограничения частыми повторными попытками.
Медленные запросы
Сначала протестируйте короткими вопросами. Если короткие вопросы обрабатываются быстро, а сложные задачи медленно, обычно это связано с обработкой контекста или выводом модели; если медленные даже короткие вопросы, проверьте локальную сеть, соединение и состояние сервиса.
Подключение успешно, но клиент не изменился
Полностью выйдите из клиента и откройте его заново. Проверьте, нет ли нескольких конфигурационных файлов, старые переменные окружения не перезаписывают ли новую конфигурацию, или CC Switch действительно не активировал целевого поставщика.
Контрольный список перед запуском
- Проверьте Key, Base URL и модель с помощью минимального запроса.
- Настройте тайм-аут, повторные попытки, параллельность и лимит бюджета.
- Подготовьте резервное соединение или резервную модель.
- Анонимизируйте логи, не записывайте полный ключ.