claude code как использовать: что это за агент и с чего начать

claude code как использовать с нуля: открываешь терминал в папке проекта, пишешь claude и ставишь задачу обычным языком, а агент сам читает файлы, правит код и запускает команды. дальше результат решают три вещи: режим разрешений, файл CLAUDE.md с правилами проекта и привычка проверять каждую правку до коммита. ниже всё по порядку, сверено с официальной документацией anthropic на 14 октября 2026.

что такое claude code простыми словами

claude code (в поиске его часто пишут «клод код») — агент для программирования от anthropic. в документации он описан как инструмент, который читает кодовую базу, редактирует файлы, запускает команды и подключается к твоим инструментам разработки. главное отличие от чата: чат отвечает текстом, а агент сам открывает файлы, вносит изменения, работает с git и проверяет результат.

я делаю через claude code сайты, ботов и seo, а этот сайт arturr_city целиком собран ии в claude code: страницы, фото, бот. вайбкодинг на claude code выглядит так: ты описываешь, что нужно, агент пишет код, ты смотришь, проверяешь и направляешь. писать код руками не обязательно, но читать то, что он поменял, придётся.

где работает claude code

по документации у claude code несколько «поверхностей», и все они работают на одном движке: файлы CLAUDE.md, настройки и mcp-серверы проекта подхватываются везде одинаково.

новичку я бы советовал начинать с терминала или расширения в vs code: под них написан quickstart и большинство примеров в документации. если терминал ни разу не открывал, у anthropic есть отдельный terminal guide, с него и стоит начать.

первые шаги: как пользоваться claude code после установки

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

claude --version

дальше переходишь в папку проекта и запускаешь агента:

cd /path/to/your/project
claude

при первом запуске claude code попросит войти в аккаунт через браузер, потом вход сохраняется. над полем ввода видны версия, текущая модель и рабочая папка. запускай именно из папки проекта: агент работает с файлами там, где его открыли.

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

что делает этот проект?
какие технологии тут используются?
объясни структуру папок

потом маленькая правка, например «поменяй текст кнопки на главной на „оставить заявку“». агент найдёт нужный файл и покажет изменение, а если спросит разрешения — выбираешь yes. контекст вручную подкладывать не нужно: claude code сам читает файлы по мере надобности. если хочешь указать конкретный файл, пиши @ и путь к нему.

команды запуска, которые пригодятся с первого дня:

как ставить задачу, чтобы агент понял с первого раза

самая частая причина плохого результата — расплывчатая задача. в документации пример: вместо «почини баг» писать «почини баг входа, когда после неверного пароля пользователь видит белый экран». агент умеет угадывать намерение, но мысли не читает.

• указывай место. файл, страницу, функцию: «форма в contacts.html», а не «форма где-то на сайте».
• показывай образец. «сделай карточку так же, как карточки на главной» — агент повторит существующий стиль, а не придумает свой.
• говори, как проверить. «после правки запусти сборку и покажи вывод». без проверки агент останавливается, когда работа выглядит готовой, и проверять начинаешь ты.
• большое режь на шаги. сначала таблица в базе, потом api, потом страница — по шагу за раз.
• кидай скриншоты и ошибки. картинку можно вставить прямо в поле ввода, текст ошибки — целиком, без пересказа.

режимы и разрешения: кто нажимает «да»

режим разрешений решает, что агент делает сам, а на что спрашивает тебя. в терминале режимы переключаются клавишами Shift+Tab, в vs code — индикатором режима, в десктоп-приложении — переключателем. текущий режим виден в строке состояния под полем ввода.

важный момент, которого нет в старых гайдах: с версии 2.1.283 сессии в терминале и vs code по умолчанию стартуют в auto. агент больше не спрашивает разрешение на каждую правку, решения принимает классификатор, который блокирует действия за рамками задачи. сама anthropic предупреждает: auto сокращает число вопросов, но не гарантирует безопасность.

