Когда пишешь код и подключаешь ChatGPT, Claude или Gemini, больше всего бесит не логика, а внезапные сообщения: ошибка API‑ключа, 401, 403. Ты ведь просто скопировал и вставил — а оно не принимает, аж хочется клавиатуру в чай замочить. Я собрал свои набитые шишки в универсальный чек‑лист диагностики — обычно он покрывает большинство случаев (во многих документациях плагинов это тоже относят к категории «ошибка API‑ключа/проблемы сети»).
1 Сначала убедись, что ты используешь не пароль от чат‑аккаунта
API Key — это не пароль для входа и не Session веб‑версии. У OpenAI, Anthropic и Google у каждого своя консоль; ключ нужно создавать на соответствующей платформе, не пытайся «жёстко прикрутить» аккаунт ChatGPT Plus.
2 Ключ выглядит одинаково, но есть типичные ловушки при копировании
Самое частое — в конце лишний пробел или перенос строки, либо ты вставил ключ в конфиг в кавычках. Совет: вставь ключ в простой текст, сверь длину, затем скопируй обратно. Заодно проверь, не ошибся ли в имени переменной окружения (например, в OPENAI_API_KEY пропущена буква).
3 Права доступа и проект настроены неверно
С Gemini часто бывает так: API вроде включён, но проект не привязан к биллингу или не активирована нужная служба; с Claude доступ могут отклонять из‑за прав аккаунта/региональных политик. При 403 не упирайся в «ключ неправильный» — часто это означает «у тебя нет прав пользоваться».


