Troubleshooting
Исправьте высокое использование CPU или памяти, зависания, auto-compact thrashing и проблемы поиска в Claude Code, и найдите нужную страницу для других проблем.
Эта страница охватывает проблемы производительности, стабильности и поиска после того, как Claude Code запущен. Для других проблем начните со страницы, которая соответствует тому, где вы застряли:
| Симптом | Перейти к |
|---|---|
command not found, ошибка установки, проблемы PATH, EACCES, ошибки TLS |
Troubleshoot installation and login |
Циклы входа, ошибки OAuth, 403 Forbidden, "organization disabled", учётные данные Bedrock/Vertex/Foundry |
Troubleshoot installation and login |
| Параметры не применяются, hooks не срабатывают, MCP servers не загружаются | Debug your configuration |
API Error: 5xx, 529 Overloaded, 429, ошибки валидации запроса |
Error reference |
model not found или you may not have access to it |
Error reference |
| Расширение VS Code не подключается или не обнаруживает Claude | VS Code integration |
| Плагин JetBrains или IDE не обнаружена | JetBrains integration |
| Высокое использование CPU или памяти, медленные ответы, зависания, поиск не находит файлы | Performance and stability ниже |
Если вы не уверены, какой применяется, запустите /doctor внутри Claude Code для автоматической проверки вашей установки, параметров, MCP servers и использования контекста. Если claude вообще не запускается, запустите claude doctor из вашей оболочки вместо этого.
Performance and stability
Эти разделы охватывают проблемы, связанные с использованием ресурсов, отзывчивостью и поведением поиска.
High CPU or memory usage
Claude Code разработан для работы с большинством сред разработки, но может потреблять значительные ресурсы при обработке больших кодовых баз. Если вы испытываете проблемы с производительностью:
- Используйте
/compactрегулярно, чтобы уменьшить размер контекста - Закройте и перезагрузите Claude Code между основными задачами
- Рассмотрите добавление больших директорий сборки в ваш файл
.gitignore
Если использование памяти остаётся высоким после этих шагов, запустите /heapdump, чтобы записать снимок кучи JavaScript и разбор памяти на ~/Desktop. На Linux без папки Desktop файлы записываются в вашу домашнюю директорию.
Разбор показывает размер набора резидентов, кучу JS, буферы массивов и неучтённую собственную память, что помогает определить, находится ли рост в объектах JavaScript или в собственном коде. Чтобы проверить удерживающие элементы, откройте файл .heapsnapshot в Chrome DevTools под Memory → Load. Прикрепите оба файла при сообщении о проблеме с памятью на GitHub.
Auto-compaction stops with a thrashing error
Если вы видите Autocompact is thrashing: the context refilled to the limit..., автоматическое сжатие прошло успешно, но файл или вывод инструмента немедленно заполнили окно контекста несколько раз подряд. Claude Code останавливает повторные попытки, чтобы избежать траты вызовов API на цикл, который не делает прогресс.
Чтобы восстановиться:
- Попросите Claude прочитать большой файл в меньших фрагментах, таких как конкретный диапазон строк или функция, вместо всего файла
- Запустите
/compactс фокусом, который удаляет большой вывод, например/compact keep only the plan and the diff - Переместите работу с большим файлом на subagent, чтобы она работала в отдельном окне контекста
- Запустите
/clear, если более ранний разговор больше не нужен
Command hangs or freezes
Если Claude Code кажется неотзывчивым:
- Нажмите Ctrl+C, чтобы попытаться отменить текущую операцию
- Если неотзывчив, вам может потребоваться закрыть терминал и перезагрузить
Перезагрузка не теряет вашу беседу. Запустите claude --resume в той же директории, чтобы продолжить сеанс.
Search and discovery issues
Если инструмент Search, упоминания @file, пользовательские агенты или пользовательские skills не находят файлы, встроенный двоичный файл ripgrep может не работать на вашей системе. Установите пакет ripgrep вашей платформы и скажите Claude Code использовать его вместо этого:
brew install ripgrep
sudo apt install ripgrep
apk add ripgrep
pacman -S ripgrep
winget install BurntSushi.ripgrep.MSVC
Затем установите USE_BUILTIN_RIPGREP=0 в вашем окружении.
Slow or incomplete search results on WSL
Штрафы производительности чтения диска при работе с файловыми системами на WSL могут привести к меньшему количеству совпадений, чем ожидается, при использовании Claude Code на WSL. Поиск всё ещё функционирует, но возвращает меньше результатов, чем на собственной файловой системе.
Решения:
-
Отправляйте более конкретные поиски: уменьшите количество файлов, которые ищутся, указав директории или типы файлов: "Search for JWT validation logic in the auth-service package" или "Find use of md5 hash in JS files".
-
Переместите проект на файловую систему Linux: если возможно, убедитесь, что ваш проект находится на файловой системе Linux (
/home/) вместо файловой системы Windows (/mnt/c/). -
Используйте нативный Windows вместо этого: рассмотрите запуск Claude Code нативно на Windows вместо WSL для лучшей производительности файловой системы.
Get more help
Если вы испытываете проблемы, не охватываемые здесь:
- Запустите
/doctor, чтобы проверить здоровье установки, валидность параметров, конфигурацию MCP и использование контекста в одном проходе - Используйте команду
/feedbackв Claude Code, чтобы сообщить о проблемах непосредственно в Anthropic - Проверьте репозиторий GitHub на известные проблемы
- Спросите Claude напрямую о его возможностях и функциях. Claude имеет встроенный доступ к своей документации.