Перейти к содержимому
NEWЧат с 15 ИИ-моделями — попробуйте бесплатно / имейте совесть, когда будете делиться или копировать
>AISTUDY_
← Все инструменты

Claude Code

30 ошибок / CLI-агент от Anthropic

Типичные проблемы при установке и использовании Claude Code с решениями.

Установка

claude : имя "claude" не распознано как имя командлета

Платформа: Windows

Причина: Директория npm не добавлена в PATH после установки.

claude : имя "claude" не распознано как имя командлета, функции, файла сценария или выполняемой программы

Решение:

  1. Закройте и заново откройте терминал (PowerShell или Windows Terminal)
  2. Если не помогло — добавьте %USERPROFILE%\.local\bin\ в системные переменные среды (PATH)
  3. Проверьте: claude --version

Issues #3838, #3172

irm https://claude.ai/install.ps1 | iex — ошибка в CMD

Платформа: Windows

Причина: Команда irm (Invoke-RestMethod) — это командлет PowerShell. В CMD она не работает.

'irm' is not recognized as an internal or external command

Решение:

  1. Откройте PowerShell (не CMD) — найдите через поиск Windows
  2. Выполните: irm https://claude.ai/install.ps1 | iex
  3. Или установите через npm: npm install -g @anthropic-ai/claude-code
install.ps1 рапортует успех, но claude.exe не создан

Платформа: Windows

Причина: Скрипт установки не проверяет exit code внутренних команд и может завершиться «успешно» при фактической ошибке.

Installation complete!
# ...но claude.exe не существует

Решение:

  1. Проверьте наличие файла: Get-Command claude
  2. Переустановите через npm: npm install -g @anthropic-ai/claude-code
  3. Убедитесь, что Node.js >= 18: node --version

Issues #14942, #26880

syntax error near unexpected token '<'

Платформа: macOS / Linux

Причина: curl получает HTML-страницу (ошибка или блокировка по региону) вместо скрипта установки.

bash: line 1: syntax error near unexpected token '<'
bash: line 1: '<!DOCTYPE html>'

Решение:

  1. Проверьте, что curl получает скрипт, а не HTML: curl -sI https://claude.ai/install.sh
  2. Используйте VPN, если запрос блокируется по региону
  3. Альтернативная установка: npm install -g @anthropic-ai/claude-code
  4. На macOS: brew install --cask claude-code
Unsupported OS / Unsupported win32

Платформа: Windows

Причина: npm отказывается устанавливать пакет на неподдерживаемую платформу.

npm error notsup Unsupported platform for @anthropic-ai/claude-code
npm error notsup Valid OS: darwin, linux

Решение:

  1. Установите с флагом force: npm install -g @anthropic-ai/claude-code --force
  2. Или используйте WSL (Windows Subsystem for Linux) — рекомендуемый способ
  3. В WSL установка стандартная: npm install -g @anthropic-ai/claude-code

Issue #188

Claude Code requires Node.js version 18 or higher

Платформа: все

Причина: Установлена устаревшая версия Node.js.

error @anthropic-ai/claude-code: Claude Code requires Node.js version 18 or higher.
Your current version: v16.20.2

Решение:

  1. Обновите Node.js через nvm: nvm install 22 && nvm use 22
  2. Или через fnm: fnm install 22 && fnm use 22
  3. Проверьте версию: node --version
  4. Переустановите Claude Code: npm install -g @anthropic-ai/claude-code

Issue #8410

Платформенные проблемы

Error: Cannot find module './yoga.wasm'

Платформа: macOS / Linux

Причина: Неполная или повреждённая установка — отсутствует бинарный модуль yoga.wasm.

Error: Cannot find module './yoga.wasm'
Require stack:
  - .../node_modules/yoga-wasm-web/dist/index.js

Решение:

  1. Удалите текущую установку: npm uninstall -g @anthropic-ai/claude-code
  2. Очистите кеш npm: npm cache clean --force
  3. Переустановите: npm install -g @anthropic-ai/claude-code

Issues #1103, #7193

Illegal instruction

Платформа: Linux

Причина: CPU не поддерживает инструкции AVX — частая проблема на старых или бюджетных VPS.

$ claude
Illegal instruction (core dumped)

