— и Claude Code установлен. Дальше начинается интересное: агент, который сам читает ваш проект, правит код и проверяет результат. Разбираем по шагам, как начать и не наступить на грабли, на которые наступают почти все.
01 · Определение
Что такое Claude Code

Claude Code — ИИ-агент для программирования от Anthropic. В отличие от чата, он сам читает файлы проекта, пишет и правит код, запускает команды и проверяет результат — вы ставите задачу и принимаете работу.
Разница с обычным чат-ботом примерно как между советчиком и сотрудником. Чат отвечает текстом, а код вы копируете сами. Claude Code работает прямо в вашей папке: открывает нужные файлы, вносит правки, запускает тесты, видит ошибку и чинит её, делает коммит в git.
Работать с ним можно в нескольких местах — везде один и тот же агент с теми же настройками:
Терминал
Команда claude в папке проекта. Самый полный набор возможностей, всё остальное построено вокруг него.
VS Code и JetBrains
Расширение показывает правки агента прямо в файлах, их удобно принимать по одной.
Приложение Claude
Вкладка Code в настольном приложении: те же возможности, но в окне с кнопками.
Claude Code в вебе
Агент работает в облаке с вашим репозиторием на GitHub, можно запускать задачи с телефона.
Для вайбкодера это главный инструмент, когда проект перерастает конструктор вроде Lovable: можно продолжить с тем же кодом, но без ограничений платформы.
- Находит, где в проекте живёт нужная логика, даже если вы не знаете названий файлов.
- Правит сразу несколько файлов: страницу, сервер и базу — согласованно.
- Запускает проект и тесты, читает ошибки и исправляет их сам.
- Пишет понятное описание изменений и делает коммит.
- Объясняет чужой или старый код простыми словами — удобно, когда проект достался от другого человека.
02 · Шаг 1
Как установить Claude Code

Claude Code ставится одной командой: на Mac, Linux и WSL — через curl, на Windows — через PowerShell. Нужна платная подписка Claude (Pro, Max, Team, Enterprise) или аккаунт для API: бесплатный тариф доступа не даёт.
# macOS, Linux, WSL curl -fsSL https://claude.ai/install.sh | bash # Windows (PowerShell) irm https://claude.ai/install.ps1 | iex # Проверить, что всё установилось claude doctor
Это официальный «родной» установщик: права администратора не нужны, обновления приходят сами в фоне. Если привыкли к менеджерам пакетов — есть Homebrew, WinGet и пакеты для Linux, но их обновлять придётся вручную.
Если после установки команда claude не находится, закройте и заново откройте терминал — установщик добавляет путь к программе, и старое окно об этом ещё не знает. claude doctor покажет, что не так.
Не любите терминал? Поставьте настольное приложение Claude и откройте вкладку Code, или расширение для VS Code. Но умение запустить пару команд в терминале окупится уже в первую неделю: так работают сервер, git и выкатка.
03 · Шаг 2
Как пользоваться Claude Code: первые 15 минут

Откройте папку проекта, наберите claude, попросите объяснить проект, создайте файл памяти командой /init и первую задачу дайте в режиме плана. Перед правками — коммит в git.
- 1
Откройте папку проекта
В терминале перейдите в папку (
cd путь/к/проекту) и наберитеclaude. При первом запуске откроется браузер для входа в аккаунт. - 2
Попросите объяснить проект
«Расскажи простыми словами, что это за проект и как он устроен». Так вы сразу увидите, правильно ли агент понял код, — и сами разберётесь.
- 3
Запустите /init
Команда создаст файл памяти
CLAUDE.md: описание проекта, команды запуска, правила. Агент читает его в начале каждой сессии. - 4
Первую задачу — в режиме плана
Shift+Tab переключает режимы. В режиме плана агент сначала расписывает, что собирается сделать, и ждёт вашего «да».
- 5
Сделайте коммит до и после
Попросите агента сохранить состояние в git перед правкой. Если что-то пойдёт не так — откат за секунды.
Пишите задачи так, как объясняли бы толковому новому сотруднику: что нужно, зачем и как понять, что получилось. «Добавь на страницу заказа поле „комментарий“, сохраняй его в базу и показывай в письме менеджеру. Проверь, что заказ без комментария тоже проходит» — это задача. «Сделай комментарии» — нет.
Хорошая первая задача — маленькая, но настоящая: поменять текст на кнопке и цвет, добавить поле в форму, починить конкретную ошибку из консоли. По ней видно, как агент ищет файлы, как спрашивает разрешения и как отчитывается. Большую фичу в первый день давать не стоит: вы ещё не знаете, где агент силён, а где его надо направлять.
Это нормально на старте. Разрешайте безопасные команды «навсегда» (тесты, сборка, просмотр файлов) — через день вопросов станет мало.
Не спорьте в чате — отмотайте назад (Esc Esc) и переформулируйте задачу с критерием готовности.
Попросите: «покажи, какие файлы ты поменял и зачем, простыми словами».
Нет времени разбираться самому? Доведём ваш проект на Claude Code до прода.
Довести до прода04 · Шпаргалка
Главные команды Claude Code

