Не работает -- что делать?

10 типичных проблем и простые решения. Спойлер: почти всё решается одной фразой агенту.

fix_01 - Агент завис
_x
Агент не отвечает / завис
Нажми Ctrl + C -- это команда прерывания. Агент остановится, и ты сможешь написать заново. Если повторяется -- закрой терминал и открой заново.
fix_02 - Не устанавливается
_x
Ошибка при установке Claude Code
Скорее всего не установлен Node.js -- "движок", на котором работает Claude Code.

Что делать: зайди на nodejs.org, скачай версию LTS (помечена "Recommended"), установи как обычную программу. Закрой терминал, открой заново и попробуй установить Claude Code ещё раз.
fix_03 - Нет доступа
_x
Permission denied / Нет доступа
Система не даёт выполнить команду -- нет прав доступа.

На Windows: закрой терминал, нажми правой кнопкой на его иконку и выбери "Запуск от имени администратора".

На Mac/Linux: добавь sudo перед командой. Система попросит пароль -- при вводе он не отображается, просто набери и нажми Enter.
fix_04 - Не то делает
_x
Агент делает не то что я прошу
Агент -- не телепат. Чем точнее задача -- тем лучше результат.

Плохо: "Сделай красиво"
Хорошо: "Сделай шапку сайта с логотипом слева и тремя ссылками справа. Фон белый, текст чёрный, шрифт Inter."

Добавь контекст:
-- Для кого этот проект?
-- Какой результат ты ожидаешь?
-- Что точно НЕ нужно делать?
Если агент пошёл не туда -- не терпи. Скажи "Стоп. Это не то. Мне нужно..." и опиши заново.
fix_05 - Код не запускается
_x
Код не запускается
Не пытайся разобраться в ошибке сам. Скопируй текст ошибки (красные строки в терминале) и скажи агенту:

"Код не запускается. Вот ошибка: [вставь ошибку]. Исправь."

Агент прочитает, поймёт причину и исправит. Красный текст -- не страшно, просто копируй и отправляй.
fix_06 - Контекст кончился
_x
Закончился контекст / сессия слишком длинная
У агента есть "память" -- окно контекста. Чем дольше разговор, тем больше он забывает начало. Это нормально.

Что делать: начни новую сессию. Просто закрой текущую (Ctrl + C) и запусти claude заново.

Правило: одна задача = одна сессия. Не пытайся за один разговор сделать весь проект.
Перед закрытием скажи агенту "сохрани текущее состояние" -- он сделает коммит, и в новой сессии ничего не потеряется.
fix_07 - Зациклился
_x
Агент зациклился, повторяет одно и то же
Бывает -- агент пробует один подход снова и снова.

Что делать: напиши прямо: "Стоп. Ты зациклился. Этот подход не работает. Давай по-другому." И опиши что не получается. Если продолжает -- начни новую сессию, чистый контекст помогает.
fix_08 - Деплой
_x
Не могу задеплоить / опубликовать
Деплой -- это когда твой проект становится доступен в интернете. Звучит сложно, но агент сделает почти всё сам.

Что делать: скажи агенту:

"Помоги мне опубликовать этот сайт на Vercel" (для сайтов)
"Помоги задеплоить бота на Railway" (для ботов и серверов)

Он даст пошаговые инструкции и поможет на каждом шаге.
Vercel -- бесплатен для простых сайтов. Railway -- бесплатен для старта. Платить не нужно пока проект маленький.
fix_09 - Непонятно
_x
Агент предлагает что-то непонятное
Не соглашайся на то, что не понимаешь. Это главное правило работы с AI.

Что делать: скажи:

"Объясни простыми словами что ты предлагаешь и зачем. Я не программист."

Хороший агент объяснит так, чтобы было понятно. Если всё ещё непонятно -- спрашивай ещё раз. Это нормально.
Ты -- заказчик. Агент -- исполнитель. Исполнитель должен объяснить что делает и почему. Не наоборот.
fix_10 - Всё сломалось
_x
Всё совсем сломалось
Без паники. Есть два варианта:

Вариант 1: откатить изменения. Если ты делал сохранения через git, набери:
git checkout .
Это вернёт все файлы к последнему сохранению (коммиту). Как "загрузить последнее сохранение" в игре.

Вариант 2: начать заново. Создай новую папку и начни проект с нуля. Иногда это быстрее, чем чинить. Скажи агенту что хочешь получить -- и он создаст всё заново.
Именно поэтому git важен. Если ты сохранялся -- всегда можно откатить. Если нет -- вариант 2.
Универсальное решение
Если проблемы нет в этом списке -- просто опиши её агенту. Скопируй ошибку, опиши что пытался сделать и что получилось. В 90% случаев агент разберётся сам. Если не разберётся -- напиши ведущему практикума.