Недавно делал проект с Claude API — и от обилия ошибок голова пошла кругом. Провозился несколько дней и собрал все «грабли», на которые наступил, — надеюсь, это поможет тем, кого мучает то же самое.
Error 401 Unauthorized
Эта ошибка встречается чаще всего: в восьми-девяти случаях из десяти проблема в API‑ключе. Проверьте, полностью ли скопирован ключ, особенно не потеряли ли префикс sk-ant- в начале. Кроме того, если ключ истёк или был отозван, будет та же ошибка — просто сгенерируйте новый в панели Anthropic.
Error 429 Rate Limit Exceeded
Слишком частые запросы — сработало ограничение по частоте. На бесплатном аккаунте можно отправлять только 60 запросов в минуту, на платном лимит выше. Решения:
- добавить задержку в коде, например интервал 1 секунду между запросами
- использовать стратегию экспоненциальной задержки (exponential backoff) для повторных попыток
- повысить тариф, чтобы увеличить лимиты
Error 529 Overloaded
Серверы Claude перегружены — в таком случае достаточно подождать несколько минут и попробовать снова. Если это часто повторяется, можно попробовать пользоваться в непиковые часы, избегая времени максимальной нагрузки в североамериканском часовом поясе.