Хватит девяти команд: /init, /clear, /compact, /context, /model, /rewind, /resume, @файл и Shift+Tab для смены режима. Остальное можно попросить словами.
/initСоздать файл памяти проекта. Первое, что стоит сделать в новой папке.
/clearНачать разговор с чистого листа. Между несвязанными задачами — обязательно: экономит лимиты и не путает агента.
/compactСжать длинный разговор в краткое содержание и продолжить. Можно подсказать, что сохранить: /compact оставь решения по базе.
/contextПоказать, чем занята память агента: файлы, инструменты, история. Видно, что «съедает» лимит.
/modelВыбрать модель. Сильная — для сложных задач, быстрая — для простых правок.
/rewind или Esc EscОтмотать разговор и правки назад, если агент ушёл не туда.
/resumeВернуться к прошлой сессии со всей историей.
@файлУказать конкретный файл: агент сразу смотрит туда, а не ищет по всему проекту.
Переключить режим: обычный (спрашивает разрешения), автоприём правок, план.
Ещё одна полезная привычка: начинать строку с !, чтобы выполнить команду терминала самому, не выходя из Claude Code, — например, !git status. Агент увидит результат и учтёт его.
05 · Не из новостей
CLAUDE.md: файл, который делает агента умнее

CLAUDE.md — это инструкция для агента, которую он читает в начале каждой сессии. В ней должны быть команды запуска и проверки, где что лежит и правила. Мы ведём такой файл в каждом из десятков проектов — это экономит больше, чем любой промпт.
# Проект: … ## Как запустить - Установка: npm install - Запуск локально: npm run dev → http://localhost:3000 - Тесты: npm test ## Где что лежит - src/pages — страницы, src/api — сервер, .env — ключи (в git не попадает) ## Правила - Перед большой правкой — коммит. - После правки — запусти тесты и проверь страницу, потом говори «готово». - Ключи не вставлять в код. Базу продакшена не трогать. - Объясняй изменения простыми словами. ## Журнал 20.11 — подключили оплату, осталось письмо после покупки.
Главное здесь — команды запуска и проверки. Без них агент каждый раз заново выясняет, как собрать проект, и тратит на это лимит.
Свежие исследования поведения агентов показывают: до 70–80% токенов в каждой новой сессии уходит на то, чтобы заново изучить проект — найти, как он запускается и где что лежит. Хороший файл памяти отвечает на эти вопросы сразу, поэтому агент меньше бродит по файлам, а ваш лимит живёт дольше.
Как мы ведём такие файлы: короткие пункты, без воды; устаревшее исправляем, а не дописываем рядом; в конце каждой задачи агент сам дописывает, что сделано и что дальше. Через месяц это лучший документ по проекту — и для агента, и для человека.
Умеете так работать с агентами? Приходите в команду — дадим постоянные заказы.
Хочу в команду06 · Честно
Claude Code в России: что важно знать

