Эти десять проблем составляют большинство запросов в поддержку по установке и аутентификации Claude Code. Каждый пункт включает наиболее надежное решение.
1. claude: command not found сразу после установки.
Установщик добавил claude в ваш PATH, но текущая оболочка еще не подхватила это. Откройте новый терминал или выполните source ~/.zshrc (или ~/.bashrc). На Windows закройте и снова откройте PowerShell.
2. npm install завершается с ошибкой EACCES / отказано в доступе.
Обычно это означает, что установка была запущена с sudo или ваш глобальный каталог npm принадлежит root. Не используйте sudo. Вместо этого используйте встроенный установщик (curl -fsSL https://claude.ai/install.sh | bash) или исправьте префикс npm с помощью npm config set prefix ~/.npm-global и добавьте этот каталог bin в ваш PATH.
3. "Node version not supported" или молчаливый сбой при запуске.
Claude Code требует Node 18 или более поздней версии. Проверьте версию с помощью node -v. Если она старше, установите текущую версию через nvm install --lts или используйте встроенный установщик, который поставляется с собственной средой выполнения и полностью избегает этой проблемы.
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://proxy.example.com:port, затем повторно запустите установщик. Если это невозможно, попросите у вашей IT-команды автономный пакет.
6. SELF_SIGNED_CERT_IN_CHAIN или другие ошибки TLS.
Ваша компания внедряет собственный сертификат. Укажите Node на корпоративный пакет CA: export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem Добавьте его в профиль вашей оболочки, чтобы он сохранялся.
7. /login открывает браузер, но терминал никогда не завершает работу ("Waiting for authentication…").
Обычно это означает, что обратный вызов localhost заблокирован, что часто происходит при удаленном SSH, в devcontainers или за строгим брандмауэром. Используйте вместо этого ручной поток: скопируйте URL, напечатанный в терминале, завершите вход в любом браузере, затем вставьте возвращенный код обратно в терминал.
8. "Not authenticated" даже если вы установили ANTHROPIC_API_KEY.
Есть три распространенные причины: ключ был экспортирован в другой оболочке (выполните echo $ANTHROPIC_API_KEY для проверки), Claude Code еще не был указан доверять этому ключу (он запрашивает один раз при первом использовании; пока вы не одобрите, ANTHROPIC_API_KEY имеет приоритет над любым сеансом OAuth только после этого одобрения), или ключ является ключом Console, но ваша организация требует вместо этого входа SSO.
9. Bedrock / Vertex: "Could not load credentials."
Claude Code использует стандартные SDK поставщиков, поэтому исправление такое же, как для любого инструмента AWS/GCP CLI. Для Bedrock подтвердите, что aws sts get-caller-identity работает и AWS_REGION установлен на регион, где включена ваша модель. Для Vertex подтвердите, что gcloud auth application-default login был запущен и что ANTHROPIC_VERTEX_PROJECT_ID и CLOUD_ML_REGION установлены.
10. Установка и аутентификация прошли успешно, но каждый запрос завершается с ошибкой 403 / "model not available."
Ваша учетная запись существует, но не имеет доступа к модели, которую запрашивает Claude Code. Для Enterprise мест подтвердите, что ваше место активно в параметрах администратора вашей организации. На Bedrock или Vertex подтвердите, что конкретная модель Claude включена в этом регионе или проекте. Как быстрое решение выполните /model и выберите модель, к которой вы знаете, что у вас есть доступ.
Все еще застряли?
Выполните claude doctor из вашей обычной оболочки (не из сеанса Claude). Он выводит диагностический отчет, который вы можете приложить к билету поддержки. Полный список известных проблем см. в руководстве по устранению неполадок.