поэтому первые дни я советую manual или plan. из auto первое нажатие Shift+Tab переключает в manual, дальше по кругу идут accept edits, plan и снова auto. запустить сессию сразу в нужном режиме можно флагом:

claude --permission-mode plan

в режиме плана агент изучает код и показывает план. дальше три варианта: одобрить и продолжить в auto, одобрить и подтверждать каждую правку вручную или остаться в планировании и сказать, что поменять. по Ctrl+G план открывается в текстовом редакторе, его можно поправить руками до старта. чтобы заранее разрешить безопасные команды вроде запуска тестов, есть /permissions.

файл CLAUDE.md и память

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

CLAUDE.md — обычный markdown-файл с правилами, агент читает его в начале каждой сессии. быстрее всего создать его командой /init: агент изучит проект и запишет команды сборки, тестов и найденные соглашения. если файл уже есть, /init не перезапишет его, а предложит улучшения.

• ./CLAUDE.md или ./.claude/CLAUDE.md — правила проекта, их коммитят в git, чтобы они были у всей команды;
• ./CLAUDE.local.md — твои личные правила для этого проекта, файл добавляют в .gitignore;
• ~/.claude/CLAUDE.md — твои правила сразу для всех проектов.

что туда писать: команды, которые агент сам не угадает, стиль кода, если он отличается от привычного, правила веток и коммитов, грабли проекта. документация советует держать файл в пределах 200 строк и про каждую строку спрашивать: если её убрать, агент начнёт ошибаться? если нет — удаляй. в раздутом файле важные правила теряются. проверить, что файл подхватился, можно командой /context.

пример короткого файла для лендинга:

# проект
лендинг на html, css и js, без фреймворков.

# проверка
- после правок запускать сборку (npm run build) и показывать вывод

# правила
- тексты на сайте с маленькой буквы
- картинки только webp, лежат в /img
- не трогать папку /legal без прямой просьбы

автопамять включена по умолчанию: агент сам записывает заметки о твоих предпочтениях, исправлениях и решениях по проекту в папку ~/.claude/projects/<project>/memory/. в начало каждой сессии загружаются первые 200 строк или 25 кб её оглавления MEMORY.md. если сказать «запомни, что мы используем pnpm, а не npm», это уйдёт в автопамять, а просьба «добавь это в CLAUDE.md» — в файл правил. посмотреть заметки и выключить автопамять можно через /memory.

slash-команды, skills и mcp

внутри сессии управление идёт через команды со слэшем. набери /, и появится список доступных команд и skills, дальше можно фильтровать по буквам. новичку каждый день нужны вот эти:

skills

skill — это папка с файлом SKILL.md, где описан навык: инструкция, порядок действий, справка по проекту. личные skills лежат в ~/.claude/skills/<name>/SKILL.md, проектные — в .claude/skills/<name>/SKILL.md. агент подключает skill сам, когда тот подходит по смыслу, или ты вызываешь его как команду через слэш и имя. старые пользовательские команды из .claude/commands/ теперь работают так же, как skills. есть и встроенные, например /code-review и /batch.

в отличие от CLAUDE.md, skill не грузится в каждую сессию целиком, поэтому длинные процедуры, которые нужны иногда, лучше выносить туда.

mcp

mcp (model context protocol) — открытый стандарт, через который claude code подключается к внешним сервисам и данным: таск-трекерам, документам, базам, дизайну. сервер добавляется одной командой, например так подключается notion и смотрится список серверов:

claude mcp add --transport http notion https://mcp.notion.com/mcp
claude mcp list

внутри сессии /mcp показывает статус серверов и помогает авторизоваться. документация прямо предупреждает: подключай только серверы, которым доверяешь, а те, что тянут внешний контент, открывают дорогу prompt injection. на старте mcp не обязателен, сначала освой базовый цикл.

claude code как использовать каждый день: цикл «задача → план → правки → проверка → коммит»

