# Разбираем реальную ошибку терминала по шагам

Канонический URL: https://zero2claude.ru/blog/debug-a-terminal-error
Дата: 2026-07-14
Теги: терминал, новичкам

Три самые частые ошибки терминала: читаем сообщение спокойно, понимаем смысл и чиним за минуту — без паники.

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

Давайте разберём три самые частые ошибки новичка. Не будем их бояться — будем читать. Когда вы научитесь понимать, что говорит терминал, чинить станет делом одной минуты.

<Cover src="/blog/debug-a-terminal-error.jpg" alt="Сообщение об ошибке в окне терминала" />

## command not found — «такой команды нет»

Терминал говорит: «я не знаю команды с таким именем». Чаще всего это просто опечатка.

- Проверьте написание: `sl` вместо `ls`, `gti` вместо `git` — глаз легко промахивается.
- Жмите Tab — терминал сам дописывает имя, и опечаток становится меньше.
- Если имя верное, но программы нет, её нужно установить. Например, сам Claude Code ставится командой `npm install -g @anthropic-ai/claude-code`, после чего запускается командой `claude`.

Смысл прост: имя в начале строки терминал не узнал. Исправьте имя — или установите то, что зовёте.

## No such file or directory — «нет такого файла»

Имя файла или папки терминал не нашёл там, где искал. Почти всегда вы просто находитесь не в той папке.

- `pwd` — покажет, в какой папке вы сейчас.
- `ls` — выведет, что в ней лежит на самом деле.
- `cd имя_папки` — перейти туда, где нужный файл.

Часто оказывается, что файл называется чуть иначе (`Notes.txt` и `notes.txt` — разные файлы, регистр важен) или лежит в соседней папке. Сначала посмотрите `ls`, потом повторяйте команду.

## permission denied — «нет доступа»

Файл есть, но система не даёт его запустить или изменить. У файлов есть права доступа, и у этого их не хватает. Посмотреть права можно подробным списком — `ls -la` покажет файлы вместе с их разрешениями. Разбор этой команды по частям мы собрали на странице [ls -la](/explain/ls-la).

Если это ваш скрипт, который нужно запустить, ему обычно не хватает права на исполнение — его добавляют командой `chmod +x file.sh`.

<Callout type="warning">
Если терминал советует «попробуйте с `sudo`» — не спешите. `sudo` запускает команду с правами администратора, и ошибиться так можно по-крупному. Сначала разберитесь, почему доступа нет: чаще проблема в том, что вы не в той папке или перепутали файл, а не в правах.
</Callout>

## Главный навык: читать, а не бояться

Заметили закономерность? В каждой ошибке терминал прямо сказал, чего ему не хватило — имени команды, файла или прав. Это не ругань, а подсказка.

Привыкните к одному порядку: прочитать строку до конца → понять, о чём она → проверить очевидное (`pwd`, `ls`, написание). Половину проблем вы решите сами, ещё до того, как откроете поиск.

А если ошибка незнакомая, можно показать её Claude Code прямо в терминале: он прочитает сообщение, объяснит человеческими словами, что пошло не так, и предложит, как починить. Но понимать смысл ошибки самому всё равно полезно — так вы проверяете, что совет верный, и не зависите от подсказок.

Ошибки в терминале — это нормальная часть работы, а не признак, что вы что-то делаете не так. Научитесь их читать — и чёрное окно перестанет пугать.

 [Начать курс с нуля](/learn)