Эти десять проблем составляют большинство запросов в поддержку по установке и аутентификации Claude Code. Каждый пункт включает наиболее надежное решение.
1. claude: команда не найдена сразу после установки.
Установщик добавил claude в ваш PATH, но текущая оболочка еще не подхватила это. Откройте новый терминал или выполните source ~/.zshrc (или ~/.bashrc). На Windows закройте и снова откройте PowerShell.
2. npm install завершается с ошибкой EACCES / отказано в доступе.
Обычно это означает, что установка была запущена с sudo, или ваш глобальный каталог npm принадлежит root. Не используйте sudo. Вместо этого используйте установщик curl или исправьте префикс npm командой npm config set prefix ~/.npm-global и добавьте этот каталог bin в ваш PATH.
3. "Версия Node не поддерживается" или молчаливый сбой при запуске.
Claude Code требует Node 18 или более поздней версии. Проверьте версию командой node -v. Если она старше, установите текущую версию через nvm install --lts или используйте установщик curl, который поставляется с собственной средой выполнения и полностью избегает этой проблемы.
4. WSL: claude запускает Windows Node вместо Linux Node.
Windows PATH попадает в WSL и переопределяет nvm. Добавьте ваш Linux node в начало PATH в ~/.bashrc: export PATH="$HOME/.nvm/versions/node/$(nvm current)/bin:$PATH"
5. Установщик зависает или не работает в корпоративной сети.
Хост загрузки (storage.googleapis.com) вероятно заблокирован. Сначала установите прокси командой export HTTPS_PROXY=http://your-proxy:port, затем повторно запустите установщик. Если это невозможно, попросите у вашей IT-команды автономный пакет.
6. SELF_SIGNED_CERT_IN_CHAIN или другие ошибки TLS.
Ваша компания внедряет собственный сертификат. Укажите Node на корпоративный пакет CA: export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem Добавьте это в профиль вашей оболочки, чтобы это сохранилось.
7. /login открывает браузер, но терминал никогда не завершает работу ("Ожидание аутентификации…").
Обычно это означает, что обратный вызов localhost заблокирован, что часто происходит при удаленном SSH, в devcontainers или за строгим брандмауэром. Используйте вместо этого ручной поток: скопируйте URL, напечатанный в терминале, завершите вход в любом браузере, затем вставьте возвращенный код обратно в терминал.
8. "Не аутентифицирован" несмотря на то, что вы установили ANTHROPIC_API_KEY.
Есть три распространенные причины: ключ был экспортирован в другой оболочке (выполните echo $ANTHROPIC_API_KEY для проверки), вы ранее запустили /login и сеанс OAuth имеет приоритет (сначала выполните /logout), или ключ является ключом Console, но ваша организация требует вместо этого входа SSO.
9. Bedrock / Vertex: "Не удалось загрузить учетные данные."
Claude Code использует стандартные SDK поставщиков, поэтому исправление такое же, как для любого инструмента AWS/GCP CLI. Для Bedrock подтвердите, что aws sts get-caller-identity работает и AWS_REGION установлен на регион, где включена ваша модель. Для Vertex подтвердите, что gcloud auth application-default login был запущен и GOOGLE_CLOUD_PROJECT установлен.
10. Установка и аутентификация прошли успешно, но каждый запрос завершается с ошибкой 403 / "модель недоступна."
Ваша учетная запись существует, но не имеет доступа к модели, которую запрашивает Claude Code. Для корпоративных мест убедитесь, что ваше место активно в параметрах администратора вашей организации. На Bedrock или Vertex убедитесь, что конкретная модель Claude включена в этом регионе или проекте. Как быстрое решение выполните /model и выберите модель, к которой вы знаете, что имеете доступ.
Все еще застряли?
Выполните claude doctor из вашей обычной оболочки (не из сеанса Claude). Это выведет диагностический отчет, который вы можете приложить к билету поддержки.