Если что-то не работает
Ключ, модель, окружение или сеть: проверяем по порядку.
Проверка за несколько шагов
- В кабинете проверьте баланс; в ключах — статус, группу, срок и лимиты ключа.
- Проверьте адрес: Codex —
https://claud.sale/v1; Claude Code —https://claud.sale. Не добавляйте второй/v1. - Полностью закройте и снова откройте терминал, VS Code или приложение после настройки. В WSL выполните настройку внутри WSL.
- Проверьте версию:
codex --versionилиclaude --version. Обновление описано в инструкции вашей системы. - Отправьте короткий запрос из примеров API. Сравните время и результат с историей использования.
Сообщения и причины
| Ошибка | Что проверить |
|---|---|
| 401 / invalid API key | Полноту ключа, отсутствие пробелов, правильную переменную окружения и статус ключа. Повторите настройку. Не используйте пароль от кабинета вместо API-ключа. |
| 403 / insufficient balance | Баланс и лимит ключа. Большой запрос может требовать предоплату выше остатка. Если баланс достаточен, сохраните код ошибки и время — отказ может приходить со стороны маршрута. |
| 404 / model not found / model not allowed | Адрес endpoint, группу и точный идентификатор модели. Сверьте каталог. Каталог не гарантирует текущую доступность каждой модели. |
| 429 / 529 / too many requests | Остановите лишние параллельные сессии, подождите и повторите с паузой. Если есть Retry-After, учитывайте его. Быстрые бесконечные повторы увеличат нагрузку. |
| 502 / 503 / timeout | Повторите один короткий запрос после паузы. Проверьте другую модель той же группы. Сохраните время и идентификатор запроса, если ошибка повторяется. |
| HTTP 200, но нет текста | Поток может содержать ошибку уже после заголовков. Проверяйте текстовые события и завершение ответа. Один статус 200 не доказывает успешную генерацию. |
| Команда не найдена | Сначала установите официальный CLI, затем откройте новый терминал. Проверьте PATH по инструкции. Настройщик claud.sale сам CLI не устанавливает. |
Переменная не видна клиенту
Вместо печати секретного значения проверьте только наличие.
# Codex
[ -n "${CLAUDSALE_API_KEY:-}" ] && echo 'Ключ задан' || echo 'Ключ не задан'
# Claude Code
[ -n "${ANTHROPIC_AUTH_TOKEN:-}" ] && echo 'Ключ задан' || echo 'Ключ не задан'# Не выводит сам ключ
[bool]$env:CLAUDSALE_API_KEY
[bool]$env:ANTHROPIC_AUTH_TOKENСтарая вкладка терминала не получает переменные нового процесса. После изменения User environment в Windows закройте все окна приложения, запустите его заново; при необходимости выйдите из Windows и войдите снова. В VS Code Remote/WSL окружение удалённой стороны настраивается отдельно.
CLI работает, расширение — нет
Для Codex проверьте, что CLI и расширение читают один CODEX_HOME и config.toml, а процесс VS Code видит CLAUDSALE_API_KEY. Запуск code . из настроенного терминала помогает только после полного закрытия старого процесса VS Code.
Для Claude Code одной настройки ~/.claude/settings.json может быть недостаточно: расширение проверяет вход отдельно. Выполните шаг claudeCode.environmentVariables из инструкции Windows или Linux. Секрет храните в пользовательских настройках, не в репозитории.
Ответ начинается долго
Время до первого токена и полное время запроса — разные метрики. Длинный контекст, рассуждение и ожидание маршрута увеличивают задержку. Сначала проверьте короткую новую сессию; используйте потоковый ответ, чтобы видеть начало генерации. Не отправляйте много одинаковых запросов одновременно: каждый успешный повтор может тарифицироваться.
Для первого GPT-теста попробуйте gpt-5.6-sol, затем отдельно нужную модель. Для Claude — claude-sonnet-4-6 или claude-opus-5. Это варианты проверки, а не обещание постоянной скорости.
Вернуть прежние настройки
Повторно скачайте тот же настройщик и запустите с --restore в Bash или -Restore в PowerShell. Вернётся последний снимок, созданный этим настройщиком. Если запускали его несколько раз, последний снимок уже может содержать claud.sale. Перед восстановлением текущие изменённые файлы также сохраняются. Точные пути описаны в инструкции инструмента.
Что передать администратору
- Время ошибки с часовым поясом, инструмент и его версию.
- Windows или Linux, локально/WSL/Remote, имя модели и группу ключа.
- HTTP-код и короткое сообщение ошибки без секретов.
- Идентификатор запроса, если он виден в ответе или истории.
- Повторяется ли проблема на коротком запросе и другой модели той же группы.
Не отправляйте полный API-ключ, пароль, заголовок Authorization и файлы конфигурации с токеном. Имя ключа и последние несколько символов обычно достаточны для поиска.