Иллюстрация к гайду про Claude Code

Claude Code: что это и как пользоваться

Иван Юницкий · Обновлено

Claude Code это AI-агент от Anthropic, который работает в папке вашего проекта. Он читает файлы, правит код и тексты, запускает команды, смотрит на результат и исправляет ошибки сам. Ниже полный разбор. Что умеет Claude Code и кому он пригодится, сколько стоит подписка и как устроены лимиты, как поставить его на macOS, Windows и Linux, как ставить задачу, какие команды и горячие клавиши стоит запомнить, как работают CLAUDE.md, скиллы, MCP, субагенты и хуки и чем Claude Code отличается от Codex и Cursor.

Перед стартом

Дальше будет немного технических слов. Выглядит страшнее, чем оно есть. Этот гайд написан и для вас, и для вашего агента. Команды из него не нужно набирать руками. Когда Claude Code уже стоит, дайте ему ссылку на эту страницу и попросите настроить все по шагам. За вами остаются решения и проверка результата.

Что такое Claude Code

Claude Code это агент для программирования и работы с файлами от Anthropic, компании, которая делает модели Claude. Его запускают в папке проекта, и дальше он сам решает, какие файлы прочитать, что поменять и какую команду выполнить, чтобы задача была сделана. Внутри работают модели Claude, старшая Opus, средняя Sonnet и быстрая Haiku, переключаются они командой /model.

От чата на claude.ai агент отличается доступом к вашему компьютеру. В чате вы копируете код туда и обратно и сами проверяете, работает ли он. Claude Code видит весь проект, вносит правки прямо в файлы, запускает тесты или сборку, читает ошибку и чинит ее, пока результат не сойдется с задачей. Такой цикл называют агентным, агент собирает контекст, действует, проверяет и повторяет.

Anthropic показала Claude Code в феврале 2025 года как программу для терминала, в общий доступ он вышел в мае. Файл правил CLAUDE.md и большую часть рабочих практик придумал и описал Борис Черный, один из создателей инструмента. За полтора года Claude Code оброс приложением, веб-версией и расширениями для редакторов, и сейчас это одно имя для агента, который доступен в нескольких местах с общими настройками.

ГдеЧто этоКогда подходит
ТерминалПрограмма claude, запускается в папке проекта на macOS, Linux и WindowsПолный набор функций, скрипты и автоматизация
VS Code и CursorРасширение с панелью агента и диффом рядом с кодомПравки рядом с открытым файлом, чтение чужого проекта
JetBrainsПлагин для IntelliJ IDEA, PyCharm, WebStorm и других IDEДля тех, кто уже работает в этих редакторах
Приложение ClaudeВкладка Code в программе для macOS и WindowsРабота без терминала, выбор папки, панель изменений
Веб-версияАгент на claude.ai/code со своей копией репозитория GitHubДлинные задачи в фоне, несколько задач параллельно
ТелефонПриложение Claude для iOS и AndroidЗапустить задачу в облаке или подтолкнуть сессию на компьютере из дороги
Slack и GitHubУпоминание @Claude в чате и @claude в issue или pull requestКомандная работа и ревью

Новичку проще всего начать с приложения Claude для компьютера или с расширения в VS Code. Терминал пугает первые полчаса, зато в нем доступно все, о чем пойдет речь дальше. Как устроен такой интерфейс и почему его не надо бояться, разобрано в гайде как начать работать с AI-агентами.


Что можно сделать с Claude Code

Claude Code задумывали для разработчиков, но за год им начали пользоваться все, у кого работа живет в файлах. Слово код в названии сбивает с толку, потому что агенту одинаково понятны скрипт на Python, таблица Excel, папка с договорами и заметки в Markdown. На лекции кэмпа про вайбкодинг мы показываем список из сорока с лишним вещей, которые участники собирают словами, от лендинга и CRM до монтажа видео и трекера привычек.

  • Разработчикам рутина Рефакторинг, тесты, миграции, разбор чужого кода, ревью pull request и поиск бага по логу. Человек остается на постановке задачи и проверке.
  • Вайбкодерам проекты Сайты, телеграм-боты, админки, дашборды и мини-приложения, которые собираются из описания. Полный путь на примере бота есть в гайде как создать Telegram-бота.
  • Предпринимателям документы Договоры, счета и акты по шаблону, коммерческие предложения, отчеты из выгрузок и таблиц. Как это устроено у нас, описано в гайде про договоры, счета и акты с AI-агентом.
  • Для контента медиа Презентации, карусели, дайджесты и монтаж видео, где агент режет и склеивает ролики через ffmpeg.
  • Для себя знания Второй мозг из заметок в Markdown, личная база знаний, разбор почты и созвонов.

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


