Claude Code

ИИ-ассистент в терминале. Понятно даже если вы никогда не программировали.

Арам
@lazy_aram
Про ИИ в реальной работе: автоматизации, кейсы, инструменты. Без воды.
Telegram
Этот гайд написал сам Claude Code. Арам попросил: «сделай гайд для команды» — и вот он. Ни одна строчка не была написана человеком вручную.

Что такое Claude Code?

Claude Code — это ИИ-помощник, который работает прямо на вашем компьютере. Вы пишете ему задачу обычным русским языком, а он сам находит нужные файлы, вносит изменения, запускает команды.

Если проще
Вы знаете ChatGPT? Там вы описываете проблему, он даёт совет, а дальше вы сами. Claude Code — это как если бы ChatGPT сидел за вашим компьютером: он сам видит файлы, сам вносит правки, сам запускает всё что нужно. А вы просто говорите, что хотите.

Что он умеет

Искать и менять файлы
Вы говорите «найди где в проекте настраивается отправка писем» — он находит. Говорите «поменяй текст кнопки» — он меняет. Не нужно самому искать и открывать файлы.
Запускать программы и команды
Может запустить сервер, установить что-то, обновить проект — всё через тот же диалог.
Работать с базами данных
Может выполнять запросы к базе данных — например, посчитать количество пользователей или найти конкретный заказ. Делает это через специальные программы в терминале (psql, mysql и т.д.).
Писать код
На любом языке. Вы описываете что нужно — он пишет. Не нужно уметь программировать самому, но полезно понимать, что происходит.
Анализировать картинки
Можно скинуть ему скриншот ошибки или макет дизайна — он увидит и поймёт.
Объяснять
«Что делает этот файл?», «Как работает эта часть проекта?», «Объясни простыми словами» — он ответит на вашем уровне.

Где он работает

Claude Code работает в терминале — это программа с текстовым интерфейсом, без кнопок и окошек. Вы пишете текст, он отвечает текстом. Выглядит как мессенджер, только в чёрном окне.

Что такое терминал
Терминал (ещё его называют «командная строка» или «консоль») — это программа, где вы общаетесь с компьютером текстом вместо мышки. На Mac он называется Terminal (найдите через Spotlight: Cmd+Пробел, наберите «Terminal»). На Windows — PowerShell или Windows Terminal.

Быстрый старт

От нуля до первого результата — пошагово.

Шаг 1. Откройте терминал

Перед вами откроется чёрное (или тёмное) окно с мигающим курсором. Это и есть терминал — сюда вводятся команды.

Шаг 2. Установите Claude Code

Скопируйте эту строку, вставьте в терминал и нажмите Enter:

npm install -g @anthropic-ai/claude-code
Если появилась ошибка «npm: command not found» — значит на компьютере нет Node.js. Это бесплатная программа, которая нужна для установки. Скачайте её с nodejs.org (выберите версию LTS), установите, закройте и заново откройте терминал, попробуйте команду ещё раз.

Шаг 3. Запустите

В терминале напишите:

claude

При первом запуске откроется браузер с окном авторизации. Войдите в свой аккаунт на claude.ai (или создайте новый). После этого Claude готов к работе.

Шаг 4. Попробуйте!

Просто напишите что-нибудь обычным языком и нажмите Enter:

привет, какие файлы есть в текущей папке?

Или посложнее:

найди в ~/my-project где отправляются уведомления

Или попросите создать инструкцию для проекта:

/init

Как закрыть Claude Code

Нажмите Ctrl+D или напечатайте /exit. Чтобы потом вернуться — снова напишите claude в терминале.

Как вернуться к прошлому разговору

Обычно каждый запуск claude — это новый диалог с чистого листа. Но если хотите продолжить:

КомандаЧто делает
claudeНовый диалог
claude -cПродолжить последний диалог (как будто не закрывали)
claude --resumeПоказать список прошлых диалогов — выбираете нужный

Подписки и стоимость

Claude Code не бесплатный — он работает через подписку на claude.ai. Вот какие варианты есть:

Pro
$20 в месяц (~1800 руб.)
  • Доступ к Claude Code
  • Есть ограничение на использование — когда закончится, скорость ответов замедлится или переключится на упрощённую модель
  • Ограничение сбрасывается каждые несколько часов
  • Для знакомства и небольших задач
Team
$30 за человека в месяц
  • Для команд — у каждого свой аккаунт и свой лимит
  • Общая панель управления для руководителя

Что происходит, когда лимит заканчивается?

Claude не перестаёт работать. Вместо этого:

