​
Распространенные проблемы установки

​
Проблемы установки в Windows: ошибки в WSL

Вы можете столкнуться со следующими проблемами в WSL:

Проблемы обнаружения ОС/платформы: Если вы получаете ошибку во время установки, WSL может использовать Windows npm. Попробуйте:

  • Выполните npm config set os linux перед установкой
  • Установите с помощью npm install -g @anthropic-ai/claude-code --force --no-os-check (НЕ используйте sudo)

Ошибки “Node не найден”: Если вы видите exec: node: not found при запуске claude, ваша среда WSL может использовать установку Node.js для Windows. Вы можете подтвердить это с помощью which npm и which node, которые должны указывать на пути Linux, начинающиеся с /usr/, а не с /mnt/c/. Чтобы исправить это, попробуйте установить Node через менеджер пакетов вашего дистрибутива Linux или через nvm.

​
Проблемы установки в Linux и Mac: ошибки разрешений или команда не найдена

При установке Claude Code с помощью npm проблемы с PATH могут препятствовать доступу к claude. Вы также можете столкнуться с ошибками разрешений, если ваш глобальный префикс npm недоступен для записи пользователем (например, /usr или /usr/local).

​
Рекомендуемое решение: Нативная установка Claude Code

Claude Code имеет нативную установку, которая не зависит от npm или Node.js.

Нативный установщик Claude Code в настоящее время находится в бета-версии.

Используйте следующую команду для запуска нативного установщика.

macOS, Linux, WSL:

# Установить стабильную версию (по умолчанию)
curl -fsSL https://claude.ai/install.sh | bash

# Установить последнюю версию
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Установить конкретный номер версии
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

Windows PowerShell:

# Установить стабильную версию (по умолчанию)
irm https://claude.ai/install.ps1 | iex

# Установить последнюю версию
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

# Установить конкретный номер версии
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

Эта команда устанавливает подходящую сборку Claude Code для вашей операционной системы и архитектуры и добавляет символическую ссылку на установку в ~/.local/bin/claude.

Убедитесь, что у вас есть каталог установки в системном PATH.

​
Альтернативное решение: Миграция на локальную установку

В качестве альтернативы, если Claude Code будет работать, вы можете мигрировать на локальную установку:

claude migrate-installer

Это перемещает Claude Code в ~/.claude/local/ и настраивает псевдоним в конфигурации вашей оболочки. Для будущих обновлений sudo не требуется.

После миграции перезапустите вашу оболочку, а затем проверьте вашу установку:

В macOS/Linux/WSL:

which claude  # Должен показать псевдоним на ~/.claude/local/claude

В Windows:

where claude  # Должен показать путь к исполняемому файлу claude

Проверьте установку:

claude doctor # Проверить состояние установки

​
Разрешения и аутентификация

​
Повторяющиеся запросы разрешений

Если вы постоянно одобряете одни и те же команды, вы можете разрешить конкретным инструментам работать без одобрения, используя команду /permissions. См. документацию по разрешениям.

​
Проблемы аутентификации

Если вы испытываете проблемы с аутентификацией:

  1. Выполните /logout для полного выхода из системы
  2. Закройте Claude Code
  3. Перезапустите с помощью claude и снова завершите процесс аутентификации

Если проблемы сохраняются, попробуйте:

rm -rf ~/.config/claude-code/auth.json
claude

Это удаляет вашу сохраненную информацию аутентификации и принуждает к чистому входу в систему.

​
Производительность и стабильность

​
Высокое использование CPU или памяти

Claude Code разработан для работы с большинством сред разработки, но может потреблять значительные ресурсы при обработке больших кодовых баз. Если вы испытываете проблемы с производительностью:

  1. Регулярно используйте /compact для уменьшения размера контекста
  2. Закрывайте и перезапускайте Claude Code между основными задачами
  3. Рассмотрите добавление больших каталогов сборки в ваш файл .gitignore

​
Команда зависает или замерзает

Если Claude Code кажется неотзывчивым:

  1. Нажмите Ctrl+C, чтобы попытаться отменить текущую операцию
  2. Если не отвечает, вам может потребоваться закрыть терминал и перезапустить

​
Клавиша ESC не работает в терминалах JetBrains (IntelliJ, PyCharm и т.д.)

Если вы используете Claude Code в терминалах JetBrains и клавиша ESC не прерывает агента, как ожидается, это, вероятно, связано с конфликтом привязок клавиш с горячими клавишами JetBrains по умолчанию.

Чтобы исправить эту проблему:

  1. Перейдите в Настройки → Инструменты → Терминал
  2. Нажмите гиперссылку “Настроить привязки клавиш терминала” рядом с “Переопределить горячие клавиши IDE”
  3. В привязках клавиш терминала прокрутите вниз до “Переключить фокус на редактор” и удалите эту горячую клавишу

Это позволит клавише ESC правильно функционировать для отмены операций Claude Code вместо захвата действием PyCharm “Переключить фокус на редактор”.

​
Получение дополнительной помощи

Если вы испытываете проблемы, не рассмотренные здесь:

  1. Используйте команду /bug в Claude Code для прямого сообщения о проблемах в Anthropic
  2. Проверьте репозиторий GitHub на предмет известных проблем
  3. Выполните /doctor для проверки состояния вашей установки Claude Code
  4. Спросите Claude напрямую о его возможностях и функциях - Claude имеет встроенный доступ к своей документации