Сколько стоит Claude Code и как устроены лимиты

Claude Code входит в платную подписку Claude, на бесплатном тарифе он недоступен. Второй путь это ключ API из консоли Anthropic, тогда вы платите за потраченные токены. Цены ниже указаны на октябрь 2026 года.

ТарифЦена в месяцКому подходит
Free0Claude Code нет, только чат
Pro20 долларов, 17 при оплате за годПопробовать и работать с агентом пару часов в день
Max 5x100 долларовЕжедневная работа, лимит в пять раз больше Pro
Max 20x200 долларовАгент весь день и несколько сессий параллельно
Team25 долларов за место, 20 при оплате за годКоманды от двух человек, общий счет и администрирование
Enterpriseпо договоруКомпании с требованиями к безопасности и данным
Ключ APIоплата за токеныСкрипты, CI, свои сервисы поверх Claude Code

Лимит подписки считается в двух окнах, пятичасовом и недельном. Пятичасовое окно начинается с первого сообщения и сбрасывается через пять часов, недельное обновляется раз в неделю в фиксированное для вашего аккаунта время. Чат на claude.ai и Claude Code тратят один общий лимит, поэтому длинный разговор в браузере уменьшает остаток для агента. Сколько осталось и когда сброс, показывает команда /usage. Точного числа сообщений Anthropic не публикует, расход зависит от модели, объема контекста и длины задачи.

Когда лимит кончился, можно дождаться сброса, перейти на тариф выше или включить дополнительные кредиты, они списываются по ценам API. Opus расходует лимит заметно быстрее Sonnet, поэтому рутину выгодно отдавать Sonnet, а Opus включать для сложной отладки и планирования. Тарифы и лимиты Anthropic меняет по несколько раз в год, свежие изменения мы разбираем в канале Точки над ИИ.

При оплате через API, по данным Anthropic, активный день работы одного разработчика обходится в среднем около 13 долларов, а месяц в 150-250 долларов. У девяти из десяти пользователей день стоит меньше 30 долларов. Для регулярной работы подписка выходит дешевле, API удобен для автоматизации и разовых задач.

Совет

Перед большой задачей откройте /usage. Если остаток маленький, начните с чистой сессии через /clear. Длинная история съедает лимит быстрее всего, потому что с каждым запросом модель заново получает весь разговор.

Россия не входит в список стран, где Anthropic официально предоставляет сервис, и российские карты к оплате не принимаются. Как участники кэмпа оплачивают подписку, собрано в гайде как оплатить ChatGPT и Claude из России. Попробовать агентов без подписки можно на бесплатных альтернативах, их список есть в гайде как работать с AI-агентами бесплатно.


Как установить Claude Code

Anthropic рекомендует нативный установщик. Он ставит программу одной командой, права администратора ему не нужны, а дальше Claude Code обновляется сам в фоне. Нужен компьютер с macOS 13 или новее, Windows 10 версии 1809 или новее, Ubuntu 20.04, Debian 10 или их более свежие версии, 4 ГБ оперативной памяти и интернет.

СистемаКоманда
macOS, Linux, WSLcurl -fsSL https://claude.ai/install.sh | bash
Windows, PowerShellirm https://claude.ai/install.ps1 | iex
Windows, CMDcurl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
macOS, Homebrewbrew install --cask claude-code
Windows, WinGetwinget install Anthropic.ClaudeCode
Любая система, npmnpm install -g @anthropic-ai/claude-code

Через Homebrew и WinGet программа сама не обновляется, обновлять ее надо командой менеджера пакетов. Установка через npm осталась для совместимости и требует свежего Node.js. Документация отдельно просит не запускать ее через sudo, иначе потом начинаются проблемы с правами на папки. На Windows стоит заранее поставить Git for Windows. Без него Claude Code выполняет команды в PowerShell, и часть советов из интернета, написанных под Bash, не сработает.

Вход и проверка

  1. Откройте терминал в папке проекта и наберите claude.
  2. Войдите в аккаунт. При первом запуске откроется браузер. Подойдет аккаунт Claude с подпиской Pro, Max, Team или Enterprise либо аккаунт консоли Anthropic для оплаты по API.
  3. Проверьте установку. Если команда не находится или ведет себя странно, запустите claude doctor. Она проверит путь, версию и автообновление и подскажет, что поправить.
  4. Запомните служебные команды. Версию показывает claude --version, обновить вручную можно через claude update.

Первая просьба к агенту одна и та же. Прочитать проект и рассказать, что в нем, ничего не меняя. Следом команда /init, чтобы он записал это в CLAUDE.md и не читал проект заново в следующий раз.

Приложение и расширения