Аналогия
Это как мобильный интернет. Когда основной пакет кончился — интернет не пропал, но стал медленнее. Через какое-то время лимит обновляется.

Можно ли использовать один аккаунт на нескольких людей?

Нельзя. Один аккаунт = один человек. Делиться логином и паролем запрещено правилами — аккаунт могут заблокировать. Если нужно нескольким людям — берите план Team (каждый получает свой логин) или покупайте отдельные подписки.

От чего зависит расход лимита?

Как ставить задачи

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

Примеры: плохо vs хорошо

Размыто
сделай чтобы работало
Конкретно
кнопка «Сохранить» на странице профиля не работает — посмотри почему
Размыто
напиши запрос
Конкретно
напиши SQL-запрос: количество новых пользователей по дням за последний месяц
Размыто
поменяй текст
Конкретно
в файле templates/welcome.html поменяй заголовок на «Добро пожаловать!»

Формула

Что нужно сделать + Где это находится + Зачем (если не очевидно)

Не нужно описывать всё сразу

Диалог — это нормально. Можно уточнять по ходу, как в переписке:

Вы: найди где в проекте отправляются уведомления
Claude: нашёл — файл services/notifications.py...
Вы: добавь туда отправку в Telegram
Claude: сделал, вот что я изменил...

Можно ссылаться на файлы через @

Если знаете, где находится файл — поставьте @ перед путём. Claude его сразу подхватит:

посмотри @src/auth/login.py — почему ошибка при входе?

После @ работает автодополнение — начните вводить путь и нажмите Tab.

Можно скидывать картинки

Скриншот ошибки, макет дизайна, фото доски — Claude увидит и поймёт:

Лайфхак: дайте Claude способ себя проверить

Качество работы сильно вырастает, когда Claude может сам проверить результат:

Обычно
напиши функцию валидации email
Лучше
напиши функцию валидации email. Протестируй: user@mail.com — ok, "invalid" — ошибка. Запусти тесты

Кнопки и команды

Команды начинаются с / — просто введите их в строку ввода Claude и нажмите Enter.

Самые важные команды

КомандаЧто делаетКогда использовать
/clearОчистить диалогПеред каждой новой задачей. Это как начать разговор заново — Claude будет работать быстрее и точнее.
/compactСжать диалогКогда задача одна, но разговор стал очень длинным. Claude «перескажет» диалог в короткую версию и продолжит.
/initСоздать инструкцию для проектаОдин раз при первом знакомстве с проектом. Создаст файл CLAUDE.md — подробнее во вкладке CLAUDE.md.
/helpСправкаЕсли забыли какую-то команду

Клавиши

Всё работает прямо во время диалога с Claude — не нужно ничего устанавливать.

КлавишаЧто делает
EnterОтправить сообщение
Shift + EnterНовая строка (если хотите написать несколько строк, не отправляя)
EscОстановить Claude (если он делает что-то не то). Ничего не сломается — он просто остановится.
Esc Esc (дважды)Откатить назад — можно вернуть файлы или диалог к предыдущему состоянию. Как Ctrl+Z, но мощнее.
Ctrl + CПрервать текущий ввод
Ctrl + DВыйти из Claude Code
Ctrl + VВставить картинку из буфера обмена
Ctrl + LОчистить экран (диалог при этом сохраняется)
TabПринять подсказку (иногда Claude предлагает следующий вопрос серым текстом)
Shift + TabПереключить режим работы (подробнее ниже)

Три режима работы

Переключаются нажатием Shift + Tab. В правом нижнем углу будет написано, какой режим сейчас активен.

Обычный режим (рекомендуется для начала)
Claude спрашивает ваше разрешение перед каждым действием — прежде чем изменить файл или выполнить команду. Вы видите, что именно он собирается сделать, и решаете: разрешить или нет.
Auto-accept
Claude правит файлы сам, без вопросов. Быстрее, но рискованнее — используйте, только когда уверены в задаче и понимаете, что происходит.
Plan mode (безопасный)
Claude только смотрит и анализирует, но ничего не меняет. Идеально для разведки: «объясни как работает эта часть проекта», «что будет если мы поменяем X?». Можно спокойно изучать незнакомый проект без риска что-то сломать.

Как работают разрешения

В обычном режиме, когда Claude хочет что-то сделать, вы увидите такое сообщение:

Claude хочет выполнить: Edit файл src/app.py

> 1. Да
  2. Да, и больше не спрашивай для этого
  3. Нет (Esc)

Просто выберите цифру и нажмите Enter. Или нажмите Esc чтобы отказать.

Если нажали «Нет» — ничего страшного. Claude не сломается и не обидится. Он попробует другой подход или спросит, что именно вы хотите.