Решение:

  1. Проверьте поддержку AVX: grep -o 'avx[^ ]*' /proc/cpuinfo | head -1
  2. Если AVX нет — используйте VPS с современным CPU (KVM-виртуализация)
  3. Или попробуйте Node.js fallback-режим без нативных модулей

Issue #19904

Killed при установке (OOM)

Платформа: Linux VPS

Причина: Недостаточно оперативной памяти (менее 4 GB RAM) — процесс убивается OOM killer.

npm install -g @anthropic-ai/claude-code
Killed

Решение:

  1. Добавьте swap-файл:
fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
  1. Повторите установку: npm install -g @anthropic-ai/claude-code
  2. Для постоянного swap добавьте в /etc/fstab: /swapfile none swap sw 0 0
WSL: Node.js из Windows в PATH

Платформа: Windows (WSL)

Причина: WSL подхватывает виндовый Node.js вместо линуксового — бинарники несовместимы.

$ which node
/mnt/c/Program Files/nodejs/node

Решение:

  1. Установите Node.js внутри WSL: curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash - && sudo apt install -y nodejs
  2. Проверьте, что используется линуксовый node: which node должен показать /usr/bin/node
  3. Или отключите Windows PATH в WSL: добавьте в /etc/wsl.conf:
    [interop]
    appendWindowsPath = false

Issue #1232

TLS/SSL ошибки (UNABLE_TO_VERIFY_LEAF_SIGNATURE)

Платформа: все

Причина: Корпоративный прокси или файрвол подменяет SSL-сертификаты (MITM).

Error: unable to verify the first certificate
  code: 'UNABLE_TO_VERIFY_LEAF_SIGNATURE'

Решение:

  1. Получите корневой сертификат корпоративного прокси у IT-отдела
  2. Укажите путь к сертификату: export NODE_EXTRA_CA_CERTS="/path/to/corporate-cert.crt"
  3. Добавьте эту строку в ~/.bashrc или ~/.zshrc для постоянного эффекта
musl/glibc mismatch — ошибка динамической линковки

Платформа: Linux (Alpine, некоторые контейнеры)

Причина: Бинарник собран для glibc, а система использует musl (или наоборот).

Error loading shared library: libc.musl-x86_64.so.1
# или
/lib/x86_64-linux-gnu/libc.so.6: version 'GLIBC_2.28' not found

Решение:

  1. Определите тип libc: ldd --version или ldd /bin/ls
  2. Для Alpine (musl) — используйте Node.js Alpine-сборку
  3. Переустановите Claude Code: npm install -g @anthropic-ai/claude-code
  4. Или используйте дистрибутив с glibc (Ubuntu, Debian, Fedora)

Авторизация и запуск

dyld: cannot load / Abort trap: 6

Платформа: macOS

Причина: Версия macOS ниже 13.0 (Ventura) — бинарники требуют новых системных библиотек.

dyld: cannot load '/usr/lib/libSystem.B.dylib'
# или
Abort trap: 6

Решение:

  1. Проверьте версию macOS: sw_vers
  2. Обновите macOS до 13.0+ (Ventura или новее)
  3. Обновите Homebrew: brew update && brew upgrade
  4. Переустановите: npm install -g @anthropic-ai/claude-code
Claude Desktop перехватывает команду claude

Платформа: Windows

Причина: В PATH есть два исполняемых файла claude — от Claude Desktop и от Claude Code. Desktop перехватывает вызов.

$ claude
# Открывается Claude Desktop вместо CLI

Решение:

  1. Обновите Claude Desktop до последней версии — новые версии не конфликтуют
  2. Проверьте, какой файл вызывается: Get-Command claude | Format-List
  3. Если конфликт остался — измените порядок путей в PATH, поставив npm-путь выше

Issue #25075

Bun segfault на Windows

Платформа: Windows / WSL

Причина: Внутренний рантайм Bun в составе Claude Code крашится на некоторых конфигурациях Windows и WSL.

Segmentation fault (core dumped)
# или
panic: segfault at address 0x...

Решение:

  1. Обновите Claude Code до последней версии: npm install -g @anthropic-ai/claude-code@latest
  2. Если используете WSL — обновите ядро: wsl --update
  3. Проверьте, что нет конфликтов с глобальной установкой Bun

Issues #18567, #21875

Для начинающих

npm : термин 'npm' не распознан / npm: command not found

Платформа: все

Причина: Node.js не установлен или не добавлен в PATH.

