Troubleshooting

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

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

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

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

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

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

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

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

Если использование памяти остаётся высоким после этих шагов, запустите /heapdump, чтобы записать два файла на ~/Desktop: снимок кучи JavaScript с именем <session-id>.heapsnapshot и разбор памяти с именем <session-id>-diagnostics.json. Claude Code скрывает команду из меню команд; введите её полностью. На Linux без папки Desktop файлы записываются в вашу домашнюю директорию.

Команда также выводит сводку в разговор, показывая размер резидентного набора, кучу JS, буферы массивов и неучтённую нативную память, плюс любые индикаторы утечек, которые она обнаружила, такие как высокий темп роста памяти или необычно высокое количество открытых дескрипторов. Сводка указывает, находится ли большая часть памяти в куче JS, которую захватывает снимок, или в нативной памяти, которую он не захватывает.

Сделайте одно из двух с выводом:

• Сообщите об этом: откройте GitHub issue и прикрепите только файл -diagnostics.json, который содержит статистику, лежащую в основе выведённой сводки, и не содержит содержимого разговора или учётных данных
• Исследуйте это сами: если сводка говорит, что большая часть памяти находится в куче JS, откройте файл .heapsnapshot в Chrome DevTools в разделе Memory → Load и отсортируйте по retained size, чтобы увидеть, что удерживает память

Если сводка говорит, что большая часть памяти находится в нативной памяти, снимок не может её показать; включите индикаторы утечек сводки в ваш отчёт вместо этого.

Большие таблицы обрезаются в терминале

Таблица Markdown с более чем 200 строками отображает первые 200 строк, за которыми следует строка … N more rows not shown. Отображение ограничено только визуально: полная таблица остаётся в разговоре, и /copy копирует каждую строку. Для таблицы, которая слишком велика для чтения в терминале, попросите Claude записать её в файл вместо этого. До версии v2.1.208 Claude Code отображал каждую строку, поэтому возобновление сеанса, содержащего очень большую таблицу, могло зависнуть при её повторном отображении.

Автоматическое сжатие останавливается с ошибкой thrashing

Если вы видите 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, если более ранний разговор больше не нужен

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

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

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

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

Искажённый или повреждённый текст во встроенном терминале редактора

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

Колесо мыши прокручивает по одной строке в полноэкранном рендеринге

При полноэкранном отображении Claude Code прокручивает сам разговор, а не оставляет это вашему терминалу. Если каждый поворот колеса перемещает меньше строк, чем вы хотите, запустите /scroll-speed, чтобы увеличить количество строк на один поворот и сохранить это, или установите переменную окружения CLAUDE_CODE_SCROLL_SPEED, кроме как в терминале IDE JetBrains, где Claude Code применяет собственную обработку прокрутки и ни один из них не вступает в силу. Смотрите Mouse wheel scrolling для значений, которые каждый принимает.

Чтобы двигаться быстрее без изменения скорости, нажмите PgUp и PgDn, чтобы прокручивать половину экрана за раз. Чтобы вернуть прокрутку вашему собственному буферу обратного хода терминала, запустите /tui default, чтобы переключиться на классический рендерер.

Команды буфера обмена, такие как `pbcopy`, не работают внутри sandbox

Когда sandboxing включён, утилиты буфера обмена, такие как pbcopy, xclip и wl-copy, могут не достичь системного буфера обмена из внутри изолированной команды Bash, оставляя ваш буфер обмена неизменённым после того, как Claude передаёт текст в них.

Чтобы поместить вывод Claude в ваш буфер обмена, попросите Claude вывести содержимое в его ответе, затем запустите /copy. /copy записывает в буфер обмена из самого процесса Claude Code, а не из изолированной команды, поэтому sandboxing не блокирует это. Он может копировать один блок кода вместо всего ответа, и он также записывает то, что он скопировал, в файл и выводит путь, что даёт вам резервный вариант, когда запись в буфер обмена не достигает вашего терминала, например через SSH.

Чтобы позволить переданной команде достичь буфера обмена напрямую, добавьте pbcopy *, wl-copy * или xclip * в excludedCommands, чтобы команда работала вне изоляции.

Скопированный текст не достигает вашего локального буфера обмена через SSH

Когда Claude Code работает на удалённой машине через SSH, он не может запустить инструмент буфера обмена на вашей локальной машине. Вне tmux, когда вы выбираете текст в полноэкранном отображении или запускаете /copy, Claude Code отправляет текст в ваш терминал как последовательность escape-кода OSC 52 вместо этого. Ваш терминал решает, поместить ли его в буфер обмена. /copy сообщает Copied to clipboard независимо от того, достиг ли текст, и вне tmux уведомление о выборе читает sent N chars via OSC 52.

Некоторые терминалы не действуют на OSC 52. iTerm2 игнорирует это, пока вы не включите Settings > General > Selection > Applications in terminal may access clipboard, и macOS Terminal.app не поддерживает это.

Чтобы получить текст без OSC 52:

• Удерживайте клавишу собственного выбора вашего терминала, пока вы перетаскиваете, затем копируйте с помощью обычного сочетания клавиш вашего терминала, такого как Cmd+C. Клавиша — это Fn в Terminal.app и Option в iTerm2. Keep native text selection перечисляет её для других терминалов.
• Установите CLAUDE_CODE_DISABLE_MOUSE=1 на удалённой машине, чтобы ваш терминал обрабатывал выбор для всего сеанса.

Проблемы с поиском и обнаружением

Если инструмент 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, либо в вашем окружении, либо в блоке env вашего settings.json:

{
  "env": {
    "USE_BUILTIN_RIPGREP": "0"
  }
}

Чтобы подтвердить, что переключение вступило в силу, запустите claude doctor в вашем терминале и проверьте, что строка Search показывает путь вашего системного ripgrep вместо OK (bundled).

Медленные или неполные результаты поиска в 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 для проверки статуса MCP сервера
2. Используйте команду /feedback в Claude Code, чтобы сообщить о проблемах непосредственно в Anthropic
3. Проверьте репозиторий GitHub на известные проблемы
4. Спросите Claude напрямую о его возможностях и функциях. Claude имеет встроенный доступ к своей документации.

По вопросам учётной записи, выставления счетов или подписки обратитесь в службу поддержки Anthropic: войдите на claude.ai (пользователи Console: platform.claude.com), нажмите на ваши инициалы в нижнем левом углу и выберите Получить помощь. См. Как получить поддержку для полного процесса, включая информацию о том, кто может связаться с представителем поддержки на каждом плане.