CLAUDE.md — память проекта

Что это
Представьте: на работу пришёл новый сотрудник. Вы же не будете каждое утро объяснять ему заново, как устроен проект? Вы дадите ему документ «Как у нас тут всё работает». CLAUDE.md — это такой документ, но для ИИ. Claude Code читает его каждый раз при запуске и сразу понимает контекст.

Как создать

Запустите Claude Code в папке вашего проекта и введите:

/init

Claude сам изучит проект — файлы, настройки, зависимости — и создаст CLAUDE.md автоматически. Вам останется только проверить и дополнить.

Что там обычно написано

# Мой проект
Интернет-магазин на Python + React

## Как запустить
docker compose up -d

## Правила
- Все изменения — через отдельные ветки
- Не трогать файлы .env (там пароли)
- Перед отправкой кода прогнать тесты: pytest

Что писать самому

Claude сам поймёт структуру кода. В CLAUDE.md полезно добавить то, что из кода не видно:

Три уровня (для продвинутых)

~/.claude/
  CLAUDE.md ← глобальный: работает для ВСЕХ ваших проектов

~/проект/
  CLAUDE.md ← основной: для этого проекта, виден всей команде
  .claude/
    CLAUDE.md ← личный: только для вас, коллеги не увидят

Продвинутые возможности

Этот раздел можно пропустить, если вы только начинаете. Вернитесь сюда, когда освоитесь с основами.

Субагенты — помощники Claude

Аналогия
Представьте начальника, который вместо того чтобы всё делать сам, поручает задачи помощникам. Один ищет информацию, другой проверяет качество, третий делает сложную работу. Каждый приносит только результат — начальник не тонет в деталях. Субагенты работают так же: Claude делегирует им подзадачи.

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

Можно создавать своих субагентов

Через команду /agents или файлы в папке .claude/agents/. Например, можно создать субагента-ревьюера, который проверяет код на ошибки:

# .claude/agents/reviewer.md
---
name: reviewer
description: Проверяет код на качество и безопасность
tools: Read, Glob, Grep
---
Ты — ревьюер кода. Проверяй качество
и безопасность.

После этого можно попросить Claude: «используй reviewer для проверки модуля авторизации».

Навыки (Skills) — ваши шаблоны задач

Если вы часто делаете одно и то же (деплой, ревью, создание отчёта), можно превратить это в команду. Навыки — это файлы с инструкциями, которые вызываются через /имя-навыка.

Пример: навык для деплоя

Создаёте файл .claude/skills/deploy/SKILL.md:

---
name: deploy
description: Деплой приложения
---
Выполни деплой:
1. Запусти тесты
2. Собери проект
3. Отправь на сервер

Теперь в Claude Code можно написать /deploy — и он выполнит все шаги автоматически.

Встроенные навыки, которые уже есть:

КомандаЧто делает
/simplifyПроверяет последние изменения — нет ли лишнего, можно ли упростить
/loop 5m /командаПовторяет команду каждые N минут. Полезно для мониторинга.

Хуки — автоматические действия

Хуки — это действия, которые выполняются автоматически при определённых событиях. Например:

Настраиваются в файле .claude/settings.json. Если интересно — попросите Claude: «настрой хук, который форматирует файлы после изменений».

Git — база

Git — это система, которая запоминает все изменения в проекте. Как машина времени для файлов: можно посмотреть, что менялось, кто менял, и откатиться к любому моменту в прошлом.

Аналогия
Вы знаете, как Google Docs показывает историю изменений документа? Git делает то же самое, но для всех файлов проекта одновременно. Каждое «сохранение» (коммит) — это снимок всего проекта в определённый момент.

Главные понятия (их всего три)

Коммит — сохранение
Как сохранение в игре. Вы фиксируете текущее состояние проекта с комментарием: «исправил ошибку в авторизации», «добавил кнопку экспорта». Можно в любой момент вернуться к любому коммиту.
Ветка — черновик
Параллельная копия проекта. Основная ветка называется main — это «чистовик». Для каждой задачи вы создаёте свою ветку (черновик), работаете в ней, и когда всё готово — вливаете обратно в main. Так вы не рискуете сломать рабочую версию.
Push / Pull — синхронизация
Push — отправить свои изменения на общий сервер (чтобы коллеги увидели). Pull — скачать изменения коллег к себе. Как синхронизация файлов в облаке.
Не нужно запоминать команды Git. Просто попросите Claude: «закоммить мои изменения», «создай ветку для задачи Х», «покажи что изменилось». Он выполнит нужные команды сам и объяснит, что произошло.
Команды Git для любопытных
КомандаЧто делаетАналогия
git statusЧто изменилось?«Что я натворил?»
git add файлОтметить для сохраненияПоложить товар в корзину
git commitСохранитьОформить заказ
git pushОтправить на серверЗагрузить в облако
git pullСкачать от коллегСинхронизировать
git checkout -b имяНовая веткаОткрыть черновик
Как устроена работа с сервером

