Устранение неполадок
Найдите решения распространенных проблем с установкой и использованием Claude Code.
Распространенные проблемы установки
Проблемы с разрешениями в Linux
При установке Claude Code с помощью npm вы можете столкнуться с ошибками разрешений, если ваш глобальный префикс npm недоступен для записи пользователем (например, /usr
или /usr/local
).
Рекомендуемое решение: Создание префикса npm, доступного для записи пользователем
Самый безопасный подход — настроить npm для использования директории в вашей домашней папке:
Это решение рекомендуется, потому что оно:
- Избегает изменения разрешений системных директорий
- Создает чистое, выделенное местоположение для ваших глобальных npm пакетов
- Следует лучшим практикам безопасности
Восстановление системы: Если вы выполнили команды, которые изменили владельца и разрешения системных файлов или подобное
Если вы уже выполнили команду, которая изменила разрешения системных директорий (например, sudo chown -R $USER:$(id -gn) /usr && sudo chmod -R u+w /usr
) и ваша система теперь сломана (например, если вы видите sudo: /usr/bin/sudo must be owned by uid 0 and have the setuid bit set
), вам нужно будет выполнить шаги восстановления.
Метод восстановления Ubuntu/Debian:
-
Во время перезагрузки удерживайте SHIFT для доступа к меню GRUB
-
Выберите “Advanced options for Ubuntu/Debian”
-
Выберите опцию режима восстановления
-
Выберите “Drop to root shell prompt”
-
Перемонтируйте файловую систему как доступную для записи:
-
Исправьте разрешения:
-
Переустановите затронутые пакеты (опционально, но рекомендуется):
-
Перезагрузитесь:
Альтернативный метод восстановления с Live USB:
Если режим восстановления не работает, вы можете использовать live USB:
-
Загрузитесь с live USB (Ubuntu, Debian или любой дистрибутив Linux)
-
Найдите раздел вашей системы:
-
Смонтируйте раздел вашей системы:
-
Если у вас есть отдельный загрузочный раздел, смонтируйте его тоже:
-
Выполните chroot в вашу систему:
-
Следуйте шагам 6-8 из метода восстановления Ubuntu/Debian выше
После восстановления вашей системы следуйте рекомендуемому решению выше для настройки префикса npm, доступного для записи пользователем.
Проблемы с автообновлением
Если Claude Code не может обновляться автоматически, это может быть связано с проблемами разрешений в директории вашего глобального префикса npm. Следуйте рекомендуемому решению выше, чтобы исправить это.
Если вы предпочитаете отключить автообновление, вы можете
установить переменную окружения DISABLE_AUTOUPDATER
в 1
Разрешения и аутентификация
Повторяющиеся запросы разрешений
Если вы постоянно одобряете одни и те же команды, вы можете разрешить конкретным инструментам
работать без одобрения, используя команду /permissions
. См. документацию по разрешениям.
Проблемы с аутентификацией
Если вы испытываете проблемы с аутентификацией:
- Выполните
/logout
для полного выхода из системы - Закройте Claude Code
- Перезапустите с
claude
и завершите процесс аутентификации снова
Если проблемы продолжаются, попробуйте:
Это удаляет вашу сохраненную информацию аутентификации и принуждает к чистому входу в систему.
Производительность и стабильность
Высокое использование CPU или памяти
Claude Code разработан для работы с большинством сред разработки, но может потреблять значительные ресурсы при обработке больших кодовых баз. Если вы испытываете проблемы с производительностью:
- Используйте
/compact
регулярно для уменьшения размера контекста - Закрывайте и перезапускайте Claude Code между основными задачами
- Рассмотрите добавление больших директорий сборки в ваш файл
.gitignore
Команда зависает или замерзает
Если Claude Code кажется неотзывчивым:
- Нажмите Ctrl+C, чтобы попытаться отменить текущую операцию
- Если не отвечает, вам может потребоваться закрыть терминал и перезапустить
Клавиша ESC не работает в терминалах JetBrains (IntelliJ, PyCharm и т.д.)
Если вы используете Claude Code в терминалах JetBrains и клавиша ESC не прерывает агента как ожидается, это, вероятно, связано с конфликтом привязок клавиш с стандартными ярлыками JetBrains.
Чтобы исправить эту проблему:
- Перейдите в Settings → Tools → Terminal
- Нажмите гиперссылку “Configure terminal keybindings” рядом с “Override IDE Shortcuts”
- В привязках клавиш терминала прокрутите вниз до “Switch focus to Editor” и удалите этот ярлык
Это позволит клавише ESC правильно функционировать для отмены операций Claude Code вместо захвата действием PyCharm “Switch focus to Editor”.
Получение дополнительной помощи
Если вы испытываете проблемы, не рассмотренные здесь:
- Используйте команду
/bug
в Claude Code для прямого сообщения о проблемах в Anthropic - Проверьте репозиторий GitHub на известные проблемы
- Выполните
/doctor
для проверки состояния вашей установки Claude Code