Открыть
Блог

Claude Code не запускается в Windows: PATH и установка

Определить, найден ли исполняемый файл, и проверить запуск в новом терминале.

2 минOpenCowork

Короткий ответ

Если Claude Code не запускается в Windows, сначала выясните, находит ли терминал команду. Сообщение о неизвестной команде относится к установке и поиску исполняемого файла. Ошибка после запуска программы требует другого разбора.

Эта инструкция касается командной строки. Проблемы вкладки Code в настольном приложении и недоступность Claude.ai не нужно смешивать с поиском команды в PowerShell.

Зафиксируйте точный этап

Что происходитНаправление проверки
Команда не найденаУстановка и PATH
Найдена неожиданная версияНесколько установок
Программа запускается, вход отклонёнУчётная запись и доступ
Вход успешен, задача зависаетРаботающая сессия и её состояние

Перед изменениями запишите текст сообщения, тип терминала и способ установки. Не подставляйте в обращение команду из чужого руководства, если фактически устанавливали программу иначе.

В официальном руководстве установки и входа есть отдельные маршруты для PATH, конфликтующих установок и ошибок Windows. Сверяйте актуальную процедуру с ним.

Минимальная проверка в PowerShell

Команда «Get-Command claude -All» показывает, какие соответствующие команды видит текущий PowerShell. Она не устанавливает программу и не меняет файлы. Отсутствие результата — наблюдение о текущей среде, а не доказательство того, что на диске нигде нет установленного файла.

Если команда найдена, проверьте её происхождение и затем версию штатным способом «claude --version». При успешном запуске для дальнейшей диагностики предусмотрена «claude doctor». Не публикуйте диагностический вывод целиком, пока не проверили его на личные пути и другие чувствительные сведения.

После согласованного изменения PATH откройте новый терминал. Уже открытое окно может продолжать использовать прежнюю среду. Не добавляйте в PATH произвольную папку только потому, что там найден файл с подходящим названием.

Чего не делать при неизвестной причине

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

Не отключайте защитные средства и не меняйте общую политику выполнения скриптов ради одного сообщения. Если ограничение связано с корпоративной настройкой, передайте администратору точную ошибку и выбранный официальный способ установки.

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

Как оформить результат и продолжить задачу

Сохраните короткую запись: «найденная команда», «версия», «исходная ошибка», «проверка», «результат». Этого достаточно, чтобы следующий специалист видел установленную границу проблемы.

В OpenCowork разрешённые заметки можно превратить в план расследования: «Упорядочи факты, отдели запуск от входа и выполнения задачи. Не выдумывай команды исправления и не предлагай удалять рабочие материалы». Черновик проверяет специалист.

Для отказа входа после успешного запуска используйте разбор 403 в Claude Code. Общая карта разных продуктов находится в статье о сбоях Claude.

От практики к рабочей задаче

Как OpenCowork выполняет задачи с документами и сверками
Claude Code не запускается в Windows: PATH и установка | OpenCowork