Устранение неполадок Claude Code
Главное при устранении неполадок Claude Code — убедиться, что он получил конфигурацию Claude / Anthropic. Не используйте в Claude Code адреса, совместимые с OpenAI, названия моделей Codex или ключи Gemini.
Что проверить в первую очередь?
| Пункт проверки | Как проверить | Почему это важно |
|---|---|---|
| Целевой инструмент | Убедитесь, что вы настраиваете именно Claude Code, а не Codex или Gemini CLI | У разных инструментов различаются файлы конфигурации, протоколы и названия моделей. |
| Протокол провайдера | В панели управления или руководстве явно указаны Claude, Anthropic и Claude Code | Провайдеры, предоставляющие только OpenAI-совместимый интерфейс, могут не поддерживать Claude Code |
| Тип ключа | Используйте ключ, предназначенный для Claude / Anthropic | Если тип ключа неверный, это сразу приведет к ошибке 401 или сбою аутентификации |
| Состояние терминала | После смены конфигурации перезапустите терминал и повторите проверку | Старый терминал может продолжать использовать переменные окружения или конфигурацию, действовавшие до переключения |
Частые ошибки
| Симптом | Что проверить в первую очередь | Решение |
|---|---|---|
| Команда запускается, но запрос завершается ошибкой | Применил ли Claude Code новую конфигурацию | Закройте текущее окно терминала, откройте его заново и отправьте короткий тестовый запрос. После переключения через CC-Switch не изменяйте эту же конфигурацию вручную одновременно. |
| 401 / Unauthorized | Тип и корректность ключа | Убедитесь, что вы используете ключ для Claude / Anthropic; не вставляйте OpenAI-совместимый ключ в Claude Code. При повторном копировании проверьте отсутствие лишних пробелов в начале и в конце. |
| 404 / model not found | Название модели Claude | Укажите название в точности так, как оно указано в панели провайдера для моделей Claude, не меняя регистр, дефисы или номера версий. |
| Connection timeout или нет ответа | Claude Base URL | Проверьте адрес API Claude / Anthropic в панели управления; провайдеры, предоставляющие только OpenAI-совместимые адреса, могут не поддерживать Claude Code. |
| После переключения по-прежнему используется старый провайдер | Сессия терминала и источник конфигурации | Перезапустите терминал и протестируйте снова; если изменения не применились, убедитесь, что текущий провайдер в CC-Switch был применен к Claude Code. |
Минимальный тест
При тестировании сначала отправьте короткий контрольный вопрос, убедитесь в получении ответа и только затем переходите к реальному проекту.
Минимальный тест Claude Code
claude "Please reply only: Claude Code configuration test successful"Шаблон обращения в поддержку
При обращении к провайдеру укажите следующие данные
Tool: Claude Code System version: Provider dashboard Base URL: Model ID / model name: Exact error: I have checked: no spaces in the Key / balance is sufficient / model name copied exactly / Base URL copied from the dashboard / terminal reopened