npm : термин "npm" не распознан как имя командлета
# или
bash: npm: command not found

Решение:

  1. Скачайте и установите Node.js с nodejs.org (LTS-версию)
  2. При установке на Windows — отметьте галочку "Add to PATH"
  3. После установки перезапустите терминал (закройте и откройте заново)
  4. Проверьте: npm --version
  5. Альтернатива без npm — нативный установщик: curl -fsSL https://claude.ai/install.sh | bash
EACCES: permission denied при npm install -g

Платформа: macOS / Linux

Причина: Нет прав на запись в системную директорию npm (/usr/lib/node_modules).

npm ERR! Error: EACCES: permission denied, access '/usr/lib/node_modules'

Решение:

  1. Рекомендуемый способ — нативный установщик (не требует npm): curl -fsSL https://claude.ai/install.sh | bash
  2. Или настройте пользовательскую директорию npm:
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH
  1. Добавьте строку export PATH=~/.npm-global/bin:$PATH в ~/.bashrc или ~/.zshrc
  2. Повторите установку: npm install -g @anthropic-ai/claude-code
PowerShell vs CMD — путаница терминалов на Windows

Платформа: Windows

Причина: На Windows 4 разных терминала (PowerShell, CMD, Git Bash, WSL), и команды из документации могут работать только в конкретном.

# CMD не понимает PowerShell-команды:
'irm' is not recognized as an internal or external command
# PowerShell блокирует скрипты:
File cannot be loaded because running scripts is disabled on this system

Решение:

  1. Для установки откройте PowerShell: Win + поиск "PowerShell"
  2. Если скрипты отключены, выполните: Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
  3. Команды irm, iex работают только в PowerShell, не в CMD
  4. Для ежедневной работы с Claude Code рекомендуется Windows Terminal + PowerShell
Антивирус блокирует установку Claude Code

Платформа: Windows

Причина: Windows Defender, Kaspersky или Dr.Web удаляют claude.exe как ложное срабатывание (false positive).

# Установка проходит, но claude.exe исчезает
# Или антивирус показывает предупреждение о троянской программе

Решение:

  1. Добавьте директорию %APPDATA%\npm в исключения антивируса
  2. Для Windows Defender: Параметры → Обновление и безопасность → Безопасность Windows → Защита от вирусов → Исключения
  3. Переустановите Claude Code: npm install -g @anthropic-ai/claude-code
  4. Проверьте: claude --version

Авторизация и ключи

Invalid API key / Invalid bearer token

Платформа: все

Причина: Старый или невалидный ANTHROPIC_API_KEY в переменных окружения перебивает авторизацию по подписке.

API Error: 401 - Invalid API key

Решение:

  1. Проверьте наличие ключа: echo $ANTHROPIC_API_KEY (Linux/Mac) или echo %ANTHROPIC_API_KEY% (Windows)
  2. Если не пусто — удалите из ~/.bashrc, ~/.zshrc или системных переменных
  3. Выполните /logout в Claude Code, затем /login
  4. Перезапустите терминал и Claude Code
Корпоративный прокси блокирует подключение

Платформа: все

Причина: Корпоративный прокси или файрвол блокирует исходящие HTTPS-запросы к API Anthropic.

API Error: Connection error
# или
connect ECONNREFUSED 104.18.0.0:443

Решение:

  1. Настройте прокси: export HTTPS_PROXY=http://proxy.company.com:8080
  2. Для TLS-инспекции добавьте корпоративный сертификат: export NODE_EXTRA_CA_CERTS=/path/to/cert.pem
  3. Добавьте обе строки в ~/.bashrc или ~/.zshrc
  4. Обратитесь к IT-отделу для получения адреса прокси и сертификата
This organization has been disabled

Платформа: все

Причина: Переменная окружения содержит API-ключ от старой или заблокированной организации Anthropic.

API Error: 400 - This organization has been disabled

Решение:

  1. Удалите ANTHROPIC_API_KEY из окружения: unset ANTHROPIC_API_KEY
  2. Удалите из ~/.bashrc, ~/.zshrc или ~/.profile
  3. Войдите через подписку: /login
  4. Если используете API — создайте новый ключ на console.anthropic.com

Проблемы при использовании

Conversation too long — ошибка компактизации

Платформа: все

Причина: Контекстное окно переполнено — Claude Code не может сжать диалог.