Россия не входит в список стран, где Anthropic официально предоставляет свои сервисы, и российской картой подписку не оплатить. Серые схемы с чужими аккаунтами рискуют блокировкой и утечкой кода, поэтому мы их не советуем.
Запросов «claude code в России» и «купить подписку» в Яндексе тысячи, и продавцов «готовых аккаунтов» хватает. Что стоит понимать, прежде чем платить:
- Аккаунт могут заблокировать вместе с историей и настройками, а деньги никто не вернёт.
- Общий аккаунт — это общий доступ к вашему коду. Всё, что вы отправляете агенту, видит владелец аккаунта.
- Правила сервиса меняются. Сегодня схема работает, завтра — нет, и проект встанет посреди работы.
Законные варианты: российские ассистенты для кода (GigaCode от Сбера, SourceCraft Code Assistant от Яндекса) — особенно если код корпоративный; открытые модели, которые можно запустить у себя; или доверить разработку команде, у которой инструменты уже настроены. Подробно — в статье «Аналоги Claude Code».
07 · Грабли
Пять ошибок новичков в Claude Code

Чаще всего новички сразу отключают все подтверждения, неделями сидят в одной сессии, работают без git, дают расплывчатые задачи и принимают результат не проверяя.
- 01
Сразу разрешили всё
Чтобы агент не спрашивал, запускают его с флагом, отключающим подтверждения, прямо на рабочем компьютере.
Чем заканчивается. Агент может удалить файлы, перезаписать настройки или выполнить команду на сервере, которую вы не хотели.
Как правильноРазрешать конкретные безопасные команды (тесты, сборка, git status), а опасные оставлять с подтверждением. Полную свободу — только в изолированной среде. - 02
Одна бесконечная сессия
Неделю работают в одном окне: баг в оплате, потом дизайн, потом письма.
Чем заканчивается. Агент путается в старых договорённостях, лимиты тают в разы быстрее.
Как правильноОдна задача — одна сессия. Закончили —/clear, а важное записали в CLAUDE.md. - 03
Нет git
Правки идут прямо в папку без сохранённых версий.
Чем заканчивается. Одна неудачная просьба — и рабочая версия потеряна.
Как правильноgit initв первый же день и коммит перед каждой большой правкой. Агент сделает это сам, если попросить. - 04
Задача «сделай красиво»
Агенту дают расплывчатую задачу без критериев готовности.
Чем заканчивается. Он что-то меняет, вы не согласны, круг повторяется десять раз.
Как правильноОписать результат: что должно быть на экране, что происходит по кнопке, как проверить. И попросить сначала план. - 05
Принимают, не глядя
Агент сказал «готово», значит, готово.
Чем заканчивается. Через неделю выясняется, что форма не отправляет заявки, а «готово» было про то, что код написан.
Как правильноВ CLAUDE.md правило: после правки запустить, проверить и показать результат. И самому открыть страницу.
Общее у всех пяти ошибок одно: агенту дают свободу, но не дают рамок. Рамки — это файл памяти, git, разрешения и критерии готовности. С ними даже новичок получает от агента результат, за который раньше платили разработчику.
Ресурсы
Полезные ссылки
Официальные сайты и документация инструментов из статьи — сохраните, чтобы попробовать самим.
08 · Вопросы
Частые вопросы о Claude Code
Claude Code бесплатный?
Нет. Для работы нужна платная подписка Claude (Pro, Max, Team, Enterprise) или аккаунт для API с оплатой по токенам. Бесплатный тариф Claude.ai доступа не даёт.
Как установить Claude Code на Windows?
Откройте PowerShell и выполните команду irm https://claude.ai/install.ps1 | iex. Права администратора не нужны. Затем перезапустите терминал и наберите claude.
Чем Claude Code отличается от обычного Claude в чате?
Чат отвечает текстом, а Claude Code работает в папке проекта: сам читает и правит файлы, запускает команды и тесты, делает коммиты.
Нужно ли уметь программировать?
Чтобы начать — нет. Но понимание основ (git, база данных, ключи, сервер) сильно снижает число ошибок и расход лимитов.
Можно ли пользоваться Claude Code в VS Code?
Да, есть официальное расширение для VS Code и редакторов JetBrains, а также вкладка Code в настольном приложении Claude.
Работает ли Claude Code в России?
Официально Россия не поддерживается. Мы не советуем серые схемы с чужими аккаунтами — для корпоративного кода есть российские ассистенты.
Читать дальше