Если терминал пока не ваш, есть два пути без него. В приложении Claude для компьютера откройте вкладку Code и выберите папку проекта. В VS Code или Cursor поставьте расширение Claude Code из маркетплейса, панель агента появится сбоку, а правки будут видны как дифф прямо в редакторе. Для JetBrains есть плагин, ему нужна установленная программа claude из таблицы выше. Настройки, CLAUDE.md, скиллы и MCP у всех вариантов общие, поэтому переходить между ними можно в любой момент.

Осторожно

Перед первой задачей включите в папке git и сделайте коммит. Агент за один ход меняет десяток файлов, и без точки возврата разбирать, что он сломал, приходится вручную. Если слова git и коммит пока пугают, прочитайте гайд что такое GitHub, там они разобраны на примере сохранений в игре.


Как пользоваться Claude Code в первой сессии

Начните с той же просьбы, что в примере выше. Пусть агент прочитает проект и расскажет, как он устроен, ничего не меняя. Так вы увидите, как Claude Code рассуждает, а он соберет контекст для следующих шагов. Потом запустите /init, и агент создаст файл CLAUDE.md с описанием проекта. Третьей задачей возьмите одну маленькую правку, которую легко проверить глазами, например поменять текст кнопки или добавить проверку email в форму.

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

  • Ссылка на файл @ Знак @ и начало имени, например @src/form.js. Агент сразу читает нужный файл и не тратит время на поиск.
  • Команда терминала ! Строка с восклицательным знаком, например !npm test, выполняется напрямую, а ее вывод попадает в разговор. Удобно показать агенту ошибку.
  • Скриншот Ctrl+V Картинка из буфера вставляется прямо в запрос. Так проще всего показать, что съехало в верстке.
  • Остановка Esc Если агент пошел не туда, Esc останавливает его посреди хода. Можно дописать поправку, и он продолжит с ней.
  • Откат /rewind Возвращает файлы и разговор к контрольной точке перед любым из прошлых сообщений. Двойное нажатие Esc открывает тот же список. Действия во внешнем мире вроде отправленных запросов или удаленных командой файлов откат не возвращает, для них нужен git.

Задачу можно наговорить голосом, команда /voice включает диктовку. Для длинного контекста это быстрее клавиатуры, а как голосовой ввод становится основным способом общения с агентами, разобрано в гайде AI для личной эффективности.


Как ставить задачу Claude Code

Claude Code вытянет результат и из короткой просьбы. На важной задаче разница между хорошей и плохой постановкой это разница между одним ходом и вечером переделок. Хороший запрос отвечает на четыре вопроса.

ЧастьВопросПример
ЦельЧто поменять или собратьдобавь выгрузку заказов в CSV
КонтекстКакие файлы, примеры и ошибки важны@db/orders.py, формат как в @export_users.py
ОграниченияЧто трогать нельзя, какие правила соблюдатьбез новых библиотек, схему базы не менять
Готово, когдаКак проверить результаттесты проходят, файл открывается в Excel

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

Режим плана

Для задачи побольше включите режим плана. Shift+Tab переключает режимы по кругу, нужный подписан внизу как plan mode, или наберите /plan. В этом режиме Claude Code только читает файлы, задает уточняющие вопросы и пишет план. Файлы он не трогает, пока вы план не одобрите. Неверное допущение ловится здесь за минуту, а после реализации стоит правок в десяти файлах. Если идея есть, а описать ее трудно, попросите агента задать вам вопросы по одному и собрать из ответов техническое задание.

Проект начинается с PRD

Для проекта, который будет жить долго, сайта, бота или CRM, на лекции кэмпа мы начинаем с PRD, документа с описанием продукта. Его пишут вместе с агентом в режиме плана, и это самый долгий этап, что нормально. В PRD входят суть и цели, аудитория, весь функционал, дизайн и стек, а следом отдельный файл roadmap, где каждый этап это одна фича. Агент идет по этапам, после каждого прогоняет тесты, вы смотрите результат и делаете коммит. Новый этап удобно начинать в новой сессии, тогда контекст не забивается историей прошлых.

Уровень рассуждений

Команда /effort задает, сколько модель думает перед действием, от low до max. Низкий уровень подходит для понятных правок, высокий для отладки и архитектуры. Слово ultrathink в запросе включает максимальное усилие для одного ответа, Alt+T включает и выключает расширенное мышление. Высокий уровень тратит больше лимита и не восполняет того, чего агент не знает, поэтому сначала проверяйте формулировку и доступ к файлам.


Режимы разрешений и безопасность

Claude Code спрашивает разрешение перед действиями, которые что-то меняют. Насколько часто, задает режим разрешений. Текущий режим подписан под полем ввода, Shift+Tab переключает основные режимы по кругу.