в лучших практиках anthropic рабочий процесс разбит на четыре фазы: изучить, спланировать, реализовать, закоммитить. я выделяю проверку в отдельный шаг, потому что без неё агент сдаёт работу, которая только выглядит готовой. вот как это выглядит на примере правки формы заявки на лендинге.

1. задача и изучение. запускаю claude в папке сайта, жму Shift+Tab, пока в строке состояния не появится ⏸ plan mode on, и прошу разобраться без правок.
2. план. описываю, что хочу получить, и прошу план. если что-то не так, правлю его через Ctrl+G или пишу замечания.
3. правки. одобряю план. на незнакомом проекте выбираю ручное подтверждение каждой правки.
4. проверка. прошу запустить сборку или тесты и показать вывод, а сам смотрю /diff.
5. коммит. прошу закоммитить с понятным сообщением. агент сам делает stage, пишет сообщение, может создать ветку и пулл-реквест.

промпты для этого примера:

прочитай index.html и form.js. разберись, как отправляется форма заявки. ничего не меняй.

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

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

закоммить изменения с понятным сообщением

план нужен не всегда. правило из документации простое: если изменение можно описать одним предложением — опечатка, строка лога, переименование, — проси сразу. план окупается, когда правка задевает несколько файлов или ты не знаешь, как устроен код.

про откат. каждое твоё сообщение создаёт точку восстановления: двойной Esc или /rewind вернут код и разговор назад. но точки ловят только правки, которые агент сделал своими инструментами редактирования, изменения через команды терминала туда не попадают. это не замена git, поэтому коммить после каждого законченного шага.

ошибки новичков

• один разговор на всё подряд. начал с формы, спросил про домен, вернулся к форме — контекст забит лишним, агент путается. между несвязанными задачами делай /clear.
• поправлять по кругу. если одно и то же пришлось исправлять больше двух раз, контекст засорён неудачными попытками. лучше /clear и новый промпт, в котором учтено то, что ты понял.
• ждать до конца, когда агент ушёл не туда. Esc останавливает его посреди действия, контекст сохраняется, можно сразу поправить курс.
• раздутый CLAUDE.md. в длинном файле важные правила теряются. выкидывай всё, что агент и так делает правильно.
• верить на слово. код выглядит правдоподобно, а крайние случаи не обработаны. давай агенту способ проверки — тесты, сборку, скриншот — и проси показать доказательство: вывод команды, а не слово «готово».
• бесконечное исследование. «изучи проект» без рамок — и агент читает сотни файлов, съедая контекст. сужай область или проси отдать разведку субагентам.
• bypassPermissions на своём ноутбуке. по документации этот режим нужен только в изолированных контейнерах и виртуальных машинах.

вопросы

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

начать можно: задачи ставятся обычным языком, а для тех, кто не открывал терминал, у anthropic есть отдельный terminal guide. но читать дифф и проверять результат всё равно придётся, иначе не поймёшь, что агент сломал.

чем claude code отличается от обычного чата с claude?

чат отвечает текстом, а claude code работает с файлами проекта: читает их, правит, запускает команды, делает коммиты и пулл-реквесты.

можно ли работать с ним в vs code или cursor?

да, расширение claude code ставится и в vs code, и в cursor. для intellij idea, pycharm и других ide jetbrains есть плагин, ему нужен установленный cli.

агент сломал код, что делать?

двойной Esc или /rewind вернёт код и разговор к прошлой точке. если правки шли через команды терминала, откатывай через git, поэтому коммить почаще.

нужно ли всё время держать режим auto?

нет. auto удобен на длинных задачах, где ты доверяешь общему направлению, но для чувствительных операций документация не советует заменять им ручную проверку. на старте спокойнее manual или plan.

источники

• claude code overview — code.claude.com
• quickstart — code.claude.com
• choose a permission mode — code.claude.com
• how claude remembers your project — code.claude.com
• best practices for claude code — code.claude.com
• commands — code.claude.com
• skills — code.claude.com
• mcp — code.claude.com