Проект хранится на сервере (GitHub или GitLab) — это общий «источник правды». Каждый скачивает копию к себе, работает в ней, и отправляет изменения обратно.

Сервер (GitHub)
☁ Общий проект
↓ скачать         ↓ скачать
□ Вы            □ Коллега
↑ отправить     ↑ отправить

Главное правило: не работайте напрямую в ветке main. Всегда создавайте свою ветку. Или просто попросите Claude: «создай ветку для моей задачи».

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

Claude — мощный инструмент, и как с любым инструментом, нужно знать технику безопасности. Ничего сложного:

Не соглашайтесь на то, что не понимаете
Когда Claude просит разрешение на действие — прочитайте, что именно он хочет сделать. Не нажимайте «1» не глядя. Если непонятно — выберите «Нет» и спросите: «объясни, что эта команда делает».
Не трогайте файлы .env
В этих файлах хранятся пароли, ключи доступа и другие секреты. Не читайте, не меняйте, не удаляйте. Если Claude предлагает их изменить — откажите.
Не отправляйте код на сервер (push) без согласования
Push отправляет ваши изменения в общий проект, где их увидят все. Прежде чем пушить — убедитесь, что ваша работа проверена и одобрена.
Работайте в своей ветке
Скажите Claude: «создай новую ветку для моей задачи». Так ваши изменения будут изолированы и не повлияют на работу коллег.
Используйте Plan mode для изучения
Если вы в незнакомом проекте и боитесь что-то сломать — нажмите Shift+Tab чтобы включить Plan mode. В этом режиме Claude только читает и объясняет, но ничего не меняет.
Если что-то пошло не так — не паникуйте
Нажмите Esc Esc — откроется меню отката. Можно вернуть файлы и диалог к предыдущему состоянию. Или просто скажите Claude: «отмени последние изменения». В Git почти невозможно потерять данные безвозвратно.

Частые вопросы

Я что-то сломал, что делать?

Не паникуйте. Два варианта:

  • Нажмите Esc Esc — откроется меню отката. Выберите, к какому моменту вернуться.
  • Скажите Claude: «отмени последние изменения» или «верни файл к последнему коммиту».
Claude предлагает что-то странное — что делать?

Выберите «Нет» (нажмите Esc) — Claude не обидится. Потом можно:

  • Переформулировать задачу конкретнее
  • Спросить: «почему ты предлагаешь именно это?»
  • Дать больше контекста о том, чего вы хотите
Это бесплатно?

Нет. Нужна подписка на claude.ai — от $20/мес. Подробности во вкладке «Подписки».

Claude помнит прошлые разговоры?

По умолчанию — нет. Каждый запуск claude начинает с чистого листа. Но:

  • claude -c — продолжить последний диалог
  • claude --resume — выбрать из списка прошлых диалогов
  • Файл CLAUDE.md Claude читает каждый раз — это его «долгосрочная память» о проекте
Можно работать с базой данных?

Да. Claude выполняет команды типа psql или mysql через терминал. Запросы на чтение (SELECT) — без проблем. Запросы на изменение (INSERT, UPDATE, DELETE) — только если вы уверены и понимаете, что делаете.

Claude завис — что делать?

Нажмите Esc — Claude остановится. Если не помогает — Ctrl+C. В крайнем случае закройте окно терминала, откройте заново и напишите claude -c чтобы вернуться к диалогу.

Claude может ошибиться?

Да, и это нормально. Claude — очень умный инструмент, но он не идеален. Всегда проверяйте результат, особенно если дело касается важных данных или отправки кода в общий проект.

Нужно ли уметь программировать?

Нет. Claude понимает обычный русский язык. Вы описываете что нужно — он делает. Но чем лучше вы понимаете что происходит, тем эффективнее сможете с ним работать. Для начала достаточно прочитать раздел «Git-база» — там объяснены основы простыми словами.

Мне кажется, я трачу слишком много лимита — что делать?

Три главных совета:

  • Используйте /clear — начинайте каждую новую задачу с чистого диалога. Длинные диалоги расходуют больше.
  • Будьте конкретны — чем точнее описана задача, тем меньше Claude тратит на уточнения и поиск.
  • Используйте /compact — если задача одна, но разговор затянулся. Claude сожмёт историю и продолжит.