РежимЧто делаетКогда включать
Manual (default)Спрашивает перед каждой правкой и командой, читает без вопросовПервые дни и незнакомый проект
acceptEditsПравит файлы без вопросов, команды по-прежнему с подтверждениемКогда вы доверяете правкам и смотрите дифф
planТолько чтение и планРазбор задачи до первой правки
autoДействия проверяет отдельная модель-классификатор, рискованное останавливаетсяДлинные задачи без присмотра
dontAskВсе, что не разрешено заранее, запрещеноСкрипты и CI
bypassPermissionsВыполняет все без вопросовТолько в изолированном контейнере или виртуальной машине

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

Секреты и ключи

Пароли, токены и ключи API никогда не лежат в коде. Локально их кладут в файл .env, который сразу добавляют в .gitignore, на сервере вписывают руками в переменные окружения в панели хостинга. Агент сам подскажет, куда положить секрет, но вводить его лучше самому. Флаг --dangerously-skip-permissions выключает все вопросы разом, и на рабочем компьютере с вашими файлами он рискованнее, чем кажется.


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

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

Что в нем стоит держать:

  • что это за проект и для кого;
  • стек и важные папки;
  • команды запуска, сборки и тестов;
  • соглашения по коду и текстам;
  • что трогать нельзя;
  • что значит готово и как это проверить.

Короткий и точный файл полезнее длинного с размытыми правилами. Anthropic советует держать его в пределах двухсот строк.

Сделали агенту замечание вручную, попросите его записать это правилом в CLAUDE.md, и в следующей сессии он ошибку не повторит. Через пару недель файл превращается в инструкцию по работе именно с вашим проектом, и качество заметно растет. Раздувать его не надо, раздутая память работает как такой же шум, как простыня кода.

Где лежат файлы правил

