Troubleshooting

Исправьте высокое использование CPU или памяти, зависания, auto-compact thrashing и проблемы поиска в Claude Code, и найдите нужную страницу для других проблем.

Эта страница охватывает проблемы производительности, стабильности и поиска после того, как Claude Code запущен. Для других проблем начните со страницы, которая соответствует тому, где вы застряли:

Если вы не уверены, какой применяется, запустите /doctor внутри Claude Code для автоматической проверки вашей установки, параметров, MCP servers и использования контекста. Если claude вообще не запускается, запустите claude doctor из вашей оболочки вместо этого.

Performance and stability

Эти разделы охватывают проблемы, связанные с использованием ресурсов, отзывчивостью и поведением поиска.

High CPU or memory usage

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

1. Используйте /compact регулярно, чтобы уменьшить размер контекста
2. Закройте и перезагрузите Claude Code между основными задачами
3. Рассмотрите добавление больших директорий сборки в ваш файл .gitignore
4. Перезагрузитесь с помощью claude --safe-mode, чтобы проверить, является ли источником plugin, MCP server или hook. Это отключает все настройки на время сеанса; если использование снизится, см. Debug your configuration, чтобы найти, какой именно

Если использование памяти остаётся высоким после этих шагов, запустите /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 на цикл, который не делает прогресс.

Чтобы восстановиться:

1. Попросите Claude прочитать большой файл в меньших фрагментах, таких как конкретный диапазон строк или функция, вместо всего файла
2. Запустите /compact с фокусом, который удаляет большой вывод, например /compact keep only the plan and the diff
3. Переместите работу с большим файлом на subagent, чтобы она работала в отдельном окне контекста
4. Запустите /clear, если более ранний разговор больше не нужен

Command hangs or freezes

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

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

Перезагрузка не теряет вашу беседу. Запустите claude --resume в той же директории, чтобы продолжить сеанс.

Garbled or corrupted text in an editor's integrated terminal

Если символы отображаются как прямоугольники, размазанные линии или неправильные глифы при запуске Claude Code в интегрированном терминале VS Code, Cursor или Devin Desktop, причиной, вероятно, является GPU-рендерер терминала. Запустите /terminal-setup внутри Claude Code, чтобы установить terminal.integrated.gpuAcceleration на "off", или установите это вручную в настройках вашего редактора и перезагрузите окно. Смотрите Terminal configuration для других настроек, которые записывает /terminal-setup.

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. Поиск всё ещё функционирует, но возвращает меньше результатов, чем на собственной файловой системе.

Решения:

1. Отправляйте более конкретные поиски: уменьшите количество файлов, которые ищутся, указав директории или типы файлов: "Search for JWT validation logic in the auth-service package" или "Find use of md5 hash in JS files".

2. Переместите проект на файловую систему Linux: если возможно, убедитесь, что ваш проект находится на файловой системе Linux (/home/) вместо файловой системы Windows (/mnt/c/).

3. Используйте нативный Windows вместо этого: рассмотрите запуск Claude Code нативно на Windows вместо WSL для лучшей производительности файловой системы.

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

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

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