Error: Error during compaction: Conversation too long

Решение:

  1. Используйте /compact превентивно — до 60-70% заполнения контекста
  2. Если ошибка уже произошла — выполните /clear для полного сброса
  3. Разбивайте большие задачи на подзадачи с отдельными сессиями
  4. Индикатор заполнения контекста виден в нижней части интерфейса
Утечка памяти — процесс node потребляет 10-120 ГБ RAM

Платформа: все (особенно Windows)

Причина: Долгая сессия без перезапуска приводит к утечке памяти в процессе node.

# Системный монитор показывает node.exe: 10+ GB RAM
# Компьютер начинает тормозить, swap забит

Решение:

  1. Перезапустите Claude Code (Ctrl+C и запустите заново)
  2. Не оставляйте сессию открытой на часы без использования
  3. Обновитесь до последней версии: npm install -g @anthropic-ai/claude-code@latest
  4. На Windows можно принудительно завершить: taskkill /f /im node.exe
Claude Code не видит изменений в файлах

Платформа: все

Причина: Claude Code работает со старой версией кода из контекста после внешних изменений (git pull, ручное редактирование).

# Claude предлагает изменения для уже несуществующего кода
# Или не замечает новые файлы после git pull

Решение:

  1. Выполните /clear для сброса контекста
  2. Явно попросите Claude перечитать нужный файл
  3. Для крупных изменений (merge, rebase) — начните новую сессию
MCP-сервер не подключается — spawn ENOENT

Платформа: все

Причина: В конфигурации MCP указан относительный путь к исполняемому файлу, который не находится в PATH.

MCP error: Failed to connect to server "my-server"
spawn npx ENOENT

Решение:

  1. Используйте полные пути в конфигурации MCP: узнайте путь через which npx или where npx
  2. Запустите диагностику: claude --mcp-debug
  3. Проверьте конфигурацию в ~/.claude/settings.json или .claude/settings.json проекта
  4. Убедитесь, что MCP-сервер установлен: npx -y @modelcontextprotocol/server-name
PreToolUse hook exited with code 1 — хук блокирует всё

Платформа: все

Причина: Хук без matcher срабатывает на каждый вызов инструмента и блокирует работу.

PreToolUse hook exited with code 1

Решение:

  1. Добавьте matcher в конфигурацию хука, чтобы ограничить срабатывание: "matcher": "Bash"
  2. Хук должен возвращать exit 0 для нерелевантных инструментов
  3. Проверьте конфигурацию в ~/.claude/settings.json
  4. Для отладки временно отключите хук, убрав его из settings.json
fatal: not a git repository — Claude Code без git

Платформа: все

Причина: Проект не инициализирован как git-репозиторий. Claude Code использует git для отслеживания изменений.

fatal: not a git repository (or any of the parent directories): .git

Решение:

  1. Инициализируйте git в директории проекта:
git init
git add .
git commit -m "init"
  1. Перезапустите Claude Code в этой директории
  2. Git обязателен — Claude Code использует его для безопасного отката изменений
VS Code — чёрный экран расширения Claude Code

Платформа: все (VS Code)

Причина: Конфликт расширений или повреждённый кеш Extension Host.

# Панель Claude Code показывает чёрный/пустой экран
# Extension host terminated unexpectedly

Решение:

  1. Выполните Reload Window: Ctrl+Shift+P → "Reload Window"
  2. Удалите кеш расширения: удалите папку ~/.vscode/extensions/anthropic*
  3. Отключите другие AI-расширения (GitHub Copilot, Cody, Continue) — они могут конфликтовать
  4. Переустановите расширение из VS Code Marketplace
Обновление сломалось — старая версия после npm update

Платформа: macOS

Причина: npm не может переименовать файлы из-за APFS или .DS_Store в директории пакета.

npm ERR! Error: EPERM: operation not permitted, rename
# claude --version показывает старую версию после обновления

Решение:

  1. Перейдите на нативный установщик (рекомендуется):
npm uninstall -g @anthropic-ai/claude-code
curl -fsSL https://claude.ai/install.sh | bash
  1. Или очистите кеш и переустановите: npm cache clean --force && npm install -g @anthropic-ai/claude-code@latest
  2. Проверьте версию: claude --version

Полезные ссылки

// Обсуждение

Можно писать анонимно. Укажите email, чтобы получать уведомления об ответах.