ФайлДля чего
~/.claude/CLAUDE.mdЛичные правила для всех проектов, например язык ответов и ваш стиль
./CLAUDE.mdПравила проекта, лежат в git и общие для команды
CLAUDE.local.mdВаши личные правила для этого проекта, в git не попадают
.claude/rules/*.mdПравила по темам, можно привязать к конкретным папкам

Внутри CLAUDE.md можно подключать другие файлы через @путь, например @docs/api.md. Если в проекте уже есть AGENTS.md от Codex, достаточно добавить в CLAUDE.md строку @AGENTS.md, и оба агента будут читать одни правила. Редактировать память из сессии удобно командой /memory.

Автопамять

Кроме CLAUDE.md, Claude Code ведет собственные заметки о проекте и о вас. Они лежат в папке ~/.claude/projects/ в подпапке проекта, в файле MEMORY.md и файлах по темам, и первые строки индекса попадают в каждую новую сессию. Туда агент записывает ваши поправки, договоренности и факты, которые сам узнал по ходу работы. Включается и выключается автопамять через /memory. Заглядывать туда раз в пару недель полезно, устаревшие заметки лучше удалять.


Контекст и как его беречь

Контекстное окно это рабочая память агента в одной сессии. В нее попадают ваши сообщения, прочитанные файлы, ответы и логи команд. Объем ограничен, и чем окно полнее, тем хуже модель держит детали. На лекции мы даем простую шкалу. До половины окна работать спокойно, от половины до 70% зона риска, а после 85% пора начинать новую сессию.

  • Посмотреть /context Сетка заполнения окна с разбивкой, сколько занимают файлы, история, MCP и правила, плюс советы, что убрать.
  • Сжать /compact Агент заменяет историю коротким резюме и продолжает в той же сессии. После команды можно написать, что сохранить обязательно.
  • Начать заново /clear Чистое окно для новой задачи, CLAUDE.md подгрузится снова. Это бесплатно и почти всегда лучше, чем тащить за собой прошлое обсуждение.
  • Спросить в сторону /btw Быстрый вопрос, который не попадает в историю и не засоряет окно основной задачи.
  • Вернуться /resume Список прошлых сессий, чтобы продолжить нужную. Из терминала то же самое делают claude -c и claude -r.

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

Сжатие с подсказкой сохраняет то, что нужно для следующего шага. Договоренности, которые нельзя потерять, лучше сразу записывать в CLAUDE.md, он переживает любой компакт.


Команды и горячие клавиши Claude Code

Слэш-команды набираются в поле ввода через /, после косой черты появляется список с подсказками. Ниже те, что пригождаются каждую неделю. Полный список показывает /help.

КомандаЧто делает
/initСоздает CLAUDE.md по содержимому папки
/planРежим плана без правок
/clearНовая сессия с чистым контекстом
/compactСжимает историю, можно указать, что сохранить
/contextПоказывает, чем занято окно
/rewindОткат файлов и разговора к контрольной точке
/resumeПродолжить одну из прошлых сессий
/modelСменить модель, Opus, Sonnet или Haiku
/effortУровень рассуждений от low до max
/usageОстаток лимита, время сброса и расход
/memoryОткрыть CLAUDE.md и автопамять
/permissionsПравила, что разрешено и что запрещено
/configНастройки, тема, уведомления
/skillsСписок скиллов
/agentsСубагенты и где лежат их файлы
/mcpПодключенные MCP-серверы и вход в них
/hooksНастроенные хуки
/pluginКаталог и установка плагинов
/diffЧто изменилось в файлах
/code-reviewРевью текущих изменений
/security-reviewПроверка изменений на уязвимости
/install-github-appПодключить Claude к репозиторию на GitHub
/loopПовторять задачу через интервал
/scheduleЗадачи по расписанию в облаке
/voiceГолосовой ввод
/doctorДиагностика установки
КлавишиЧто делает
EscОстановить агента посреди хода
Esc EscОчистить ввод или открыть откат
Shift+TabПереключить режим разрешений
Shift+EnterНовая строка в запросе, в некоторых терминалах после /terminal-setup
Ctrl+C, Ctrl+DПрервать ввод, выйти из сессии
Ctrl+RПоиск по истории запросов
Ctrl+OПодробный ход работы агента
Ctrl+BУвести задачу в фон
Ctrl+TСписок задач агента
Ctrl+GОткрыть запрос во внешнем редакторе
Ctrl+VВставить картинку
Alt+P, Alt+TСменить модель, включить мышление

На Mac вместо Alt нажимается Option. Из терминала Claude Code тоже запускается по-разному. Просто claude открывает диалог, claude "задача" стартует сразу с запросом, claude -p "запрос" выполняет запрос и выходит, claude -c продолжает последний разговор. Новые команды появляются почти каждые пару недель, а какие из них прижились у нас, мы показываем в канале Точки над ИИ.


Скиллы и плагины

Скилл это папка с инструкцией и при необходимости скриптами под одну конкретную задачу. Внутри лежит файл SKILL.md, где сверху короткое описание, когда скилл нужен, а ниже шаги. Пока скилл не нужен, в контексте лежит только описание, поэтому их можно держать десятки. Срабатывает скилл двумя способами. Вы зовете его командой /имя, или агент сам открывает его, когда задача подходит под описание. Скиллы это открытый стандарт Anthropic, тот же формат понимают Codex и другие агенты.

Описание отвечает на два вопроса, что делает скилл и когда он срабатывает. Тело умещается в четыре шага.

Личные скиллы лежат в ~/.claude/skills/ и доступны во всех проектах, скиллы проекта в .claude/skills/ и уезжают в git вместе с ним. Писать SKILL.md руками не обязательно. Опишите агенту процедуру, которую вы уже дважды ему объясняли, и попросите упаковать ее в скилл. Старые пользовательские команды из .claude/commands/ тоже продолжают работать, теперь это частный случай скилла. Среди встроенных есть /code-review, /simplify и /security-review.

Чтобы понять, где нужен скилл, на лекции мы даем простое правило. Если результат надо поддерживать, это проект со своей папкой. Если задача повторяется и закрывается одной командой, это скилл. Подробно о том, как скиллы устроены и что проверять перед установкой чужого, рассказывает гайд про скиллы для AI-агентов, а подборка проверенных скиллов собрана в гайде готовые скиллы для AI-агентов.

Плагины

Плагин это готовый пакет из скиллов, субагентов, хуков и MCP-серверов, который ставится одной командой. Команда /plugin открывает каталог, официальный маркетплейс Anthropic подключен по умолчанию, можно добавить и сторонние. Плагин ставится для себя, для проекта или только на этом компьютере. Внутри плагина лежит чужой код, поэтому правило то же, что со скиллами. Ставим из понятных источников, после установки проверяем, есть ли польза, лишнее удаляем.


MCP и подключение сервисов

MCP это открытый протокол, по которому агент работает с внешними сервисами, базами данных, таблицами, Notion, Figma, Supabase, GitHub и десятками других. Один раз подключили сервер, и агент пользуется им как набором своих инструментов. Например, сам читает макет в Figma или создает таблицы в базе Supabase. Что такое MCP на пальцах и какие серверы стоит поставить первыми, разобрано в гайде что такое MCP.

После добавления наберите /mcp внутри сессии. Там видно, какие серверы работают, и там же проходит вход в аккаунт сервиса.

У каждого сервера есть область. По умолчанию он виден только вам и только в этом проекте, с флагом --scope project записывается в файл .mcp.json и достается всей команде через git, с --scope user работает во всех ваших проектах. Каждый сервер занимает место в контексте описанием своих инструментов, поэтому правило с лекции такое. Подключили, проверили пользу, ненужное выключили. Посмотреть, сколько места забирает MCP, можно в /context.


Субагенты и параллельная работа

Субагент это помощник со своей ролью, своими инструментами и отдельным контекстным окном. Главный агент отдает ему часть работы, субагент читает десятки файлов у себя, а обратно возвращает короткое резюме. Окно главного агента остается чистым, и длинная задача не тонет в деталях.

Субагент работает в своем окне. Главному агенту достается только резюме, поэтому его контекст не забивается.

Встроенных субагентов три. Explore быстро ищет по проекту и ничего не меняет, Plan собирает информацию для режима плана, general-purpose берет сложные задачи со всеми инструментами. Свои субагенты лежат файлами в .claude/agents/ для проекта или в ~/.claude/agents/ для всех проектов. Это Markdown с именем, описанием, списком разрешенных инструментов и моделью. Проще всего попросить Claude Code создать такого субагента, например ревьюера, который проверяет каждый готовый этап на безопасность.

Задачу, которая идет долго, можно увести в фон через Ctrl+B и продолжить разговор. Две большие задачи в одной папке лучше не запускать, правки начинают биться друг о друга. Для этого есть git worktree, отдельная рабочая копия проекта на своей ветке, Claude Code создает ее флагом --worktree. В свежих версиях появился режим воркфлоу, где сценарий раздает задачу десяткам агентов и перепроверяет их результаты. Он нужен для больших аудитов и миграций, на старте хватает обычных субагентов.


Хуки

Хук это команда, которая запускается автоматически на событие в работе агента. Правило в CLAUDE.md модель может забыть или понять по-своему, хук срабатывает всегда. Поэтому через хуки делают то, что должно происходить без исключений. Форматировать каждый измененный файл, запрещать команды, которые трогают продакшен, присылать уведомление, когда агент закончил.

СобытиеКогда срабатываетПример
SessionStartНачало или возобновление сессииПодгрузить свежие задачи из трекера
UserPromptSubmitВы отправили запросДобавить к запросу текущую дату и ветку
PreToolUseПеред действием агентаЗапретить команду удаления или правку .env
PostToolUseПосле действияОтформатировать измененный файл, прогнать линтер
NotificationАгенту нужно ваше вниманиеЗвук или сообщение в Telegram
StopАгент закончил ответУведомление о готовности, проверка тестов
PreCompactПеред сжатием контекстаСохранить историю в файл
SessionEndКонец сессииЗаписать итоги в журнал проекта

Хуки описываются в файле настроек, личном ~/.claude/settings.json или проектном .claude/settings.json. Если команда хука завершается с кодом 2, действие блокируется, а текст ошибки уходит агенту, и он понимает, почему ему отказали. Посмотреть настроенные хуки можно командой /hooks. Сам JSON писать не обязательно, опишите агенту, что должно происходить, и попросите настроить хук.

С такого хука удобно начать на Mac. Когда агент закончил, раздается звук, и за терминалом можно не следить.


Claude Code без терминала и с телефона

Кроме терминала и редакторов, у Claude Code есть несколько способов работать там, где удобно в моменте.

  • Приложение для компьютера macOS, Windows Вкладка Code в приложении Claude. Папка проекта, панель изменений, встроенный браузер для проверки сайта и параллельные сессии в отдельных рабочих копиях.
  • Веб-версия claude.ai/code Агент работает в облаке Anthropic с копией вашего репозитория на GitHub и возвращает результат веткой или pull request. Удобно для длинных задач, пока компьютер выключен.
  • Телефон iOS, Android Запустить облачную задачу, посмотреть результат или через удаленное управление подтолкнуть сессию, которая идет на вашем компьютере.
  • Браузер Chrome расширение Агент открывает страницы, кликает, заполняет формы и читает ошибки в консоли. Пароли и оплату по-прежнему вводите сами.
  • Slack @Claude Задача из рабочего чата уходит агенту, ответ приходит в тот же тред.

Сессию можно перенести между поверхностями. Начать в терминале и продолжить в приложении, или запустить в вебе и забрать к себе на компьютер. Как устроена работа с репозиторием и pull request, которые здесь появляются, объясняет гайд про GitHub по ссылке выше.


Автоматизация, claude -p и GitHub Actions

Флаг -p запускает Claude Code без диалога. Агент выполняет запрос и выходит, а результат можно передать дальше в скрипт. Так его встраивают в cron, пайплайны и свои утилиты. Флаг --output-format json отдает ответ в машиночитаемом виде, --allowedTools заранее разрешает нужные инструменты, чтобы агент не ждал подтверждения.

Для GitHub есть готовая интеграция. Команда /install-github-app подключает приложение Claude к репозиторию и создает workflow для GitHub Actions. После этого упоминание @claude в issue или pull request запускает агента на серверах GitHub. Он может починить баг из issue, ответить на вопрос по коду или сделать ревью и отвечает комментарием или новым pull request. Для оплаты подойдет ключ API или токен подписки, который выдает команда claude setup-token.

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


Claude Code, Codex или Cursor

Три популярных агента для работы с кодом устроены по одной логике. Все работают с папкой проекта, читают файл правил и подключают MCP. Различаются они моделями внутри, подпиской и тем, где живут.

Claude CodeCodexCursor
Кто делаетAnthropicOpenAIAnysphere
МоделиClaude, семейства Opus, Sonnet, HaikuМодели GPTМодели разных провайдеров, включая Claude и GPT
Где работаетТерминал, VS Code, JetBrains, приложение, веб, телефонПриложение ChatGPT, терминал, редакторы, облако, GitHubОтдельный редактор на основе VS Code, веб и облачные агенты
Файл правилCLAUDE.mdAGENTS.mdПравила в .cursor/rules и AGENTS.md
ПодпискаClaude Pro, Max, TeamChatGPT Plus, Pro, бизнес-тарифыСвоя подписка Cursor
Сильная сторонаСкиллы, субагенты, хуки и плагины в одном местеВходит в подписку ChatGPT, развитое облакоРабота внутри редактора, автодополнение на лету

Выбирать удобнее всего по подписке, которая у вас уже есть. Если платите за Claude, начинайте с Claude Code, если за ChatGPT, с Codex. Cursor подходит тем, кто проводит день в редакторе и хочет переключать модели разных компаний, а расширение Claude Code ставится и в него. Навык переносится между агентами за вечер, CLAUDE.md подключает AGENTS.md одной строкой, и скиллы в формате SKILL.md понимают оба. Подробный разбор второго агента есть в гайде как пользоваться Codex, а сравнение сотни сервисов для вайбкодинга собрано в гайде инструменты для вайбкодинга.


Первая неделя с Claude Code

  1. Установка и папка. Поставить Claude Code, открыть папку любого текущего проекта, первой просьбой попросить разобраться в нем и ничего не менять.
  2. Git и CLAUDE.md. Включить git, сделать первый коммит, запустить /init и поправить заготовку руками.
  3. Задача из четырех частей. Одна реальная правка с целью, контекстом, ограничениями и критерием готовности. Посмотреть дифф и сделать коммит.
  4. Режим плана. Задача побольше через Shift+Tab, с вопросами агента до первой правки.
  5. Лимит и контекст. Открыть /usage и /context до и после дня работы, понять, сколько уходит на Sonnet и на Opus.
  6. Первый скилл. Процедура, которую вы уже дважды объясняли агенту, упакованная в SKILL.md.
  7. Первый MCP или хук. Подключить один сервис, которым пользуетесь каждый день, или поставить звук на окончание работы.

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


Частые ошибки

ОшибкаЧто происходитЧто делать
Размытая задачаАгент заполняет пробелы допущениями и делает что-то своеЗапрос из четырех частей, для проекта PRD
Слишком большой кусок за разКонтекст плывет, качество падает к серединеОдна фича на одну сессию, этапы по roadmap
Весь проект в контекстеМодель тонет в лишнем, лимит таетДавать через @ только нужные файлы
Один чат на весь проектРаздутая история, автокомпакт теряет договоренности/clear между задачами, важное в CLAUDE.md
Работа без gitНечего откатить, когда агент сломал соседний файлКоммит до и после каждой задачи
Правила в каждом запросеПовторяете одно и то же, агент между сессиями забываетПеренести в CLAUDE.md или скилл
Дизайн на откуп агентуОдинаковые шаблонные страницыРеференсы и дизайн-система в файле, как в гайде про дизайн с AI-агентом
Полный обход разрешений на стартеАгент делает необратимое на вашем компьютереManual или auto, ослаблять правилами /permissions
Opus на каждой мелочиЛимит Pro сгорает за пару часовРутина на Sonnet, Opus для сложного
Ключи в кодеТокен уезжает в репозиторий.env и .gitignore с первого дня

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

Что такое Claude Code простыми словами?
Это AI-агент от Anthropic, который работает в папке вашего проекта. Он сам читает файлы, вносит правки, запускает команды и проверяет результат. Пользоваться им можно в терминале, в VS Code и JetBrains, в приложении Claude для компьютера, в браузере и с телефона.
Claude Code бесплатный?
Нет. На бесплатном тарифе Claude он недоступен. Нужна подписка Pro за 20 долларов в месяц, Max, Team или Enterprise, либо ключ API с оплатой за потраченные токены.
Как использовать Claude Code, если я не программист?
Начните с приложения Claude для компьютера или расширения в VS Code, откройте папку и описывайте задачу обычными словами. Первой просьбой попросите агента рассказать, как устроен проект, второй создайте CLAUDE.md командой /init. Код пишет агент, за вами постановка задачи и проверка результата.
Чем Claude Code отличается от чата Claude?
Чат видит только то, что вы в него вставили, и ничего не запускает. Claude Code работает с файлами на вашем компьютере, сам вносит правки, запускает тесты и сборку и исправляет ошибки по их выводу. Лимит подписки у них общий.
Работает ли Claude Code на Windows?
Да. Он ставится одной командой в PowerShell или через WinGet, права администратора не нужны. Желательно поставить Git for Windows, тогда агент выполняет команды в Bash. Есть и приложение Claude для Windows с вкладкой Code.
Понимает ли Claude Code русский язык?
Да. Задачи можно писать и диктовать по-русски, CLAUDE.md тоже можно вести на русском. Имена файлов, команды и код агент оставляет как есть.
Работает ли Claude Code в России?
Россия не входит в список стран, где Anthropic официально предоставляет сервис, и российские карты к оплате не принимаются. Способы, которыми пользуются участники кэмпа, собраны в гайде как оплатить ChatGPT и Claude из России.
Что лучше, Claude Code или Codex?
Логика у них одинаковая. Оба работают в папке проекта, читают файл правил, понимают скиллы и MCP. Claude Code работает на моделях Anthropic и входит в подписку Claude, Codex на моделях OpenAI и входит в подписку ChatGPT. Выбирать удобно по подписке, которая у вас уже есть, навык переносится между ними за вечер.
Как не дать Claude Code сломать проект?
Держите проект в git и делайте коммит перед каждой крупной задачей. Сложную задачу начинайте с режима плана, первые дни работайте в режиме, где агент спрашивает разрешение. Неудачный ход откатывается командой /rewind, а полный обход разрешений включайте только в изолированном контейнере.
Что делать, если в Claude Code закончился лимит?
Команда /usage покажет, когда сбросится пятичасовое и недельное окно. Можно дождаться сброса, перейти на Max или включить дополнительные кредиты по ценам API. Чтобы лимит тратился медленнее, начинайте новые задачи с чистой сессии и отдавайте рутину модели Sonnet.

Что запомнить

  • Claude Code это агент Anthropic, который работает в папке проекта. Он читает и правит файлы, запускает команды и сам проверяет результат.
  • Доступ только по подписке Pro, Max, Team, Enterprise или по ключу API. Лимит общий с чатом и считается в пятичасовом и недельном окне, остаток в /usage.
  • Ставится одной командой нативного установщика на macOS, Linux и Windows. Без терминала есть приложение Claude и расширения для VS Code и JetBrains.
  • Хороший запрос состоит из цели, контекста, ограничений и критерия готовности. Для сложной задачи сначала режим плана, для проекта PRD и roadmap.
  • CLAUDE.md короткий и точный, растет из повторных замечаний. Важное в нем переживает сжатие контекста.
  • Контекст держите чистым. /clear между задачами, /compact с подсказкой, что сохранить, /context чтобы увидеть, чем занято окно.
  • Скилл для повторяющейся процедуры, MCP для внешних сервисов, субагент для отдельной роли, хук для того, что должно происходить всегда.
  • Git и коммит перед каждой задачей, секреты в .env, полный обход разрешений только в контейнере.
Обложка AI Playbook, бесплатный PDF на 73 страницы
PLAYBOOK :: PDF · 73 СТРАНИЦЫ · БЕСПЛАТНО

Вся практика кэмпа в одном PDF

AI Playbook: инструменты под задачи, оплата сервисов из России, вайб-кодинг, второй мозг и рабочие промпты. Забираете в один клик, без формы и почты.

Забрать в Telegram

Прочитать про агента легко, а рабочий процесс под свои задачи собирается быстрее рядом с теми, кто уже прошел этот путь. На программе Личная эффективность с AI мы разбираем Claude Code, контекст, скиллы и MCP на реальных задачах участников и доводим каждого до работающего проекта. Остальные программы кэмпа собраны на странице программ.

Claude Code обновляется почти каждую неделю, и привычки под новые функции приходится перестраивать. Что поменялось и что прижилось у нас, мы показываем в канале Точки над ИИ, а те, кто ведет свои проекты с агентом постоянно, собираются в клубе.

→ Узнать о кэмпе

Забрать Playbook →